WebApp快捷打包
UDP 通信
转到模块插件

敬告:此 DEMO 演示为开放测试页面,仅用于开发者快速测试体验应用功能,请严格遵守开发者协议。

JS-SDK 引用方式:

♦ 普通网页 script 方式加载:下载最新版 jsBridge-v20260408.zip,请在页面上调用 jsBridge 接口之前引用 jsbridge-mini.js 库;

♦ js module 方式引用:npm install ym-jsbridge 具体请参考 npm package

事件监听

setListener 设置监听器

• 如需处理接口调用事件,请设置此监听器;

jsBridge.udp.setListener(function(event, data) {
    switch (event) {
        //接收到数据
        case "onMessage": {
            //data.address 远端地址
            //data.port    远端端口
            //data.dataAsBase64 收到的数据,Base64 编码字符串,需要自行解码为 byte[] 数据
            break;
        }
        //出现错误
        case "onError": {
            //data.message 错误信息
            break;
        }
        //关闭 UDP Socket
        case "onClose": {
            break;
        }
    }
    //此函数仅用于显示回调参数在本 DEMO 页面上
    showResult({
        event: event,
        data : data
    });
});

//请拉到页面底部查看回调数据信息
$('html,body').animate({ scrollTop: $('#view').offset().top }, 500);

removeListener 移除监听器

//移除监听器,不会再收到回调通知
//在需要时可重新调用 setListener
jsBridge.udp.removeListener();

接口

bind 绑定本地端口

port:

//绑定本地端口
jsBridge.udp.bind({
  //0~65535,数字类型,绑定的本地端口,0 表示由系统随机分配一个可用端口
  port: {{bind.port}}
}, function(success, res) {
  if (success) {
    alert(`绑定成功,监听端口为 ${res.port}`);
  } else {
    alert(JSON.stringify(res));
  }
});

send 发送数据

address:

port:

dataAsBase64:

//发送数据
jsBridge.udp.send({
  //目标地址,字符串类型,IPv4 地址或 IPv6 地址
  address: "{{send.address}}",
  //目标端口,数字类型,0~65535
  port: {{send.port}},
  //要发送的数据,byte[] 的 Base64 编码字符串
  dataAsBase64: "{{send.dataAsBase64}}"
}, function(success, res) {
  if (success) {
    alert('已发送');
  } else {
    alert(JSON.stringify(res));
  }
});

close 关闭 UDP Socket

//关闭 UDP Socket
jsBridge.udp.close(function(success, res) {
  if (success) {
    alert('已关闭');
  } else {
    alert(JSON.stringify(res));
  }
});

getStatus 获取状态

//获取 UDP Socket 状态
jsBridge.udp.getStatus(function(success, res) {
  if (success) {
    alert(`${res.isBind ? '已绑定' : '未绑定'}\n地址: ${res.localAddress}\n端口: ${res.localPort}`);
  } else {
    alert(JSON.stringify(res));
  }
});

监听回调数据: