QQ 小程序集成介绍
大约 3 分钟
小程序集成文档
QQ 小程序集成介绍
QQ 小程序 SDK 集成步骤如下：
步骤一 注册环信账号
开发者需要在环信控制台 注册账号，创建应用，获取唯一 App Key，SDK 初始化时需要配置 App Key。
步骤二 搭建 QQ 小程序开发环境
首先需要下载并安装 开发者工具，然后按照 QQ 小程序的 接入流程 一步步创建一个小程序
步骤三 配置服务器域名
小程序在发布前，需要配置合法域名。
登录 QQ 小程序 开发者平台，进入 开发 > 开发设置 页面配置以下服务器地址。
| 域名类型 | 具体域名 |
|---|---|
| request 合法域名 | https://a1.easemob.com https://a2.easemob.com https://a3.easemob.com https://a4.easemob.com https://a5.easemob.com https://rs.chat.agora.io https://rs.easemob.com |
| socket 合法域名 | wss://im-api-wechat.easemob.com |
为满足不同客户的业务需求，环信在多地部署了数据中心。不同数据中心的 REST API 请求域名、WebSocket 访问域名不同。请根据您所在数据中心进行配置。
| 数据中心 | REST API 请求地址 | WebSocket 访问域名 |
|---|---|---|
| 国内 1 区 | a1.easemob.com | im-api-wechat.easemob.com 或 im-api-wechat.easecdn.com |
| 国内 2 区 | a31.easemob.com | im-api-wechat-31.easemob.com 或 im-api-wechat-31.easecdn.com |
| 国内 VIP 区 | 请咨询商务经理 | 请咨询商务经理 |
| 客服专用 | 请咨询商务经理 | 请咨询商务经理 |
| 新加坡 1 区 | a1-sgp.easemob.com 或 a1-sgp.easecdn.com | im-api-wechat-sgp.easemob.com 或 im-api-wechat-sgp.easecdn.com |
| 新加坡 2 区 | a61.easemob.com 或 a61.easecdn.com | im-api-wechat-61.easemob.com 或 im-api-wechat-61.easecdn.com |
| 美东 1 区 | a41.easemob.com 或 a41.easecdn.com | im-api-wechat-41.easemob.com 或 im-api-wechat-41.easecdn.com |
| 德国 2 区 | a71.easemob.com 或 a71.easecdn.com | im-api-wechat-71.easemob.com 或 im-api-wechat-71.easecdn.com |
应用所在数据中心可以在环信控制台的 应用概览 页面中查看：
提示
QQ、微信小程序： 1.7.0 及以上版本，最多可以同时存在 5 个 WebSocket 连接，需开发者控制好连接数量，超出此限制 SDK 将不能连接上服务器。
步骤四 下载 SDK
可以通过以下两种方式获取 SDK：
步骤五 引入 SDK
- 开始一个全新的项目
- 将下载的 SDK（src/sdk/）导入到自己的项目中。
- 引入 SDK：
import EasemobChat from "../sdk/Easemob-chat-4.x.x.js";
- 基于 Demo 二次开发
将下载的代码导入开发者工具即可运行起来。调用示例如下：
//使用示例
import EasemobChat from "../sdk/Easemob-chat-4.x.x.js"; // 4.0 版本sdk
步骤六 实例化 SDK
实例化 SDK，并挂载在全局对象下。
const WebIM = (wx.WebIM = EasemobChat);
WebIM.conn = new WebIM.connection({
appKey: "your appKey",
url: "wss://im-api-wechat.easemob.com/websocket", // socket server (3.0 SDK)
apiUrl: "https://a1.easemob.com", // rest server
useOwnUploadFun: false, // 是否使用自己的上传方式（如将图片文件等上传到自己的服务器，构建消息时只传url）
isHttpDNS: false, // 在小程序上需设置为false
});
小程序端的基本功能和 Web 端一致，请参考 Web 端文档。