Run Demo
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
1. Download the iOS demo project from Github.
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 Sourcegem sources --remove https://rubygems.org/gem sources --add https://gems.ruby-china.com///Install podsudo 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):sudo xcode-select -switch /Applications/Xcode.app/Contents/Developer//Update Pod Local Repositorypod setup
2. Run the following commands on the terminal, and open the directory where Podfile is located to install dependent libraries:
cd chat-uikit-ios-main/Demopod install
If installation fails, run the following command to update the local CocoaPods repository list:
pod repo update
3. Compile and run the demo: Go to the
chat-uikit-ios-main/Demo
folder, and open TUIKitDemo.xcworkspace
to compile and run the demo.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: