# BLEPeripheralServer.onCharacteristicWriteRequest(function listener)

> 基础库 2.10.3 开始支持，低版本需做[兼容处理](1003706)。

> __小程序插件__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [蓝牙介绍](/minigame/dev/guide/device/bluetooth.md)

## 功能描述

监听已连接的设备请求写当前外围设备的特征值事件。收到该消息后需要立刻调用 [writeCharacteristicValue](/minigame/dev/api/device/bluetooth-peripheral/BLEPeripheralServer/BLEPeripheralServer.writeCharacteristicValue) 写回数据，否则主机不会收到响应。

## 参数

### function listener

已连接的设备请求写当前外围设备的特征值事件的监听函数

#### 参数

##### Object res

| 属性 | 类型 | 说明 |
| ---- | ---- | ---- |
| serviceId  | String | 蓝牙特征对应服务的 UUID |
| characteristicId  | String | 蓝牙特征的 UUID |
| callbackId  | Number | 唯一标识码，调用 [writeCharacteristicValue](/minigame/dev/api/device/bluetooth-peripheral/BLEPeripheralServer/BLEPeripheralServer.writeCharacteristicValue) 时使用 |
| value  | ArrayBuffer | 请求写入特征的二进制数据值 |