You need to enable JavaScript to run this app.
导航

iOS (Objective-C)

最近更新时间2023.12.13 16:13:02

首次发布时间2021.09.23 13:17:48

快速开始 Demo 是 RTC 提供的基本音视频通话功能的开源示例工程文件。获取该工程文件后,你可以快速构建应用,感受 RTC 的通话效果;也能通过阅读代码,了解基本音视频通话的最佳实践。

应用使用说明

使用该工程文件构建应用后,即可使用构建的应用进行音视频通话。

你和你的同事必须加入同一个房间,才能进行音视频通话。

前提条件
  • Xcode 14.1+

  • iOS 11.0+ 设备

推荐使用真机进行测试,使用模拟器可能有部分功能无法正常体验

操作步骤

步骤 1:配置 Demo 工程文件

  1. 使用 Xcode 打开 QuickStart_Demo 文件夹中的 quickstart.xcodeproj 工程文件
  2. 选择 Constants 文件并在引号间填写你在控制台上获取到的 AppIDToken

参看获取 AppId获取临时 Token了解详细获取方法。

image

步骤 2:配置开发者证书

  1. 登录 Apple ID。
  • 选择 Xcode 页面左上角 Xcode > Preferences,或通过快捷键 Command + , 打开 Preferences。
  • 选择 Accounts,点击左下部 +,选择 Apple ID 进行账号登录。
    image.png
  1. 配置开发者证书。
  • 单击 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
    image

步骤 3:编译运行

  1. 连接并选择你的 iOS 设备
  2. 选择 Product > Run,或通过快捷键 Command + R 运行。
    image
  3. 在 iOS 设备上完成信任开发者设置,具体操作见视频演示。
  4. 在 iOS 设备上打开 Demo 应用时,在弹窗中选择开启摄像头和麦克风权限。
  5. 首次运行过程中可能需要在弹窗中输入电脑开机密码:
    image

运行开始界面如下:
image

视频演示
常见问题
  1. 快速开始 Demo 跑通后,两个测试设备距离较近会产生啸叫。
    通信两端的设备在同一房间内,且处于公放状态,连环增益大于 1 时会产生近场啸叫,与 demo 本身无关。请将各测试设备保持一定距离。

  2. Demo 运行后,出现错误弹窗。
    SDK 内部遇到不可恢复的错误。错误码详情,请参看:错误码