输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
管理中心
我的

HMS Core

App Services
输入关键字搜索
开发者能力认证
鸿蒙高校创新赛
HarmonyOS 7
animation
HarmonyOS行业解决方案
layoutWeight
HarmonyOS模板&组件
bindPopup
bindsheet
CTRL+K
API参考

onBLECharacteristicValueChange：设备主动上报低功耗蓝牙设备的特征值变化

更新时间: 2026-07-25 02:52

接口原型

public void onBLECharacteristicValueChange(String function)

方法描述：设备主动上报低功耗蓝牙设备的特征值变化。

请求参数

表1 请求参数
展开

参数名称

参数类型

参数描述

可选选项

function

String

获取低功耗蓝牙设备特征值变化回调函数名，该回调函数有四个参数，详情参见响应参数。

M

请求示例：

收起
自动换行
深色代码主题
复制
  1. function() {
  2.     window.changeCharacteristicsState = this.changeCharacteristicsState;
  3.     window.hilink.onBLECharacteristicValueChange("changeCharacteristicsState");        
  4. }

响应参数

表2 响应参数
展开

参数名称

参数类型

参数描述

可选选项

deviceId

String

蓝牙设备ID，通过接口getDeviceId()获取。

M

characteristicId

String

蓝牙设备特征值的UUID（不使用4位的简写，用完整写法的UUID）。

M

data

String

最新的特征值，以16进制字符串方式构造。

M
说明

closeBLEConnection调用前生效。closeBLEConnection后，会清除回调注册。

简体中文
华为开发者联盟 版权所有 ©2026
问题反馈
使用条款
华为开发者联盟用户协议
关于华为开发者联盟与隐私的声明
Cookies
开源软件声明