跑通 Demo

本文将为您介绍如何快速跑通音视频通话 Demo。跟随本文档,您可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的音视频通话功能。


前提条件

环境准备

Xcode 13 及以上。
两台 iOS 13.0 及以上设备。
CocoaPods 1.7.5 及以上版本。如尚未安装,请参考 CocoaPods Guides - Getting Started 进行安装

开通服务

请参见 开通服务 为 Demo 开通音视频服务。开通服务后,请记录SDKAppIDSDKSecretKey,在后续的步骤(配置并运行 Demo)中会用到。


下载 Demo

1. 从 GitHub 下载 TUICallKit Demo 源码,或者直接在命令行运行以下命令:
2. 在命令行中进入 iOS 项目目录:
// 先 cd 进入您下载的项目目录,再 cd 进入 iOS 项目目录
cd TUICallKit/iOS/Example
3. 加载依赖库:
pod install

跑通Demo

通过 Xcode 运行程序,将 Demo 在两台设备上运行,使用两个用户 ID 登录,一方作为主叫,一方作为被叫,完成一次音视频通话体验。

步骤1: 配置并运行 Demo

1. 填写 SDKAppID 和 SecretKey:打开/iOS/Example/Debug/GenerateTestUserSig.swift文件,将 开通服务 时获取到的对应的 SDKAppIDSDKSecretKey填入其中:



2. 选择设备:在 Xcode 如下图所示处选择您要将 Demo 运行到的设备:



3. 编译运行:选择完成后点击运行将我们的 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 提示签名错误或登录失败?

请检查您在 /iOS/Example/Debug/GenerateTestUserSig.swift 文件中填写的 SDKAppIDSDKSecretKey 是否正确,确保它们是您在腾讯云控制台应用管理页面获取到的密钥。

拨打电话过程中出现需要购买套餐包的提示?

错误提示
解决方法
您当前未购买音视频通话能力套餐,请前往 IM 控制台开通免费体验或加购正式版。
您当前未购买音视频通话能力套餐,请前往控制台 开通免费体验加购正式版
您当前购买的音视频通话能力套餐不支持该功能,建议您升级套餐类型。
您当前购买的音视频通话能力套餐不支持该功能,建议您前往控制台 升级套餐类型
提示:
如遇到其他错误提示,可查询 TUICallDefine 错误码 获取解决方案。

交流与反馈

如果有任何需要或者反馈,您可以联系:info_rtc@tencent.com。