更新记录

v1.2(2023-06-12)

  1. 增加头部 headers
  2. 增加是否重连 reconnect

v1.1(2023-02-07)

更新部分bug


平台兼容性

Android Android CPU类型 iOS
适用版本区间:4.4 - 12.0 armeabi-v7a:未测试,arm64-v8a:未测试,x86:未测试 ×

原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


原生插件通用使用流程:

  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原生插件配置”->”云端插件“列表中删除该插件重新选择


插件使用Android 原生websocket 链接, 心跳自行实现

以下是插件的接口方式

引入插入
const websocketModule = uni.requireNativePlugin("kyzone-websocket");
开始链接
websocketModule.connect({
     url: "ws://localhost",
     reconnect: true, // 是否重连
     headers:[
                         {
                             "key": "token",
                             "value": "123456789"
                         },
                         {
                             "key": "other",
                             "value": "123456789"
                         }
     ]
})
监听链接状态
export const WEBSOCKET_STATUS = {
    CONNECTED: 1, // 已连接
    CONNECTING: 0, // 链接中
    RECONNECT: 2, // 重连中
    DISCONNECTED: -1, // 已断开
}
plus.globalEvent.addEventListener('onConnectState', function(e) {
                const data = e.data;
                if (data == WEBSOCKET_STATUS.CONNECTED) {
                     //链接成功
                } else if (data == WEBSOCKET_STATUS.CONNECTING) {
                    //链接中
                } else if (data == WEBSOCKET_STATUS.DISCONNECTED) {
                    // 重连中
                } else if (data == WEBSOCKET_STATUS.RECONNECT) {
                    // 已断开
                }

})
// 链接异常
plus.globalEvent.addEventListener('onErrorMsg', function(e) {
            console.log("错误信息:" + e.data);
})
监听接收的信息
plus.globalEvent.addEventListener('', function(e) {
                const data = JSON.parse(e.data);
})
发送信息
websocketModule.sendMessage(data)
断开链接
websocketModule.close()

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不采集任何数据

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

作者未提供license.md

使用中有什么不明白的地方,就向插件作者提问吧~ 我要提问