README.zh.md

Chinese | English

Update time: 2024-12-19

• ChatSDK 介绍
  • 开发环境要求
  • 集成 ChatSDK
  • 快速开始
  • 贡献
  • 许可证

ChatSDK 介绍

即时通讯 SDK（软件开发工具包）是一组工具、库和 API，旨在将实时消息传递功能集成到应用程序中。它允许开发人员轻松地将文本、语音和视频通信功能添加到移动应用、网站或其他平台，而无需从头构建通信基础设施。

开发环境要求

• MacOS 12 或更高版本
• React-Native 0.66 或更高版本
• NodeJs 16.18 或更高版本

对于 iOS 应用：

• Xcode 13 或更高版本及其相关的依赖工具。

对于 Android 应用：

• Android Studio 2021 或更高版本及其相关的依赖工具。

集成 ChatSDK

npm install react-native-chat-sdk
# 或
yarn add react-native-chat-sdk

快速开始

1. 初始化 SDK

   // 请使用appkey或appId进行初始化。
   const appKey = '<您的app key>';
   const appId = '<您的app ID>';
   ChatClient.getInstance()
     .init(
       appKey !== undefined
         ? ChatOptions.withAppKey({
             appKey: appKey,
             autoLogin: false,
           })
         : ChatOptions.withAppId({
             appId: appId,
             autoLogin: false,
           })
     )
     .then(() => {
       console.log('初始化成功');
     })
     .catch((reason) => {
       console.error(reason);
     });

2. 连接到服务器

   // 连接到服务器
   const userId = '<您的用户ID>';
   const userToken = '<您的用户令牌>';
   ChatClient.getInstance()
     .loginWithToken(userId, userToken)
     .then((value) => {
       console.log(`登录成功`, value);
     })
     .catch((reason) => {
       console.error(reason);
     });

3. 发送消息

   // 发送消息
   ChatClient.getInstance()
     .chatManager.sendMessage(message, {
       onError: (localMsgId: string, error: ChatError) => {
         console.error(error);
       },
       onSuccess: (message: ChatMessage) => {
         console.log(`发送成功`, message);
       },
     })
     .catch((reason) => {
       console.error(reason);
     });

贡献

请参阅贡献指南，了解如何为该仓库和开发流程做出贡献。

许可证

MIT