# BLEPeripheralServer

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

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

外围设备的服务端

## 方法

### [BLEPeripheralServer.addService(Object object)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.addService)

添加服务。

### [BLEPeripheralServer.removeService(Object object)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.removeService)

移除服务。

### [BLEPeripheralServer.startAdvertising(Object Object)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.startAdvertising)

开始广播本地创建的外围设备。

### [BLEPeripheralServer.stopAdvertising()](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.stopAdvertising)

停止广播。

### [BLEPeripheralServer.writeCharacteristicValue(Object Object)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.writeCharacteristicValue)

往指定特征写入二进制数据值，并通知已连接的主机，从机的特征值已发生变化，该接口会处理是走回包还是走订阅。

### [BLEPeripheralServer.onCharacteristicWriteRequest(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicWriteRequest)

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

### [BLEPeripheralServer.offCharacteristicWriteRequest(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicWriteRequest)

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

### [BLEPeripheralServer.onCharacteristicReadRequest(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicReadRequest)

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

### [BLEPeripheralServer.offCharacteristicReadRequest(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicReadRequest)

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

### [BLEPeripheralServer.onCharacteristicSubscribed(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicSubscribed)

监听特征订阅事件，仅 iOS 支持。

### [BLEPeripheralServer.offCharacteristicSubscribed(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicSubscribed)

移除特征订阅事件的监听函数

### [BLEPeripheralServer.onCharacteristicUnsubscribed(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.onCharacteristicUnsubscribed)

监听取消特征订阅事件，仅 iOS 支持。

### [BLEPeripheralServer.offCharacteristicUnsubscribed(function listener)](/miniprogram/dev/api/device/bluetooth-peripheral/BLEPeripheralServer.offCharacteristicUnsubscribed)

移除取消特征订阅事件的监听函数