更新记录

1.0.0（2024-03-13）

初始版本

平台兼容性

原生插件通用使用流程：

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

ep-udp

介绍

一个简单的udp插件。

使用场景

1. 服务端知道设备的 IP 之后，可以给设备发送消息，同时设备也可以给服务端发送消息
2. 服务端给同个网段内的设备广播消息
3. 客户端给同个网段内的设备互相广播

Demo

const udpClient = uni.requireNativePlugin('ep-udp');
export default {
  onLoad() {
    /**
     * 在设备初始化，监听 8586 端口。
     * 假设设备 IP 为 192.168.1.99
     * 那么服务端，或者其设备，就可以给 192.168.1.99:8586 发送消息了
     */
    udpClient.start({
        port: 8586,
        hex: false
    },(res)=>{
        // code:0 监听到到数据
        // code > 0 其他反馈信息
        console.log(res)
    });
    udpClient.send({
      ip: "192.168.1.99", // 目标IP
      port: 8586, // 目标断开
      msg: "待发送字符串",
      hex: false // 是否使用 hexString ，默认为 false
    },(res)=>{
        // callback 发送反馈
        console.log(res)
    });
  },
  onUnload() {
    // 释放 socket，释放端口
    udpClient.stop((res)=>{
        // callback
        console.log(res)
    });
  }
}

使用文档

引入

// #ifdef APP-PLUS
const client = uni.requireNativePlugin('ep-udp');
// #endif

监听端口

/**
 * 监听端口
 */
client.start({
  port: number, // 默认 8586
  hex: Boolean // 返回值类型 默认false
},callback,msgback);

发送消息

/**
 * 发送消息
 */
client.send({
  ip: String, // 默认 255.255.255.255 广播
  port: number, // 默认 8586
  msg: String, // 必选
  hex: Boolean, // 是否发送 hexString，默认 false
},callback);

释放

/**
 * 释放，拿到数据之后手动释放，不然会占用资源
 */
client.stop(callback);