Tutorial: WebSocket 升级指引

WebSocket 升级指引

升级指引

从v2.11.2起,SDK 使用 WebSocket 代替 HTTP 长轮询,作为底层传输技术。相比之下,WebSocket 有以下优点:

  • 消息收发效率更高,SDK 使用推(Server Push)、拉(SDK Pull)结合的方式消息收发,在充分发挥 WebSocket 的优点,降低消息传输延时的同时,也保证了消息的可靠性。
  • 大大减少了前端网络请求量,对小程序更友好。
  • 更迅速的感知用户状态变更,当客户关闭浏览器 Tab 页或者强杀浏览器进程后,IM 状态系统可以非常迅速地感知到(如果客户端发出了 FIN 或 RST 报文,则实时感知,否则最迟60s感知)。
  • 定位问题和排障效率更快。

有需要的客户请按照此指引升级。

1、接口向下兼容,接入侧可以平滑升级

请通过 npm 升级 SDK。

Web & 小程序 & uni-app

npm install @tencentcloud/chat --save

接口完全向下兼容,所有接口使用方式不变,接口文档

2、小程序接入,更改受信域名

小程序使用前,需要将以下域名设为受信域名(已有的 im 受信域名可以都删掉): 将以下域名添加到 socket 合法域名:

  • wss://wss.im.qcloud.com
  • wss://wss.tim.qq.com

将以下域名添加到 request 合法域名:

  • https://events.im.qcloud.com
  • https://boce-cdn.my-imcloud.com
  • https://web.sdk.qcloud.com
  • https://webim.tim.qq.com
  • https://api.im.qcloud.com

将以下域名添加到 downloadFile 合法域名:

  • https://cn.imrich.qcloud.com
  • https://cn.rich.my-imcloud.com
  • https://cos.ap-shanghai.myqcloud.com
  • https://cos.ap-shanghai.tencentcos.cn
  • https://cos.ap-guangzhou.myqcloud.com

将以下域名添加到 uploadFile 合法域名:

  • https://cn.imrich.qcloud.com
  • https://cn.rich.my-imcloud.com
  • https://cos.ap-shanghai.myqcloud.com
  • https://cos.ap-shanghai.tencentcos.cn
  • https://cos.ap-guangzhou.myqcloud.com