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

iOS (Swift)

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

首次发布时间2023.07.03 22:28:31

快速开始 Demo 是 RTC 提供的基本音视频通话功能的开源示例工程文件。获取该工程文件后,你可以快速构建应用,感受 RTC 的通话效果;也能通过阅读代码,了解基本音视频通话的最佳实践。
RTC 提供了 iOS 平台上的 SDK。虽然接口以 Objective-C 的形式给出,但你也可以方便的在 Swift 项目中接入 SDK,实现实时音视频功能。

前提条件

  • 已安装 Xcode 13.0+,和 Cocoapods。
  • 已有 iOS 12.0+ 的真机设备,并获取有效的 AppleID。

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

操作步骤

步骤 1:配置 Demo 工程文件

  1. QuickStartSwift_Demo 工程的根目录下,执行 pod install 命令,生成 QuickStartSwift.xcworkspace,并使用 XCode 打开。
  2. QuickStartSwift.Constants 文件中,填写你在注册 RTC 服务时,获取到的 AppID 和临时 Token。参看开通服务

步骤 2:配置开发者证书

  1. 在 Xcode 上,登录 Apple ID。

  2. 配置开发者证书。

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

步骤 3:编译运行

  1. 连接并选择你的 iOS 设备。

  2. 编译运行。选择 Product > Run,或通过快捷键 Command + R

  3. 在 iOS 设备上完成信任开发者设置。

  4. 在 iOS 设备上打开 Demo 应用时,在弹窗中选择开启摄像头和麦克风权限。

运行开始界面如下:

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

常见问题

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

  2. Demo 运行后,出现错误弹窗,请参考相应文档:错误码