This document mainly describes how to quickly run the Chat Demo.
Directions
1. Create an App
1. Log in to the Tencent RTC Console. If you already have an app, record its SDKAppID and SDKSecretKey and jump directly to the next section.
2. Click Create Application, enter your Application name, product, Region, and click Create.
2. Obtain SDKAppID and SDKSecretKey
After creation, you can view the newly created app's Status, SDKAppID, Expiration time, etc., on the Applications page:
Record the SDKAppID and SDKSecretKey from the Application Information.
Danger:
Keep the SDKSecretKey properly to prevent disclosure.
3. Download and Configure the Demo
Note：
To respect the copyright of emoji designs, the Chat Demo/TUIKit project does not include cutouts of large emoji elements. Please replace them with your own designs or other emoji packs for which you hold the copyright before officially launching for commercial use. The default smiley face emoji pack shown below is copyrighted by Tencent RTC and is available for licensed use for a fee. If you need to obtain a license, please contact us.
2. Open the project in the terminal directory and find the GenerateTestUserSig.h file. The path is: chat-uikit-ios-main/Demo/TUIKitDemo/Private/GenerateTestUserSig.h
3. Set the relevant parameters:
SDKAPPID: set it to the SDKAppID obtained above.
SECRETKEY: set it to the SDKSecretKey obtained above.
Warning：
1. In this document, the method to obtain UserSig is to configure a SECRETKEY in the client code. In this method, the SECRETKEY is vulnerable to decompilation and reverse engineering. Once your SECRETKEY is disclosed, attackers can steal your Tencent Cloud traffic. Therefore, this method is only suitable for locally running a demo project and feature debugging.
2. The correct UserSig distribution method is to integrate the calculation code of UserSig into your server and provide an app-oriented API. When UserSig is needed, your app can send a request to the business server to obtain a dynamic UserSig. For more information, see How to Generate UserSig on the Server.
3. To respect the copyright of emoji design, the downloaded demo project does not contain sliced images of major emoji elements. You can use your local emoji packs to configure code. Unauthorized use of the emoji pack in the Chat demo may infringe on the design copyright.
4. Compile and Run the Demo
See the file README.md in the corresponding directory of the demo project cloned above.
1. Run the following command on the terminal to check the pod version:
pod --version
If the system indicates that no pod exists or that the pod version is earlier than 1.7.5, run the following commands to install the latest pod.
//Change Gem Source
gem sources --remove https://rubygems.org/
gem sources --add https://gems.ruby-china.com/
//Install pod
sudo gem install cocoapods -n /usr/local/bin
// If multiple versions of Xcode are installed, run the following command to choose an Xcode version (usually the latest one):
2. Run the following commands on the terminal, and open the directory where Podfile is located to install dependent libraries:
Swift
Objective-C
cd Swift/TUIKitDemo
pod install
cd chat-uikit-ios-main/Demo
pod install
If installation fails, run the following command to update the local CocoaPods repository list:
pod repo update
3. Compile and run the demo:
Swift project, enter the Swift/TUIKitDemo folder, open the TUIKitDemo.xcworkspace and compile and run.
Objective-C project, enter the chat-uikit-ios-main/Demo folder, open the TUIKitDemo.xcworkspace and compile and run.
Note：
The demo is integrated with the audio/video call feature by default. However, the TRTC SDK on which the audio/video call feature relies currently does not support simulators. Please use real devices for demo running or debugging.
Experience basic features
Create User Account
If you have successfully run the Demo by following the above steps, you can start experiencing the basic features.
First, you need to create a user account. There are many ways to do this, for example, by registering through log in to Demo on the client side or creating some in the console. You can choose any method that suits you.
Client Registration
Simply log in to the Demo with several different accounts.
Create in Console
The steps are as follows:
1. Click to enter the application you created above, and you will see the Chat product entry on the left sidebar, click to enter.
2. After entering the Chat Product subpage, click on Users to go to the User Management Page.
3. Click Create account, a pop-up will appear for you to fill in the account creation information. If you are just a regular member, we recommend you choose the General type. Although Nickname is not mandatory, we still suggest you set it. If it's inconvenient to display userID on the interface, you can identify different users through Nickname.
The details are as follows:
Note:
Sending messages involves at least two users, so at this step, you need to create at least 2 accounts. Please note down the userID of these 2 accounts for subsequent steps.
Add to Contacts
After switching to the Contacts interface:
1. Click the + button in the top right corner of the interface, and in the submenu, select Add to Contacts.
2. Enter a valid userID and search for the user. If you have already created an account in the console, you can go to the console Account Management page to get a valid userID. Page path: Applications > Your App > Chat > Users > Account Management.
3. Add user as contact.
The steps are shown below:
Click [Add to Contacts]
Search user
Send contact request
After successfully adding, the user will appear in the contact list:
Sending Messages
Select a user, click Message to enter the message interface:
Next, you can send messages, voice, images, and make audio/video calls with the user in the message interface:
