This document will guide you through quickly running the audio and video call Demo. By following this guide, you can run the Demo within 10 minutes and experience an audio and video call feature with a complete UI.
Please refer to Activate the Service to activate the audio/video service for the demo. After activation, take note of the SDKAppID and SDKSecretKey, which will be used in a later step (Configure and Run the Demo).
Download the Demo
1. Download the TUICallKit Demo source code from GitHub, or run the following command directly in your terminal:
2. In your terminal, navigate to the iOS project directory:
// First, cd into your downloaded project directory, then cd into the iOS project directory
cd TUICallKit/iOS/Example
3. Install the dependencies:
pod install
Run the Demo
Run the application using Xcode, run the Demo on two devices, log in with two user IDs—one as the caller and one as the callee—to complete an audio and video call experience.
Step 1: Configure and Run the Demo
1. Configure SDKAppID and SecretKey: Open the/iOS/Example/Debug/GenerateTestUserSig.swiftfile and fill in the SDKAppID and SDKSecretKey you obtained when Activate the Service:
2. Select Device: In Xcode, select the device you want to run the demo on, as shown below:
3. Compile and Run: Click the Run button to build and run our TUICallKit iOS Demo on the target device.
Step 2: Login and Registration
After the Demo starts, please enter an ID in the User ID field. If your current UserID has not been registered, you will enter the registration interface, where you can set a nickname for yourself.
Logged-in User: Charlie
Logged-in User: Jane
Tip:
Avoid using simple UserIDs such as "1", "123", or "111". These IDs are commonly used during collaborative development and may already be in use by others, resulting in login failures. We recommend using a unique UserID during testing.
Step 3: Make a Call
1. On the caller's device, tap 1V1 Call on the interface, enter the callee's UserID in the pop-up window, and select the desired call type.
2. Click Start Call.
Charlie calls Jane
Jane receives the incoming call
The call starts after Jane clicks "Answer"
Tips:
To start a call, you need to confirm that the Callee User ID is a valid and logged-in ID.
FAQs
A signature error or login failure occurs when running the demo?
Please check if the SDKAppID and SDKSecretKey you filled in the/iOS/Example/Debug/GenerateTestUserSig.swift file are correct. Ensure they are the keys you obtained when Activate the Service.
Purchase prompt appears during call?
Error Message
Solution
You have not purchased an audio and video calling package. Please go to the IM console to activate a free trial or purchase the official version.
The audio and video calling package you currently purchased does not support this feature. It is recommended that you upgrade your package type.
The audio and video calling package you currently purchased does not support this feature. It is recommended that you go to the console to upgrade your package type.
Tips:
If you encounter other error prompts, you can refer to the TUICallDefine Error Codes for a solution.
Contact Us
If you have any needs or feedback, you can contact: info_rtc@tencent.com.