升级指引
从v2.11.2起,SDK 使用 WebSocket 代替 HTTP 长轮询,作为底层传输技术。相比之下,WebSocket 有以下优点:
- 消息收发效率更高,SDK 使用推(Server Push)、拉(SDK Pull)结合的方式消息收发,在充分发挥 WebSocket 的优点,降低消息传输延时的同时,也保证了消息的可靠性。
- 大大减少了前端网络请求量,对小程序更友好。
- 更迅速的感知用户状态变更,当客户关闭浏览器 Tab 页或者强杀浏览器进程后,IM 状态系统可以非常迅速地感知到(如果客户端发出了 FIN 或 RST 报文,则实时感知,否则最迟60s感知)。
- 定位问题和排障效率更快。
有需要的客户请按照此指引升级。
1、接口向下兼容,接入侧可以平滑升级
请通过 npm 升级 SDK。
Web:
npm install tim-js-sdk --save
小程序:
npm install tim-wx-sdk --save
接口完全向下兼容,所有接口使用方式不变,接口文档。
2、小程序接入,更改受信域名
小程序使用前,需要将以下域名设为受信域名(已有的 im 受信域名可以都删掉):
- wss://wss.im.qcloud.com
- wss://wss.tim.qq.com
- https://web.sdk.qcloud.com
- https://webim.tim.qq.com
- https://api.im.qcloud.com
将以下域名添加到 downloadFile 合法域名:
- https://cos.ap-shanghai.myqcloud.com
- https://cos.ap-shanghai.tencentcos.cn
- https://cos.ap-guangzhou.myqcloud.com
将以下域名添加到 uploadFile 合法域名:
- https://cos.ap-shanghai.myqcloud.com
- https://cos.ap-shanghai.tencentcos.cn
- https://cos.ap-guangzhou.myqcloud.com