跑通示例源码

本文介绍如何快速跑通示例源码，体验基础的实时传译服务。

跑通示例源码

准备环境

在运行示例源码前，请确保开发环境满足以下要求：

• Xcode 14.0 或以上版本。
• iOS 11.0 或以上版本且支持音视频的 iOS 设备（仅支持使用真机）。
• iOS 设备已经连接到 Internet。

前提条件

• 已在 ZEGO 控制台 创建项目，并申请有效的 AppID 和 AppSign，详情请参考 控制台 - 项目管理 中的“项目信息”。
• 已联系 ZEGO 商务人员开通服务获取到实时传译的 License。

运行示例源码

1. 打开 AppStore ，搜索 Xcode 并下载安装。

   

2. 使用 Xcode 打开 ZegoVoiceTranslation.xcworkspace。

   1. 打开 Xcode，选择左上角的 File > Open...。
      
      
   2. 在解压后的示例源码文件夹中选择 ZegoVoiceTranslation/ZegoVoiceTranslation.xcworkspace，并单击Open。
      
      

3. 登录 Apple ID 账号。

   1. 打开 Xcode，选择左上角的 Xcode > Preference。
   2. 单击 Account 选项卡，单击左下角的 + 号，选择添加 Apple ID 后单击 Continue。
      
      
   3. 输入 Apple ID 和密码进行登录。
      
      

4. 修改开发者证书和 Bundle Identifier。

   1. 打开 Xcode，单击左侧的 ZegoVoiceTranslation 项目。
      
      
   2. 单击 Signing & Capabilities 选项卡，在 Team 中选择自己的开发者证书。
      
      

5. 修改 License 文件。在项目的根目录下找到命名为 license 的 txt 文件，将从 ZEGO 商务或者技术人员获取到的 License 内容复制到该文件，覆盖之前的内容。

   

6. 修改 KeyCenter.m 文件，填入 SDK 初始化所需的 AppID 和 AppSign 即可运行示例源码。

   请使用本文“前提条件”已获取的 AppID 和 AppSign 正确填写否则示例源码无法正常运行。

   

示例源码功能简介

示例源码运行成功后，即可看到 UI 界面，示例源码的 UI 主要分为三个界面：

• 房间列表界面
• 实时传译界面
• 文本翻译界面

1. 开发者在使用示例源码或者体验 App 时，首先进入房间列表界面，用户需要在此界面选择房间登录，单击选择的房间。

   

2. 在弹窗中，选择角色和用户名，角色可以选择，主播和观众，用户昵称可以自己修改也可以使用默认值，设置完成后，单击“进入房间”。

   角色说明：

   • 主播：可以推流，且可以开启语音识别推送出去，一个房间最多能进两个主播。

   • 观众：不能推流，能看到主播的视频以及开启语音识别后的识别结果和翻译结果。

   

3. 进入房间后，即可进入实时传译界面。如果角色选择的是主播，进入实时传译界面后，可以根据需要选择语音识别服务提供商和翻译服务提供商，还可以设置识别语音，以及要实时传译的目标语言。

   • 语音识别文本翻译开关：控制是否翻译语言识别的文本到目标语言，默认开启。

   • 文本翻译中间结果开关：控制语音识别的中间结果是否也要翻译，默认中间结果也会进行翻译，但会导致翻译的请求量增加，且计费也会随之增加。示例源码中默认会开启，但不建议开启。

   

4. 参数设置完成后，单击"开启实时语音识别", 即可启动实时传译，识别结果和翻译结果会在两个框中显示出来。
5. 切换到文本翻译的界面，可以在此界面进行纯文本的翻译，根据需要选择翻译提供商，源语言和目标语言，单击"开启文本翻译"即可。