开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
基础 api
基础
应用级事件
界面
跳转
多媒体
缓存
文件
位置
网络
设备
系统信息
网络状态
截屏
剪贴板
摇一摇
振动
加速度计
陀螺仪
罗盘
设备方向
拨打电话
获取服务器时间
用户截屏事件
屏幕亮度
设置
添加手机联系人
无障碍
权限引导
扫码
内存不足告警
获取设备电量
蓝牙
低功耗蓝牙
传统蓝牙
ibeacon
wi-fi
短信
worker
数据安全
分享
收藏
自定义通用菜单
更新管理
web-view组件控制
升级支付宝最新版本
隐私信息授权
小程序广告
开放能力 api
开发 > api > 基础 api > 设备 > 蓝牙 > 蓝牙 api 概览
评论
收藏
我的文档
设置
蓝牙类型支付宝客户端版本需求android 或 ios 版本需求
ble 低功耗蓝牙支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理
  • android: 5.0 及以上版本
  • ios:无版本需求
传统蓝牙
  • 支付宝客户端 10.0.18 或更高版本,若版本较低,建议做 兼容处理
  • my.startbluetoothdevicesdiscovery 方法的 allowduplicateskey 和 interval 参数,从支付宝客户端 10.0.20 版本开始支持。
-
ibeacon支付宝客户端 10.1.8 或更高版本,若版本较低,建议做 兼容处理-

低功耗蓝牙流程图

传统蓝牙流程图

蓝牙类型名称功能说明
低功耗蓝牙my.onbleconnectionstatechanged监听低功耗蓝牙连接的错误事件,包括设备丢失,连接异常断开等。
my.offbleconnectionstatechanged取消低功耗蓝牙连接状态变化事件的监听。
my.getbledeviceservices获取指定低功耗蓝牙设备所有服务列表。
my.connectbledevice连接低功耗蓝牙设备。
my.disconnectbledevice断开与低功耗蓝牙设备的连接。
my.getbledevicecharacteristics获取低功耗蓝牙设备某个服务中所有特征(characteristic)。
my.setblemtu设置低功耗蓝牙设备最大传输单元(mtu)。需在 my.connectbledevice 调用成功后调用,mtu 设置范围(22, 512)。
my.getblemtu获取低功耗蓝牙设备的最大传输单元(mtu)。
my.notifyblecharacteristicvaluechange启用低功耗蓝牙设备特征值变化时的 notify 功能。
my.onblecharacteristicvaluechange监听低功耗蓝牙设备的特征值变化的事件。
my.offblecharacteristicvaluechange取消监听低功耗蓝牙设备的特征值变化的事件。
my.writeblecharacteristicvalue向低功耗蓝牙设备特征值中写入数据。
my.readblecharacteristicvalue读取低功耗蓝牙设备特征值中的数据。
my.getbledevicerssi获取蓝牙低功耗设备的信号强度(received signal strength indication, rssi)。
my.getbledevicestatus获取设备蓝牙授权和开关状态。
传统蓝牙my.openbluetoothadapter初始化小程序蓝牙适配器。
my.closebluetoothadapter关闭本机蓝牙模块。
my.getbluetoothadapterstate获取本机蓝牙模块状态。
my.onbluetoothadapterstatechange监听本机蓝牙状态变化的事件。
my.offbluetoothadapterstatechange移除本机蓝牙状态变化的事件的监听。
my.onbluetoothdevicefound搜索到新的蓝牙设备时触发此事件。
my.offbluetoothdevicefound移除寻找到新的蓝牙设备事件的监听。
my.startbluetoothdevicesdiscovery开始搜寻附近的蓝牙外围设备。
my.stopbluetoothdevicesdiscovery停止搜寻附近的蓝牙外围设备。
my.getbluetoothdevices获取所有已发现的蓝牙设备,包括已经和本机处于连接状态的设备
my.getconnectedbluetoothdevices获取处于已连接状态的设备。
my.makebluetoothpair蓝牙配对接口。连接蓝牙之前,部分设备需要先配对。
my.cancelbluetoothpair取消蓝牙设备配对。
my.getbluetoothpairs获取已经配对的蓝牙设备。
ibeaconmy.getbeacons获取已经搜索到的 ibeacon 设备。
my.startbeacondiscovery开始搜索附近的 ibeacon 设备。
my.stopbeacondiscovery停止搜索附近的 ibeacon 设备。
my.onbeaconupdate监听 ibeacon 设备的更新事件。
my.offbeaconupdate取消监听 ibeacon 设备的更新事件。
my.offbeaconservicechange取消监听 ibeacon 服务的状态变化。
my.onbeaconservicechange监听 ibeacon 服务的状态变化。
//初始化
my.openbluetoothadapter({
  success: (res) => {
    console.log(res);
  },
  fail: (error) => {
    console.log(error);
  },
});
//注册发现事件
my.onbluetoothdevicefound((res) => {
  let device = res.devices[0];
  //连接发现的设备
  my.connectbledevice({
    deviceid: device.deviceid,
    success: (res) => {
      console.log(res);
    },
    fail: (error) => {
      console.log(error);
    },
  });
  //停止搜索
  my.stopbluetoothdevicesdiscovery({
    success: (res) => {
      console.log(res);
    },
    fail: (error) => {
      console.log(error);
    },
  });
});
//注册连接事件
my.onbleconnectionstatechanged((res) => {
  console.log(res);
  if (res.connected) {
    //开始读写notify等操作
    my.notifyblecharacteristicvaluechange({
      deviceid: deviceid,
      serviceid: serviceid,
      characteristicid: characteristicid,
      success: (res) => {
        console.log(res);
      },
      fail: (error) => {
        console.log(error);
      },
    });
  }
});
//注册接收read或notify的数据
my.onblecharacteristicvaluechange((res) => {
  console.log(res);
});
//开始搜索
my.startbluetoothdevicesdiscovery({
  services: ["fff0"],
  success: (res) => {
    console.log(res);
  },
  fail: (error) => {
    console.log(error);
  },
});
//断开连接
my.disconnectbledevice({
  deviceid: deviceid,
  success: (res) => {
    console.log(res);
  },
  fail: (error) => {
    console.log(error);
  },
});
//注销事件
my.offbluetoothdevicefound();
my.offbleconnectionstatechanged();
my.offblecharacteristicvaluechange();
//退出蓝牙模块
my.closebluetoothadapter({
  success: (res) => {},
  fail: (error) => {
    console.log(error);
  },
});
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
网站地图