跑通示例项目

  • iOS

更新时间

了解如何快速接入 1v1 私密房三方信令方案,完成环境准备、参数配置、示例运行和核心流程验证。

声网在 CallAPI 仓库中提供基于三方信令(环信)方案实现的 1v1 私密房和秀场转 1v1 的源代码供你参考。

本文介绍如何快速跑通该示例项目,体验直播效果。

前提条件

开始前,请确保满足如下前提条件:

克隆仓库

运行以下命令克隆仓库到本地:

Shell
git clone git@github.com:AgoraIO-Community/CallAPI.git

配置示例项目

按照如下步骤进行配置:

  1. 运行项目前,你需要在 /CallAPI/iOS/Example/CallAPI/KeyCenter.swift 文件中设置如下参数:

    Swift
    static let AppId: String = <#Your AppId#>
    static let Certificate: String? = <#Your Certificate#>
    
    static var IMAppKey: String = <#Your EaseMob AppKey#>

    填入你在开通一对一直播服务时获取的声网项目的 App ID、App 证书和环信项目的 App Key:

    参数描述获取方式
    AppId声网项目的 App ID获取 App ID
    Certificate声网项目的 App 证书获取 App 证书
    IMAppKey环信项目的 App Key获取 App Key
    表格内容超出当前宽度,可横向滚动查看更多列。
  2. 在 /CallAPI/iOS/Example 目录下运行 pod install,然后等待依赖库安装完成。

编译并运行示例项目

按照如下步骤进行操作:

注意

声网自定义信令方案的 1v1 私密房和秀场转 1v1 示例项目基于 CallAPI 和三方信令服务共同开发。运行前请确保你的项目已开通三方信令服务权限。

  1. 连接上 iOS 设备后,点击 CallAPI.xcworkspace 文件以通过 Xcode 打开项目,并在 iOS Device 选项中勾选上你的 iOS 设备。

  2. 在项目 TARGETS 下的 Signing & Capabilities 界面勾选 Automatically manage signing,配置你的苹果开发者账号和 Bundle Identifier。Bundle ID 用于在设备上唯一标识应用程序。在开发应用时,你需要设置 Bundle ID。在此处设置的 Bundle ID 需要与你的项目签名配置保持一致。

  3. 点击 开始运行 开始编译。

    信息

    如果之前运行过该项目,Xcode 可能在编译时会报 AUIMoreDialog has different definitions ... 的错。你可以使用 cmd + shift + K 清理后再尝试编译。

  4. 编译成功后,你的 iOS 设备上会出现 CallAPI 应用。在 iOS 系统设置中将该应用设为信任开发者后你才能打开应用。

  5. 打开应用,点击 1v1 私密房或秀场转 1v1 私密房,即可进行体验。主播可以创建房间;观众可以加入房间。

    注意

    你需要在两个客户端都打开应用,且都选择 1v1 私密房或秀场直播转 1v1 私密房才能进行互动体验。

常见问题

签名报错

使用 Xcode 14 编译失败,遇到 Signing for "SenseLib-SenseLib" requires a development team 的签名报错,如下面截图所示:

解决方案

你可以通过在 Terminal 中执行如下命令将 CocoaPods 升级到 1.12.0 以上解决报错。

Shell
sudo gem install -n /usr/local/bin cocoapods

备选解决方案

如果遇到 CocoaPods 升级失败,你还可以通过手动给第三方库签名来解决报错。将 Signing > Team 设置为你的开发团队即可。