快速开始 Demo 是 RTC 提供的基本音视频通话功能的开源示例工程文件。获取该工程文件后,你可以快速构建应用,感受 RTC 的通话效果;也能通过阅读代码,了解基本音视频通话的最佳实践。
应用使用说明
使用该工程文件构建应用后,即可使用构建的应用进行音视频通话。
你和你的同事必须加入同一个房间,才能进行音视频通话。
前置条件
推荐使用真机进行测试,使用模拟器可能有部分功能无法正常体验
操作步骤
步骤 1:配置 Demo 工程文件
- 使用 Xcode 打开 QuickStart_Demo 文件夹中的
quickstart.xcodeproj 工程文件 - 选择 Constants 文件并在引号间填写你在控制台上获取到的 AppID 和 Token。
参看获取 AppId和获取临时 Token了解详细获取方法。

步骤 2:配置开发者证书
- 登录 Apple ID。
- 选择 Xcode 页面左上角 Xcode > Preferences,或通过快捷键 Command + , 打开 Preferences。
- 选择 Accounts,点击左下部 +,选择 Apple ID 进行账号登录。

- 配置开发者证书。
- 单击 Xcode 左侧导航栏中的 quickstart 项目,选择 Signing & Capabilities > Automatically manage signing 自动生成证书,也可以通过 https://developer.apple.com/ 手动配置,下载证书。
- 在 Team 中选择 Personal Team。
- Bundle Identifier 默认的
com.ss.rtc.demo.quickstart.dev 已被注册, 将其修改为其他 Bundle ID,格式为 com.xxx。

步骤 3:编译运行
- 连接并选择你的 iOS 设备
- 选择 Product > Run,或通过快捷键 Command + R 运行。

- 在 iOS 设备上完成信任开发者设置,具体操作见视频演示。
- 在 iOS 设备上打开 Demo 应用时,在弹窗中选择开启摄像头和麦克风权限。
- 首次运行过程中可能需要在弹窗中输入电脑开机密码:

运行开始界面如下:

视频演示

常见问题
快速开始 Demo 跑通后,两个测试设备距离较近会产生啸叫。
通信两端的设备在同一房间内,且处于公放状态,连环增益大于 1 时会产生近场啸叫,与 demo 本身无关。请将各测试设备保持一定距离。
Demo 运行后,出现错误弹窗。
SDK 内部遇到不可恢复的错误。错误码详情,请参看:错误码。