深入剖析 Taro 开发微信小程序时 TIM.EVENT.SDK_READY 事件失灵问题

2023-12-25 07:44:52

技术解析：Taro 开发微信小程序无法接收 TIM.EVENT.SDK_READY 事件

尽管 Taro 提供了开发微信小程序的便捷方式，但使用它与腾讯即时通信（TIM）集成时，可能会遇到无法接收 TIM.EVENT.SDK_READY 事件的问题。本文将深入分析此问题的原因并提供有效的解决方案。

问题成因

TIM.EVENT.SDK_READY 事件是 WebIM SDK 初始化完成后触发的，它表示 SDK 已准备就绪，可以进行后续操作。然而，在 Taro 开发的微信小程序中，由于某些特定的限制，可能导致此事件无法正常接收。

具体来说，Taro 框架会将所有依赖项编译为 JavaScript 代码，包括 WebIM SDK。当通过 npm 安装 WebIM SDK 时，编译后的代码中会包含 node_modules 目录，而这与原生微信小程序的限制相冲突。

解决方案

要解决此问题，我们需要手动将 WebIM SDK 的相关文件添加到微信小程序项目中，而不通过 Taro 编译。以下步骤提供了一种有效的方法：

安装 WebIM SDK： 使用 npm 命令安装 WebIM SDK：npm i tim-js-sdk 或 npm i tim-wx-sdk
手动添加文件： 将 node_modules/tim-js-sdk/tim-js-sdk.js 或 node_modules/tim-wx-sdk/tim-wx-sdk.js 文件手动添加到微信小程序项目中。请确保这些文件位于小程序项目的根目录。
修改 app.js： 在小程序的 app.js 文件中，导入刚才添加的 WebIM SDK 文件，如下所示：
```
import TIM from 'tim-js-sdk'
```
初始化 SDK： 使用 TIM.create() 初始化 WebIM SDK，并监听 TIM.EVENT.SDK_READY 事件，如下所示：
```
const tim = TIM.create({ ... });
tim.on(TIM.EVENT.SDK_READY, () => { ... });
```