更新记录

1.0.0(2024-06-24)

首个版本


平台兼容性

Android Android CPU类型 iOS
适用版本区间:6.0 - 14.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原生插件配置”->”云端插件“列表中删除该插件重新选择


连接

let tcMqtt = uni.requireNativePlugin("Tilecats-tcMqtt");
tcMqtt.setOnMessageCall(onMessageCall);//设置收到消息的回调
tcMqtt.setOnDisconnectCall(onDisconnectCall);//设置连接断开的回调
tcMqtt.reconnect(
  {
    url : 'tcp://服务器ip或域名:端口号',
    clientId: '自己定义的客户端id',
    connectTimeout: 3000, //连接超时
    username: "用户名",
    password: "密码",
    qos : 2,
    topics : ['test'] //连接成功后需要订阅的消息
  },
  onConnectFinish //连接成功后的回调函数
);

主动断开连接

tcMqtt.close();

发布消息

tcMqtt.publish(
  {
    topic : 'topic', //主题
    qos : 2,
    payload : 'message' //消息负载,一般为 json 文本
  },
  callback //发送完成的回调
)

回调函数

//响应消息的回调
function onMessageCall(msg) {
    let topic = msg.topic; //获取消息主题
    let msgId = msg.id; //获取消息 id
    let payload = JSON.parse(msg.payload); //获取消息负载
    console.log(`Mqtt[onMessage] ${topic} ${msg.payload}`);
    //处理响应逻辑
}

//响应断开连接的回调
function onDisconnect(){
    uni.showToast({
      icon : "none",
      title : "Mqtt服务已断开",
      duration: 2000
    });
    console.warn(`Mqtt[onDisconnect] mqtt onDisconnect`);
}

隐私、权限声明

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

<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE"/> <uses-permission android:name="android.permission.ACCESS_WIFI_STATE"/>

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

插件不采集任何数据

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

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