本文档主要介绍如何快速跑通 TUIRoomKit 视频会议 Demo,体验高质量多人视频会议。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的多人视频会议功能。
房间准备页 | 房间主页 | 成员管理 |
![]() | ![]() | ![]() |
前提条件
开通服务
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. 获取源码:
git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
注意:
请保留完整仓库目录。工程通过本地 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)。







