writeValueForCharacteristic

根据指定的外围设备 UUID 及其服务 UUID 和特征 UUID 写数据

writeValueForCharacteristic({params}, callback(ret, err))

params

peripheralUUID：

• 类型：字符串
• 描述：指定的蓝牙外围设备的 UUID

serviceUUID

• 类型：字符串
• 描述：指定的服务的 UUID

characteristicUUID

• 类型：字符串
• 描述：指定的特征的 UUID

value

• 类型：字符串
• 描述：要写入的数据 ，十六进制的字符串

writeType

• 类型：字符串
• 描述：（可选项）写入数据时的类型
• 默认：auto
• 取值范围：
  • auto：模块自动选择类型
  • response：有回调
  • withoutResponse：无回调
  • signed: 签名 (signed只支持Android)

callback(ret, err)

ret:

• 类型：JSON 对象
• 描述：每有数据接收便会触发此回调
• 内部字段：

{
     status: true ,      //布尔类型；是否发送成功，true|false
     characteristic:{    //JSON对象；获取监听的特征的信息
        uuid: '',        //字符串类型；特征的 UUID 
        serviceUUID: '', //字符串类型；服务的 UUID 
        permissions: '', //字符串类型；特征的权限，取值范围如下：
                         //readable：
                         //writeable：
                         //readEncryptionRequired：
                         //writeEncryptionRequired：
        propertie: ''    //字符串类型；特征的属性，取值范围如下：
                         //broadcast：
                         //read：
                         //writeWithoutResponse：
                         //write：
                         //notify：
                         //indicate：
                         //authenticatedSignedWrites：
                         //extendedProperties：
                         //notifyEncryptionRequired：
                         //indicateEncryptionRequired：
     }      
}

err:

• 类型：JSON 对象
• 内部字段：

{
     code: 1          //数字类型；失败时返回错误码，取值范围如下：
                      //-1：未知错误
                      //1：peripheralUUID 为空
                      //2：serviceUUID 为空
                      //3：characteristicUUID 为空
                      //4：value 为空
                      //5：未找到指定特征（characteristic）
                      //6：未找到指定服务（service）
                      //7：尚未搜索到该蓝牙设备
}

示例代码

var ble = api.require('ble');
ble.writeValueForCharacteristic({
    peripheralUUID: '',
    serviceUUID: '',
    characteristicUUID: '',
    value: ''
}, function(ret) {
    if (ret) {
        api.alert({ msg: JSON.stringify(ret) });
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本