帮你快速理解、总结文档立即下载

iOS

最近更新时间:2026-11-17 17:23:32
本文档已由 AI 辅助审校
我的收藏
本文档主要介绍如何快速跑通 TUIRoomKit 视频会议 Demo,体验高质量多人视频会议。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的多人视频会议功能。
房间准备页
房间主页
成员管理











前提条件

开通服务

请参考 开通服务 创建一个 Room 应用,并获取以下信息:
SDKAPPID:App 在控制台获取的 Room 应用的 ID,为应用的唯一标识。
SECRETKEY:应用的密钥。

环境准备

在开始之前,请确保您已满足下列要求:
Xcode 16 或更高版本(Swift 包清单使用 Swift Tools 6.0),测试设备需 iOS 15.0 或更高版本。
Swift Package Manager 为 Xcode 内置,无需安装 CocoaPods;首次解析依赖需能访问 GitHub 和 SDK 下载地址。
已在 Xcode 中登录 Apple ID。如果没有 Apple 开发者账号,可以使用免费的 Apple ID 进行开发测试。

获取 Demo

1. 获取源码:
克隆项目到本地
下载 Demo 并解压
git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
下载 GitHub 源码 并解压。
注意:
请保留完整仓库目录。工程通过本地 Swift 包引用同级的 room/ 和 live/,不能只下载或移动 application/。
2. 用 Xcode 打开 application/App-UIKit.xcodeproj。克隆方式也可执行:
open TUIKit_iOS/application/App-UIKit.xcodeproj
3. 等待 Xcode 自动解析 Swift 包依赖。若未自动开始,选择 File > Packages > Resolve Package Versions;若提示 failed to fetch,按下文常见问题排查。
工程已配置依赖,无需手动添加 RoomKit_SwiftPM,也无需执行 pod install 或打开独立的 .xcworkspace 文件。

配置 Demo

1. 配置 SDKAPPID 和 SECRETKEY:在 application/Debug/GenerateTestUserSig.swift 中填写应用的 SDKAPPID 和 SECRETKEY。Demo 会根据登录时输入的 UserID 生成测试 UserSig,无需另外填写 UserSig;不要将这两个字段与文件中的 DEBUG_SDKAPPID、DEBUG_SECRETKEY 混淆。

注意:
本文的 Demo 示例中通过在客户端代码中配置 SECRETKEY 进行鉴权,但 SECRETKEY 很容易被反编译逆向破解,一旦密钥泄露,攻击者就可以盗用您的腾讯云流量,因此该方法仅适合本地跑通 Demo 和功能调试。
在正式的生产环境中,建议在您的服务端生成 UserSig,在需要 UserSig 时由您的 App 向业务服务器发起请求获取动态 UserSig 来进行鉴权。详见 服务端生成 UserSig。
2. 配置苹果开发者签名:在 App Target 及屏幕共享扩展的 Signing & Capabilities 中勾选 Automatically manage signing,选择您的 Team,并配置唯一的 Bundle Identifier。扩展的 Bundle Identifier 应以 App 的 Bundle Identifier 为前缀:


编译并运行 Demo

多人会议场景通常会使用到摄像头、麦克风设备,因此建议您使用真机调试和运行 Demo。
1. 将 iOS 设备连接至电脑并信任开发电脑。iOS 16 或更高版本需在 设置 > 隐私与安全性 > 开发者模式 中开启开发者模式。
2. 在 Xcode 顶部选择 App-UIKit Scheme,并选择连接的测试设备。
3. 点击运行按钮将 App 部署到您的目标设备上。
提示:
为了体验完整的会议房间流程,建议您将 Demo 分别在两台设备上运行并登录两个不同的用户(例如,一台设备作为房主,一台设备作为参会者)。


登录和注册

Demo 启动后,请输入登录的用户 ID 。如果您当前的 ID 未曾注册过,会进入到注册界面,您可以在该界面为自己设置昵称。
登录页
注册页






提示:
请避免将 UserID 设置为“1”、“123”、“111”等简单字符串,以免多人协作时被他人占用导致登录失败。调试时建议设置具有辨识度的 UserID。

房间功能

登录后在主页进入会议功能,选择快速会议创建房间;另一台设备使用不同 UserID 登录,选择加入会议并输入相同房间号。
功能入口
标准房间主页
成员管理面板









注意:
如果想用不同手机体验音视频互通场景,请确保在 TUIKit_iOS/application/Debug/GenerateTestUserSig.swift 文件中填写的 SDKAPPID 是一致的。

常见问题

Resolve 时提示 failed to fetch 怎么办?

failed to fetch 表示依赖获取失败,请查看它后面的仓库地址和具体错误,按以下顺序排查:
1.1 偶发失败先重试:选择 File > Packages > Resolve Package Versions。
1.2 检查失败仓库:在终端执行以下命令,将示例 URL 换成报错中的仓库地址:
git ls-remote https://github.com/Tencent-RTC/AtomicXCore_SwiftPM.git
超时、连接断开或无法解析域名:检查网络或切换网络;使用代理时,确保终端和 Xcode 都能访问 GitHub,只有浏览器能打开网页并不足够。
Repository not found 或认证失败:检查地址和访问权限;本 Demo 的公开依赖无需额外填写 GitHub Token。
1.3 仓库可访问但 Xcode 仍失败:执行 File > Packages > Reset Package Caches,再执行 Resolve Package Versions;必要时关闭并重新打开 Xcode。清缓存会重新下载依赖,不要在网络不通时反复清理。
1.4 使用系统 Git 重新解析:若终端能访问仓库,但 Xcode 仍获取失败,在 TUIKit_iOS 仓库根目录执行以下命令。本次解析改用系统 Git 获取依赖:
xcodebuild -resolvePackageDependencies \\
-project application/App-UIKit.xcodeproj \\
-scheme App-UIKit \\
-scmProvider system
1.5 验证恢复结果:命令成功结束后,重新打开 application/App-UIKit.xcodeproj,等待依赖解析完成,选择 App-UIKit Scheme 并按 Command + B 编译。依赖不再报错且编译通过后,继续本文的真机运行步骤。若 Xcode 仍提示获取失败,不代表已经恢复,请按下文联系技术支持。
若错误发生在二进制 SDK 下载阶段,请检查日志中的实际下载 URL,而不只是 GitHub。若提示找不到本地包,确认使用并保留 application/、room/、live/ 的原有目录结构;requires Swift tools version 6.0 则需 Xcode 16 或更高版本。
仍无法恢复时,请通过 腾讯云售后支持 联系技术支持,说明是 TUIKit_iOS 的 Demo,并附上:
Xcode、macOS 版本,以及失败仓库或 SDK 下载 URL。
上述命令的完整错误输出,以及已尝试的排查步骤。
提交前请移除日志中的 Token、密钥及其他敏感信息;不需要提供 SECRETKEY 或 UserSig。

运行 Demo 提示签名错误或登录失败?

签名错误:检查 App 和屏幕共享扩展的 Team、Bundle Identifier 及设备授权。
登录失败:检查 application/Debug/GenerateTestUserSig.swift 中的 SDKAPPID 和 SECRETKEY 是否来自同一个已 开通服务 的应用,并确认 UserID 与生成的 UserSig 对应。

只需要会议功能,是否要删除其他模块?

跑通 Demo 时无需删改其他模块,登录后进入会议入口即可。正式接入自己的 App 时,请参考《集成视频会议》文档添加 TUIRoomKit,无需复制整个 Demo。

联系我们

售前咨询

当需要购买咨询时,可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,提供专业的上云方案。同时也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 - 18:00)。

售后支持

当遇到问题需要处理时,可以直接通过 售后支持 进行提问,腾讯云工程师7 × 24小时在线为您提供服务。同时也可以直接致电客服人员,寻求相应的帮助,客服咨询:4009100100(7 × 24小时)。