本文档主要介绍如何快速跑通 TUIRoomKit 视频会议 Demo,体验高质量多人视频会议。跟随本文档,开发者可以在 10 分钟内跑通 Demo,并最终体验一个包含完备 UI 界面的多人视频会议功能。
房间准备页 | 房间主页 | 成员管理 |
![]() | ![]() | ![]() |
前提条件
开通服务
SDKAppID:App 在控制台获取的 Room 应用的 ID,为应用的唯一标识。SDKSecretKey:应用的密钥。说明:
SDKAppID 和 SDKSecretKey 是什么?
SDKAppID:应用的唯一标识。
SDKSecretKey:用于签发 UserSig(用户签名)的密钥,能确保只有您的应用才能使用腾讯云的服务,防止被盗用。请务必妥善保管,不要泄露。
环境准备
HBuilderX:HBuilderX 是 uni-app 官方的集成开发环境(IDE),我们需要用它来导入、配置和运行我们的 Demo。
两个移动设备: Android 5.0 以上的设备 / iOS 13.0 及以上设备。
说明:
HBuilderX 4.64 和 4.65 版本对 UTS 插件打包存在已知兼容性问题,建议使用 4.75 或更高版本。
获取 Demo
1. 下载源码。
cd TUIKit_uni-app/App
2. 使用 HBuilderX 导入
TUIKit_uni-app/App。在 HBuilderX 顶部菜单栏选择文件 > 导入 > 从本地目录导入,然后精确选择刚才克隆的
TUIKit_uni-app/App 文件夹,单击导入。
配置 Demo
打开 TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件,将获取到的
SDKAppID 和 SDKSecretKey 填入其中:// Your SDKAppIDlet SDKAppID = 0;// Your SDKSecretKeylet SDKSECRETKEY = "";
编译并运行 Demo
1. 制作自定义调试基座
制作自定义调试基座,在 HBuilderX 顶部菜单栏选择运行 > 运行到手机或模拟器 > 制作自定义调试基座。HBuilderX 会开始打包,这需要一些时间。

说明:
为什么要制作自定义调试基座?
因为我们的多人视频会议 Demo 使用了原生的音视频能力(通过 UTS 插件实现),这超出了 HBuilderX 标准基座(一个通用的 App 壳子)的功能范围。因此,我们需要制作一个包含了这些原生插件的“专属”运行环境,这就是“自定义调试基座”。
2. 使用自定义基座运行项目
使用自定义基座运行项目,基座制作成功后,HBuilderX 控制台会有提示。然后,再次单击顶部菜单 “运行” -> “运行到手机或模拟器”,在弹出的设备选择窗口中,务必勾选“使用自定义调试基座”,然后选择您的真机设备并单击运行。

登录和注册
Demo 启动后,请输入登录的用户 ID 。如果您当前的 ID 未曾注册过,会进入到注册界面,您可以在该界面为自己设置昵称。
登录页 | 注册页 |
![]() | ![]() |
提示:
请避免将 UserID 设置为“1”、“123”、“111”等简单字符串,以免多人协作时被他人占用导致登录失败。调试时建议设置具有辨识度的 UserID。
房间功能
登录成功后主页通过会议功能入口进入 TUIRoomKit Demo 功能页面。
功能入口 | 房间主页 | 成员管理面板 |
![]() | ![]() | ![]() |
注意:
如果想用不同手机体验音视频互通场景,请确保在
TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件中填写的 SDKAppID 是一致的。常见问题
运行 Demo 提示签名错误或登录失败?
请检查您在
TUIKit_uni-app/App/debug/GenerateTestUserSig.js 文件中填写的 SDKAppID 和 SDKSecretKey 是否正确,确保它们是您在 腾讯云控制台应用管理 页面获取到的密钥。联系我们
售前咨询
当需要购买咨询时,可以直接通过 售前咨询 进行提问,会有专属客户经理在线为您解答,提供专业的上云方案。同时也可以直接致电销售人员,咨询热线:4009100100转1(工作日9:00 - 18:00)。







