Skip to content

Latest commit

 

History

History
83 lines (55 loc) · 5.89 KB

README_EN.md

File metadata and controls

83 lines (55 loc) · 5.89 KB

English | 简体中文

The web demo is implemented based on the IM TUIKit. TUIKit provides features such as management of conversations, chats, groups, and profiles. With TUIkit, you can quickly build your own business logic.

Demo UI

Conversation management

Initiate a Conversation Conversation List Manage the Conversation List

Chat management

Message List Send Messages Manage Group Chats

Group management

Group Notifications My Group Chats Search for and Join a Group Chat

Profile management

Manage the Profile
Feature Description
Conversation management 1. Initiate a one-to-one or group chat.
2. Display the conversation list.
3. Manage the conversation list.
Chat management 1. Display the message list.
2. Send messages.
3. Manage group chats.
Group management 1. Display group notifications.
2. Display and manage group chats that a user belongs to or owns.
3. Search for and join a group chat.
Profile management Display and update the profile.

Running the demo

Step 1. Download the source code

Download the SDK and matching demo source code.

# Run the code in CLI
git clone https://github.com/tencentyun/TIMSDK.git

# Go to the web project

cd TIMSDK/Web/Demo

# Install dependencies of the demo
yarn install

cd TIMSDK/Web/Demo/src/TUIKit

# Install dependencies of the TUIKit
yarn install

Step 2. Initialize the demo

  1. Open the project in the web directory, and find the GenerateTestUserSig file via the path /debug/GenerateTestUserSig.js.

  2. Set required parameters in the GenerateTestUserSig file, where SDKAppID and Key can be obtained in the IM console. Click the card of the target app to go to its basic configuration page.

  3. In the Basic Information area, click Display key, and copy and save the key information to the GenerateTestUserSig file.

! 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. The correct UserSig distribution method is to integrate the calculation code of UserSig into your server and provide an application-oriented API. When UserSig is needed, your application can send a request to the business server for a dynamic UserSig. For more information, see the "Calculating UserSig on the Server" section of Generating UserSig.

Step 3. Launch the project

# Launch the project
cd TIMSDK/Web/Demo
yarn serve