QQ 小程序集成介绍

前提条件

注册声网账号

开发者需要在声网控制台注册账号、创建项目、获取唯一 App ID，SDK 初始化时需要配置 App ID。

实现步骤

搭建 QQ 小程序开发环境

首先需要下载并安装 开发者工具，然后按照 QQ 小程序的 接入流程 一步步创建一个小程序。

配置服务器域名

小程序在发布前，需要配置合法域名。

登录 QQ 小程序 开发者平台，进入 开发 > 开发设置 页面配置以下服务器地址。

提示

request 合法域名：

1. https://c1.chat.rtnsvc.com
2. https://c1.chat.realtimemesh.com
3. https://rs.chat.rtnsvc.com
4. https://rs.chat.realtimemesh.com

提示

socket 合法域名： wss://im-api-wechat-c1.chat.rtnsvc.com wss://im-api-wechat-c1.chat.realtimemesh.com

提示

uploadFile, downloadFile 合法域名：

1. https://c1.chat.rtnsvc.com
2. https://c1.chat.realtimemesh.com
3. https://c1-chatfile.chat.rtnsvc.com

说明

QQ、微信小程序： 1.7.0 及以上版本，最多可以同时存在 5 个 WebSocket 连接，需开发者控制好连接数量，超出此限制 SDK 将不能连接上服务器。

集成 SDK

下载 SDK

可以通过以下两种方式获取 SDK：

• 通过 CDN下载 SDK。
• 通过 npm 下载 shengwang-chat。

sdk 文件为 miniProgram 文件夹下的 Shengwang-chat.js

引入 SDK

• 开始一个全新的项目
  1. 将下载的 SDK 导入到自己的项目中。
  2. 引入 SDK：import ChatSDK from "./Shengwang-chat";

将下载的代码导入开发者工具即可运行起来。

调用示例

// 使用示例
import ChatSDK from "./Shengwang-chat";

实例调用方式

// 实例化 SDK 对象
const chatClient = new ChatSDK.connection({
  appId: "your appId",
});

IM 基本功能和 Web 端一致，请参考 Web 端文档。