This document provides a quick guide to running the TUIRoomKit Webinar Demo. You’ll be able to try out core features including creating a webinar room, Audio/Video streaming, screen sharing, member management, and large-scale message interaction. Follow this guide to get the demo up and running in under 10 minutes and experience a fully-featured webinar room with a complete UI.
What’s the difference between a standard conference and a webinar?
Standard Conference: Designed for small to medium-sized collaborative scenarios where all participants have equal Audio/Video permissions. Features like screen sharing and member management enable full interaction.
Webinar: Built for large-scale live presentations, supporting unlimited audience entry. Audiences can use the Raise Hand feature to apply to become a guest and join the discussion. The system is optimized for high-concurrency messaging in scenarios with tens of thousands of participants, meeting the needs of professional presentations and interactions.
Feature Overview
Host
Guest
Audience
Host can start high-definition audio/video streaming, share screens, and manage participants.
Guest can enable their microphone for real-time voice discussions and sharing.
Supports unlimited concurrent audience entry, ultra-low latency viewing, and high-frequency chat. Audience can use "Raise Hand" to request guest access.
Prerequisites
Activate the Service
Refer to Activate the Service to claim the TUILiveKit trial version or activate the official TUILiveKit version. Then, go to the Application Management page to obtain the following information:
SDKAppID: Application identifier, used by TRTC for billing and statistics.
SDKSecretKey: Application SecretKey, used to initialize the configuration file.
Note：
The webinar scenario is built on underlying live streaming capabilities. To use webinar features, you must claim the TUILiveKit trial version or activate the official TUILiveKit version to ensure all related features work properly.
Directly download the TUIKit_iOS demo and extract it.
2. Navigate to the iOS project directory in your terminal:
cd TUIKit_iOS/application
3. Install dependencies:
pod install --repo-update
Note：
If you have not installed CocoaPods, refer to here for installation instructions.
After completing these steps, you will see the Pods directory and the App-UIKit.xcworkspace project file in your project directory. Double-click App-UIKit.xcworkspace to open it.
Setup
1. Configure SDKAPPID and SECRETKEY: After opening the App-UIKit.xcworkspace project in Xcode, enter your SDKAPPID and SECRETKEY in the Debug/GenerateTestUserSig.swift file:
2. Configure Apple Developer Signing: In the project TARGETS under Signing & Capabilities, check Automatically manage signing, and set your Apple Developer account and Bundle Identifier:
Build and Run the Demo
Multi-party conference scenarios require camera and microphone access, so it’s recommended to run the demo on a real device.
1. Connect your iOS device to your computer. On your device, go to Settings > Privacy & Security > Developer Mode and enable Developer Mode.
2. In the Xcode toolbar, select your iOS device from the iOS Device dropdown menu.
3. Click the Run button to deploy the app to your device.
Note:
For the full conference room experience, run the demo on two devices and log in with two different users (for example, one device as the host and one as a participant).
Login and Registration
After launching the demo, enter your User ID to log in. If the User ID has not been registered before, you’ll be taken to the registration page to set your nickname.
Login Page
Registration Page
Tip:
Avoid using simple UserIDs like "1", "123", or "111" to prevent login failures caused by duplicate IDs during multi-user testing. For debugging, use a unique UserID.
Room Features
After logging in, enter the conference scenario from the main page. Create or join a room, select the webinar room type, and access the TUIRoomKit demo feature page.
Feature Entry
Room Home
Screen Sharing
Member Management Panel
Note:
To experience Audio/Video interconnectivity across different devices, make sure the SDKAPPID in the TUIKit_iOS/application/Debug/GenerateTestUserSig.swift file is the same on all devices.
FAQs
Slow or Failed Dependency Installation with pod install
If you experience slow installation, connection failures, or download timeouts when running pod install, try removing the official source and adding a domestic mirror source, then retry:
# Remove official source
gem sources --remove https://rubygems.org/
Demo Shows Signing Error or Login Failure
Check that the SDKAPPID and SECRETKEY you entered in TUIKit_iOS/application/Debug/GenerateTestUserSig.swift are correct and match the credentials obtained from Activate the Service.
Remove Call and Live Streaming Modules from the Demo
The current demo integrates three core TRTC Audio/Video scenarios: Call (TUICallKit), Live Streaming (TUILiveKit), and Conference (TUIRoomKit). If your use case only requires the conference scenario, you can remove unnecessary modules to streamline the project:
1. Remove the TUILiveKit and TUICallKit Pod dependencies from the Podfile, then re-run pod install.
2. Delete call and live streaming related code from the demo project.
3. Resolve any compilation errors, then build and run the demo project.
Contact Us
If you have any questions or suggestions during integration or use, contact info_rtc@tencent.com to submit feedback.
