IosDemo_zh - aopacloud/aopa-rtc GitHub Wiki

跑通 API 示例项目

奥帕在 GitHub 上提供了开源的 SDK 示例项目 AopaRtcIos，展示了各种基础和进阶的场景。本文以跑通视频通话示例项目为例，帮助你快速体验奥帕视频通话效果。

前提条件​

  • 可以访问互联网的计算机。请确保你的网络环境未部署防火墙，否则可能无法正常使用奥帕服务。
  • Xcode 13.0 或以上版本。
  • 已安装 Cocoapods。如尚未安装 Cocoapods，参考 Getting Started with CocoaPods 安装说明。
  • 两台 iOS 14.0 以上版本的设备
  • 一个有效的奥帕账号以及奥帕项目。请参考[开通服务]从奥帕控制台获得以下信息：
    • App ID：奥帕随机生成的字符串，用于识别你的项目。
    • App 证书（可选）：用于生成 Token 的字符串。如果你的项目启用了允许仅 App ID 加入，则不需要获取该字段。
  • Apple 开发者账号。

操作步骤​

获取示例项目​

你可以从如下两种方式中任选一种获取示例项目：

  • 前往[下载]页面，下载最新版的 iOS 视频 SDK，然后解压。

  • 前往奥帕在 GitHub 上提供的示例项目，然后运行以下命令将仓库克隆至本地。

    Shell

    git clone [email protected]:aopacloud/aopa-rtc.git

    信息

    奥帕在仓库中为 iOS 平台提供了视频示例项目，位于 /AopaRtcObjc/AppRtcObjc 路径下。

配置示例项目​

  1. 打开示例项目文件夹，在 /aopa-rtc/AppRtcObjc/NALoginController 文件中填写你从奥帕控制台获取到的 App ID 和 App 证书（如果项目启用了允许仅 App ID 加入，则 Certificate 字段留空）。

  2. 打开终端，使用 Xcode 打开项目文件夹下新生成的 AppRtcObjc.xcodeproj 文件。

编译并运行示例项目​

  1. 将 iOS 设备连接至电脑，在设备上打开 设备 > 隐私与安全性 > 安全性，打开开发者模式。

  2. 在 Xcode 界面顶部的 iOS Device 选项中勾选你的 iOS 设备。

    图片

  3. 在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing，然后在每一个 Target 下配置你的苹果开发者账号和 Bundle Identifier。

    bundle 设置

  4. 点击 开始图标 开始编译。

  5. 编译成功后，你的 iOS 设备上会出现 AppBBRtcIOS2 App 图标。

  6. （可选）如果设备上弹出不受信任的开发者提示，则首先点击取消关闭该提示，然后在 iOS设备上打开设置 > 通用 > VPN 与设备管理，在开发者 APP 中选择信任该开发者。

  7. 打开 API Example，选择一个你想要尝试的场景，然后输入频道名（如 test），并点击加入频道按钮。

    示例项目

  8. 为更好地体验各种音视频互动场景，你可以邀请一位朋友使用另一台设备运行该示例项目（需确保 samples/APIExample/APIExample/Common/KeyCenter.swift 中的 App ID 和 App 证书不变）。当你们输入相同的频道名加入频道后，即可在同一频道中体验各种互动场景。

    频道内互动