iOS

最近更新时间:2026-05-06 20:41:44

我的收藏
本文档主要介绍如何快速跑通 TUIRoomKit 研讨会场景 Demo,体验创建研讨会房间、音视频推流、屏幕共享、成员管理及超大规模消息互动在内的核心功能。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的研讨会房间功能。
标准会议与研讨会有何不同?
标准会议(Conference):适用于中小规模的多人协作场景,所有参与者均具有平等的音视频权限,提供屏幕共享、成员管理等完整互动能力。
研讨会(Webinar):专为大型直播演讲设计,支持无上限观众进房观看。观众可举手申请上台成为嘉宾后参与讨论,且系统针对万人级互动场景优化了消息并发性能,满足更专业的演讲互动需求。

功能展示

主持人
嘉宾
观众
支持主持人发起高清音视频推流与屏幕共享,支持对成员进行管理。
支持嘉宾开启麦克风进行实时语音讨论和分享。
支持观众无上限并发进房,以超低延迟观看实况并参与高频消息互动。支持观众通过“举手”功能向主持人申请变更为嘉宾。




前提条件

开通服务
请参考 开通服务 领取 TUILiveKit 体验版或开通 TUILiveKit 正式版,并在 应用管理 页面获取以下信息:
SDKAppID:应用标识,腾讯云基于 SDKAppID 完成计费统计。
SDKSecretKey:应用密钥,用于初始化配置文件的密钥信息。
注意:
研讨会场景基于底层的直播能力构建。请注意体验研讨会能力需要领取 TUILiveKit 体验版或开通 TUILiveKit 正式版,以确保相关功能的正常运行。

环境准备

在开始之前,请确保您已满足下列要求:
Xcode 14.0 及以上版本。
CocoaPods 1.7.5 及以上版本。如尚未安装,请参考 CocoaPods Guides > Getting Started 进行安装。
已在 Xcode 中登录 Apple ID。如果没有 Apple 开发者账号,可以使用免费的 Apple ID 进行开发测试。

获取 Demo

1. 下载源码,您可以通过下列两种方式来获取 Demo:
克隆项目到本地
下载 Demo 并解压
直接在命令行运行以下命令:
git clone https://github.com/Tencent-RTC/TUIKit_iOS
直接下载 TUIKit_iOS Demo,然后解压。
2. 在命令行中进入 iOS 项目目录:
cd TUIKit_iOS/application
3. 加载依赖库:
pod install --repo-update
注意:
如果您尚未安装 CocoaPods ,可以参见 此处 了解如何安装。
执行以上步骤后, 您将在工程目录下生成 Pods 目录 和 App-UIKit.xcworkspace 工程文件,请双击打开 App-UIKit.xcworkspace 文件。


配置 Demo

1. 配置 SDKAPPID 和 SECRETKEY:通过 Xcode 打开 App-UIKit.xcworkspace 工程后,将获取的 SDKAPPIDSECRETKEY 填入 Debug/GenerateTestUserSig.swift 文件中:

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


编译并运行 Demo

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


登录和注册

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






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

房间功能

登录成功后在主页会议功能入口进入会议场景,通过新建房间、加入房间 选择研讨会房间类型 进入 TUIRoomKit Demo 功能页面。
功能入口
房间主页
屏幕分享
成员管理面板












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

常见问题

pod install 安装依赖速度慢或失败怎么办?

如果您运行 pod install 命令后,遇到安装依赖速度较慢、链接失败、下载超时等情况时,可尝试移除官方源,添加国内镜像源,然后再重试:
# 移除官方源
gem sources --remove https://rubygems.org/
# 添加国内镜像源
gem sources --add https://gems.ruby-china.com/

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

请检查您在 TUIKit_iOS/application/Debug/GenerateTestUserSig.swift 文件中填写的 SDKAPPIDSECRETKEY 是否正确,确保它们是您在 开通服务 时获取到的密钥。

如何移除 Demo 中的通话和直播模块相关代码?

当前 Demo 为多功能集成示例,涵盖了腾讯云音视频的三大核心场景:通话(TUICallKit)、直播(TUILiveKit)和会议(TUIRoomKit)。若您的业务仅需会议场景,可通过以下步骤移除冗余模块代码,以精简项目结构和依赖:
1. 移除 Podfile 文件中 TUILiveKitTUICallKit Pod 依赖,并重新执行 pod install 命令。
2. 删除 Demo 工程中通话和直播场景相关代码。
3. 解决编译报错问题,编译并运行 Demo 工程。

联系我们

售前咨询

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

售后支持

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