一、环境准备
·Xcode 13 及以上。
·两台 iOS 14.0 及以上设备。
二、开通服务
请参见 开通服务 为 Demo 开通音视频服务。开通服务后,请记录 SDKAppID 和SDKSecretKey,在后续的步骤(配置 Demo)中会用到。
三、下载 Demo
1. 从 GitHub 下载 TUICallKit Demo 源码,或者直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
2. 在命令行中进入 iOS 项目目录:
cd TUIKit_iOS/application
3. 加载依赖库:
pod install
注意:如果你尚未安装 CocoaPods ,可以参考 此处 了解如何安装。
四、跑通 Demo
通过 Xcode 运行程序,将 Demo 分别在两台设备上使用两个用户 ID 登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。
五、步骤1:配置并运行 Demo
1. 安装完成后,使用App-UIKit.xcworkspace 文件打开项目
2. 填写 SDKAPPID 和 SECRETKEY:打开/application/Debug/GenerateTestUserSig.swift文件,将 开通服务 时获取到的对应的 SDKAppID 和 SDKSecretKey 填入其中:
3. 选择设备:在 Xcode 如下所示处选择你要将 Demo 运行到的设备:
4. 编译运行:选择完成后点击运行将我们的 TUICallKit iOS Demo 运行到目标设备上。
六、步骤2:登录和注册
Demo 启动后,请你在用户ID 处输入 ID 。如果你当前的 UserID 未曾注册过,会进入到注册界面,你可以在该界面为自己设置昵称。
| 登录用户:Charlie | | 登录用户:Jane | |
| | | | |
注意:提示:
注意:建议你尽量避免将你的 UserID 设置成“1”、“123”、“111”等简单字符串,在多人协作开发时,形如 “1”、“123”、“111” 这样的 UserID 很容易被你的同事占用,导致登录失败,因此我们建议你在调试的时候设置辨识度高的 UserID。
七、步骤3:拨打电话
1. 主叫方请点击界面上的 1V1 通话,在弹出的界面中输入被叫方的 UserID 并选择你想要的通话类型。
2. 单击发起通话
| 点击"通话" | Charlie 呼叫 Jane | Jane 收到来电 | Jane 点击"接听"后双方开始通话 |
| | | | |
注意:提示:
注意:发起通话需确认:被呼叫用户 ID 是已登录的有效 ID。
八、运行 Demo 提示签名错误或登录失败?
请检查你在 /application/Debug/GenerateTestUserSig.swift 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是你在 开通服务 时获取到的密钥。
九、拨打电话过程中出现需要购买套餐包的提示?
| 错误提示 | 解决方法 |
| 你当前未购买音视频通话能力套餐,请前往 IM 控制台开通免费体验或加购正式版。 | 你当前未购买音视频通话能力套餐,请前往 IM 控制台 开通免费体验 或 加购正式版。 |
| 你当前购买的音视频通话能力套餐不支持该功能,建议你升级套餐类型。 | 你当前购买的音视频通话能力套餐不支持该功能,建议你前往 IM 控制台 升级套餐类型。 |
注意:提示:
注意:如遇到其他错误提示,可查询 TUICallDefine 错误码 获取解决方案。若未找到解决方案,欢迎随时 联系我们,我们将第一时间为你排查解决。
十、交流与反馈
如果你在使用过程中,有什么建议或者意见,可以 联系我们,感谢你的反馈。