更新记录

3.8.2（2024-09-30） 下载此版本

由于插件市场不支持版本后缀，所以和openim-sdk-core版本号会出现对不上的情况，请注意 v3.8.0 -> v3.8.1 出现部分api参数变化，具体请查看官方文档。

3.8.2 对应的是 openim-sdk-core/releases/tag/v3.8.1 3.8.1 对应的是 openim-sdk-core/releases/tag/v3.8.1-rc.17 （中期测试版本） 3.8.0 对应的是 openim-sdk-core/releases/tag/v3.8.0

3.8.1（2024-08-27） 下载此版本

更新依赖

3.8.0（2024-08-12） 下载此版本

新增API： unInitSDK onUserTokenInvalid getJoinedGroupListPage uploadLogs onSyncServerProgress getUsersInGroup 调整API： onSyncServerFailed、onSyncServerFinish、onSyncServerStart 回调参数 修复API： addBlack joinGroup

平台兼容性

原生插件通用使用流程：

1. 购买插件，选择该插件绑定的项目。
2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块，如需要填写参数则参考插件作者的文档添加。
3. 根据插件作者的提供的文档开发代码，在代码中引用插件，调用插件功能。
4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。
5. 开发完毕后正式云打包

付费原生插件目前不支持离线打包。
Android 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/android
iOS 离线打包原生插件另见文档 https://nativesupport.dcloud.net.cn/NativePlugin/offline_package/ios

注意事项：使用HBuilderX2.7.14以下版本，如果同一插件且同一appid下购买并绑定了多个包名，提交云打包界面提示包名绑定不一致时，需要在HBuilderX项目中manifest.json->“App原生插件配置”->”云端插件“列表中删除该插件重新选择

OpenIM介绍

OpenIM：由前微信技术专家打造的基于 Go 实现的即时通讯（IM）项目，从服务端到客户端SDK开源即时通讯（IM）整体解决方案，可以轻松替代第三方IM云服务，打造具备聊天、社交功能的app。

主要功能

消息类型

消息功能

用户资料托管

用户关系托管

群组

集成步骤

云端插件方式

1. 购买插件，选择该插件绑定的项目。

2. 在HBuilderX里找到项目，在manifest的app原生插件配置中勾选模块

3. 引入插件，调用插件功能

   const openSdk = uni.requireNativePlugin('Tuoyun-OpenIMSDK');
   const globalEvent = uni.requireNativePlugin('globalEvent');
   
   //初始化SDK
   initOpenIMSDK(dbDir) {
   const platformID = uni.getSystemInfoSync().platform == 'ios'?1:2
   const options = {
       platform: platformID, //平台类型
       ipApi: "http://12.123.123.66:10000", //api域名地址
       ipWs: "ws://12.123.123.66:17778", //websocket地址
       dbDir, //SDK数据存放目录
   };
   this.flag = openSdk.initSDK(options);
   },
   
   //监听回调
   setInitListener(){
    globalEvent.addEventListener("onConnectSuccess", (data) => {
                   //connect success...
               });
   }

   Tips: 以上仅展示示例API，更多完整SDK API请点击这里查看

4. 打包自定义基座，选择插件，得到自定义基座，然后运行时选择自定义基座，进行log输出测试。

5. 开发完毕后正式云打包

离线插件方式

离线插件下载地址及使用文档

参考资料

官方文档

示例工程(离线插件方式)