This guide walks you through getting started with the TUILiveKit iOS Demo in just 10 minutes. Experience a fully featured UI for video live streaming and voice chat room scenarios.
Quick Experience
You can directly experience all Live features using the following methods.
Prerequisites
Enable the Service
SDKAppID: Application identifier (required). Tencent Cloud uses SDKAppId for billing and details.
SDKSecretKey: Application secret key, used to initialize the configuration file with secret information.
Environment Preparation
Ensure your development environment meets these requirements:
Xcode: Xcode 15 or later
iOS System: Devices running iOS 13.0 or later
Install CocoaPods via gem:
sudo gem install cocoapods
Tip：
During sudo gem install cocoapods, you may be prompted for your computer password. Enter your administrator password as instructed.
Instructions
Get the Demo
1. Download the source code: Download the TUIKit_iOS source code from GitHub, or run: git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
2. Install dependencies: In your terminal, navigate to the directory containing the Podfile and run:
# The Demo project's Podfile is located in the application directory
cd application/
# Install dependencies
pod install --repo-update
3. After installation, you will see a Pods directory and an App-UIKit.xcworkspace file in your project directory. Double-click App-UIKit.xcworkspace to open the project.
Setup
1. Configure SDKAppID and SDKSecretKey: In the App-UIKit.xcworkspace project, enter your SDKAppID and SDKSecretKey in the Debug/GenerateTestUserSig.swift file.
Note：
In this Demo, authentication is performed by configuring SecretKey in the client code. SecretKey can be reverse-engineered; if leaked, attackers can steal your Tencent Cloud traffic. This method is for local Demo testing and debugging only.
For production, generate UserSig on your server. When needed, your app should request a dynamic UserSig from your business server. See Generating UserSig on the Server for details. 2. Configure Apple Developer Signing: In the project’s TARGETS under the Signing & Capabilities tab, enable Automatically manage signing and set your Apple Developer account and Bundle Identifier.
Build and Run the Demo
Live streaming scenarios require camera and microphone access. Use a physical device for debugging and running the Demo.
1. Connect your iOS device to your computer. On the device, go to Settings > Privacy & Security > Developer Mode and enable Developer Mode.
2. In Xcode, select your device from the iOS Device dropdown.
3. Click the Run button to deploy the app to your device.
Note:
For a complete live streaming workflow, run the Demo on two devices and log in with two different users (e.g., one as the host and one as the audience).
Experience the Basic Features
1. Login & Registration
Enter your ID in the UserID field. If the UserID has not been used before, you’ll be redirected to the registration page to set your avatar and nickname.
Anchor（mike） |
| Audiece（vince） |
|
| | | |
Note:
Do not use simple UserIDs such as "1", "123", or "111".
TRTC does not support multi-end login for the same UserID, and these simple UserIDs are likely to be used by others during collaborative development, which can cause login failures. Use distinctive UserIDs during debugging.
2. Video Live Streaming
Click Live > Video Live to start a video live streaming session.
3. Voice Chat Room
Click Live > Voice Room to start a voice chat session.
Next Steps
After running the Demo, refer to the following integration guides to add these features to your own project:
|
Video Live Streaming | Supports ultra-low latency HD streaming, multi-user co-hosting/PK, real-time beauty filters, bullet comments, and gift interactions—enabling you to build interactive video live streaming scenarios. | |
Voice Chat Room | Delivers ultra-clear audio quality, supports multi-user co-hosting, seat management, and real-time text chat—ideal for KTV, social, or gaming-themed rooms. | |
FAQs
Encounter signature errors or login failures when running the Demo
Encounter error code "-3301" with the message "Services are not available in your region" after entering the room
If you receive this error code, contact us for support. Contact Us
