chrome.bluetoothLowEnergy

说明

chrome.bluetoothLowEnergy API 用于使用 Generic Attribute Profile (GATT) 与蓝牙智能 (Low Energy) 设备通信。

清单

必须在清单中声明以下键才能使用此 API。

"bluetooth"

类型

Advertisement

Chrome 47 及更高版本

属性

• manufacturerData

  ManufacturerData[] 可选

  要包含在广告数据的“制造商专用数据”字段中的制造商专用数据的列表。

• serviceData

  ServiceData[] 可选

  要包含在广告数据的“服务数据”字段中的服务数据列表。

• serviceUuids

  string[] 可选

  要添加到广告数据的“服务 UUID”字段中的 UUID 列表。这些 UUID 可以是 16 位、32 位或 128 位格式。

• solicitUuids

  string[] 可选

  要包含在广告数据的“请求 UUID”字段中的 UUID 列表。这些 UUID 可以是 16 位、32 位或 128 位格式。

• 类型

  AdvertisementType

  广告类型。

AdvertisementType

Chrome 47 及更高版本

广告类型。如果选择“广播”，则发送的广告类型将为 ADV_NONCONN_IND，并且设备将使用随机 MAC 地址进行广播。如果设为“外围设备”，广告类型将为 ADV_IND 或 ADV_SCAN_IND，并且设备将使用真实蓝牙适配器的 MAC 地址进行广播。

枚举

"broadcast"

"peripheral"

Characteristic

属性

• instanceId

  字符串（选填）

  返回分配给此特征的标识符。使用实例 ID 来区分具有相同 UUID 的来自外围设备的特征，并进行接受特征标识符的函数调用。如果此实例表示远程特性，则为“存在”。

• 媒体资源

  CharacteristicProperty[]

  此特性的属性。

• 服务

  服务（可选）

  此特征所属的 GATT 服务。

• uuid

  字符串

  特征的 UUID，例如 00002a37-0000-1000-8000-00805f9b34fb。

• 值

  ArrayBuffer（可选）

  当前缓存的特征值。当通过通知或指示读取或更新特征的值时，此值会更新。

CharacteristicProperty

表示特征可能的属性的值。系统会根据这些属性推断出特征权限。如需了解各个属性的含义，请参阅蓝牙 4.x 规范。

枚举

"broadcast"

“read”

"writeWithoutResponse"

“write”

"notify"

“indicate”

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

属性

• 持久性

  布尔值

  一个标志，用于指示在应用的事件页面卸载时是否将与设备的连接保持打开状态（请参阅管理应用生命周期）。默认值为 false.。

Descriptor

属性

• 特征

  特征 - 可选

  此描述符所属的 GATT 特征。

• instanceId

  字符串（选填）

  返回分配给此描述符的标识符。使用实例 ID 来区分具有相同 UUID 的描述符，并进行接受描述符标识符的函数调用。如果此实例表示远程特性，则为“存在”。

• 权限

  DescriptorPermission[]

  Chrome 52 及更高版本

  此描述符的权限。

• uuid

  字符串

  特征描述符的 UUID，例如 00002902-0000-1000-8000-00805f9b34fb。

• 值

  ArrayBuffer（可选）

  当前缓存的描述符值。读取描述符的值时，此值会更新。

DescriptorPermission

Chrome 52 及更高版本

表示描述符可能的权限的值。如需了解每项权限的含义，请参阅蓝牙 4.x 规范。

枚举

“read”

“write”

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 及更高版本

属性

• 地址

  字符串

  设备的地址，格式为“XX:XX:XX:XX:XX:XX”。

• deviceClass

  number 可选

  设备的类，由 http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband 定义的位字段。

• name

  字符串（选填）

  设备的直观易懂的名称。

ManufacturerData

Chrome 47 及更高版本

属性

• 数据

  number[]

• id

  数值

Notification

Chrome 52 及更高版本

属性

• shouldIndicate

  布尔值（可选）

  用于发送指示（而非通知）的可选标志。

• 值

  ArrayBuffer

  特征的新值。

NotificationProperties

属性

• 持久性

  布尔值

  用于指示在应用的事件页面被卸载时，应用是否应接收通知的标志（请参阅管理应用生命周期）。默认值为 false。

Request

Chrome 52 及更高版本

属性

• 设备

  设备

  发送此请求的设备。

• requestId

  数值

  此请求的唯一 ID。在回复此请求时，请使用此 ID。

• 值

  ArrayBuffer（可选）

  要写入的值（如果这是写入请求）。

Response

Chrome 52 及更高版本

属性

• isError

  布尔值

  如果这是错误响应，则此值应为 true。

• requestId

  数值

  此响应所对应的请求的 ID。

• 值

  ArrayBuffer（可选）

  答案值。写入请求和错误响应将忽略此参数。

Service

属性

• deviceAddress

  字符串（选填）

  GATT 服务所属的远程外围设备的设备地址。如果此实例表示远程服务，则存在。

• instanceId

  字符串（选填）

  返回分配给此服务的标识符。使用实例 ID 来区分具有相同 UUID 的外围设备中的服务，并进行接受服务标识符的函数调用。如果此实例表示远程服务，则存在。

• isPrimary

  布尔值

  指示此服务的类型是主要还是次要。

• uuid

  字符串

  服务的 UUID，例如 0000180d-0000-1000-8000-00805f9b34fb。

ServiceData

Chrome 47 及更高版本

属性

• 数据

  number[]

• uuid

  字符串

方法

connect()

prometido

chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

在应用与指定地址的设备之间建立连接。设备可能已连接，并且其 GATT 服务可供使用，而无需调用 connect；但是，如果应用想要访问设备的 GATT 服务，则应调用此函数，以确保保持与设备的连接。如果设备未连接，系统会在成功调用 connect 后发现设备的所有 GATT 服务。

参数

• deviceAddress

  字符串

  应打开 GATT 连接的远程设备的蓝牙地址。

• 媒体资源

  ConnectProperties（可选）

  连接属性（可选）。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

createCharacteristic()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

创建本地托管的 GATT 特性。此特征必须托管在有效的服务下。如果服务 ID 无效，系统会设置 lastError。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• 特征

  特征

  要创建的特征。

• serviceId

  字符串

  要为其创建此特征的服务的 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (characteristicId: string) => void

  • characteristicId

    字符串

返回

• Promise<string>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

createDescriptor()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

创建本地托管的 GATT 描述符。此描述符必须托管在有效的特性下。如果特征 ID 无效，系统会设置 lastError。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• 描述符

  描述符

  要创建的描述符。

• characteristicId

  字符串

  要为其创建此描述符的特征的 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (descriptorId: string) => void

  • descriptorId

    字符串

返回

• Promise<string>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

createService()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

创建本地托管的 GATT 服务。此服务可注册为在本地 GATT 服务器上提供。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• 服务

  服务

  要创建的服务。

• callback

  函数（可选）

  callback 参数如下所示：

  (serviceId: string) => void

  • serviceId

    字符串

返回

• Promise<string>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

disconnect()

prometido

chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

关闭应用与指定地址的设备的连接。请注意，这并不总会破坏物理链接本身，因为可能还有其他应用有打开的连接。

参数

• deviceAddress

  字符串

  远程设备的蓝牙地址。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getCharacteristic()

prometido

chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

获取具有给定实例 ID 且属于给定 GATT 服务的 GATT 特征（如果存在）。

参数

• characteristicId

  字符串

  所请求 GATT 特性的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Characteristic) => void

  • 结果

    特征

返回

• Promise<Characteristic>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getCharacteristics()

prometido

chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

获取属于给定服务的所有已发现 GATT 特征的列表。

参数

• serviceId

  字符串

  应返回其特征的 GATT 服务的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Characteristic[]) => void

  • 结果

    特征[]

返回

• Promise<Characteristic[]>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getDescriptor()

prometido

chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

获取具有给定实例 ID 的 GATT 特征描述符。

参数

• descriptorId

  字符串

  请求的 GATT 特征描述符的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Descriptor) => void

  • 结果

    描述符

返回

• Promise<Descriptor>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getDescriptors()

prometido

chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

获取属于给定特征的 GATT 特征描述符的列表。

参数

• characteristicId

  字符串

  应返回其描述符的 GATT 特征的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Descriptor[]) => void

  • 结果

    描述符[]

返回

• Promise<Descriptor[]>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getIncludedServices()

prometido

chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

获取给定服务包含的 GATT 服务的列表。

参数

• serviceId

  字符串

  应返回其包含的服务的 GATT 服务的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Service[]) => void

  • 结果

    Service[]

返回

• Promise<Service[]>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getService()

prometido

chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

获取具有给定实例 ID 的 GATT 服务。

参数

• serviceId

  字符串

  请求的 GATT 服务的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Service) => void

  • 结果

    服务

返回

• Promise<Service>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

getServices()

prometido

chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

获取使用给定设备地址在远程设备上发现的所有 GATT 服务。

注意：如果设备上尚未完成服务发现，此 API 将返回部分服务（可能为空）。解决方法是添加基于时间的延迟和/或重复调用，直到返回预期的服务数量。

参数

• deviceAddress

  字符串

  应返回其 GATT 服务的远程设备的蓝牙地址。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Service[]) => void

  • 结果

    Service[]

返回

• Promise<Service[]>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

notifyCharacteristicValueChanged()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

通知远程设备某个特性的新值。如果通知对象中的 shouldIndicate 标志为 true，系统将发送指示，而不是发送通知。请注意，在创建过程中，特征需要正确设置“notify”或“indicate”属性，此调用才能成功。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• characteristicId

  字符串

  要为其发送通知的特征。

• 通知

  通知

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

readCharacteristicValue()

prometido

chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

从远程外围设备检索指定特性的值。

参数

• characteristicId

  字符串

  应从远程设备读取值的 GATT 特征的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Characteristic) => void

  • 结果

    特征

返回

• Promise<Characteristic>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

readDescriptorValue()

prometido

chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

从远程外围设备检索指定特征描述符的值。

参数

• descriptorId

  字符串

  应从远程设备读取值的 GATT 特征描述符的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  (result: Descriptor) => void

  • 结果

    描述符

返回

• Promise<Descriptor>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

registerAdvertisement()

Promise Chrome 47 及更高版本

chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

创建广告并将其注册为广告。如需调用此函数，应用必须将 bluetooth:low_energy 和 bluetooth:peripheral 权限设为 true。此外，此 API 仅适用于处于自助服务终端模式的自动启动应用，或通过设置“--enable-ble-advertising-in-apps”命令行开关启用的应用。请参阅 https://developer.chrome.com/apps/manifest/bluetooth。注意：某些硬件支持同时使用主设备和外围设备模式，但在不支持此模式的硬件上，执行此调用将会将设备切换到外围设备模式。如果硬件不同时支持主设备和外围设备模式，尝试同时在这两种模式下使用设备将导致未定义的行为，或阻止其他主设备角色应用正常运行（包括发现蓝牙低功耗设备）。

参数

• 广告

  广告

  要宣传的广告。

• callback

  函数（可选）

  callback 参数如下所示：

  (advertisementId: number) => void

  • advertisementId

    数值

返回

• Promise<number>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

registerService()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

向本地 GATT 服务器注册给定服务。如果服务 ID 无效，系统会设置 lastError。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• serviceId

  字符串

  创建的服务的唯一 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

removeService()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

移除指定服务，如果已注册，则取消注册。如果服务 ID 无效，系统会设置 lastError。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• serviceId

  字符串

  当前已注册服务的唯一 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

resetAdvertising()

Promise Chrome 61 及更高版本

chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

重置当前设备上的广告。此操作会取消注册并停止所有现有广告。

参数

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

sendRequestResponse()

Chrome 52 及更高版本

chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

发送对特征或描述符读取/写入请求的响应。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• Response

  答案

  对请求的响应。

setAdvertisingInterval()

Promise Chrome 55 及更高版本

chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

设置两次连续广告之间的间隔时间。注意：我们会尽力为您提供帮助。实际间隔时间可能与请求的间隔时间存在显著差异。在某些硬件上，最短间隔为 100 毫秒。最小值和最大值不得超过蓝牙 4.2 规范允许的范围。

参数

• minInterval

  数值

  广告之间的最短间隔（以毫秒为单位）。此值不得低于 20 毫秒（根据规范）。

• maxInterval

  数值

  广告之间的最大间隔（以毫秒为单位）。此值不得超过 10240 毫秒（根据规范）。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

startCharacteristicNotifications()

prometido

chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

启用指定特性的值通知/指示。启用后，应用可以使用 onCharacteristicValueChanged 事件监听通知。

参数

• characteristicId

  字符串

  应启用通知的 GATT 特性的实例 ID。

• 媒体资源

  NotificationProperties（可选）

  通知会话属性（可选）。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

stopCharacteristicNotifications()

prometido

chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

停用指定特性的值通知/指示。调用成功后，应用将停止接收来自此特性的通知/指示。

参数

• characteristicId

  字符串

  应停止此应用的通知会话的 GATT 特性的实例 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

unregisterAdvertisement()

Promise Chrome 47 及更高版本

chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

取消注册广告并停止其广告投放。如果广告未能取消注册，停止广告的唯一方法可能是重启设备。

参数

• advertisementId

  数值

  要取消注册的广告的 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

unregisterService()

Promise Chrome 52 及更高版本

chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

从本地 GATT 服务器注销给定服务。如果服务 ID 无效，系统会设置 lastError。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此函数才可用。并非所有应用都支持外围设备权限。

参数

• serviceId

  字符串

  当前已注册服务的唯一 ID。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

writeCharacteristicValue()

prometido

chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

从远程外围设备写入指定特性的值。

参数

• characteristicId

  字符串

  应将值写入到的 GATT 特征的实例 ID。

• 值

  ArrayBuffer

  应作为写入请求的一部分发送到远程特征的值。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

writeDescriptorValue()

prometido

chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

从远程外围设备写入指定特征描述符的值。

参数

• descriptorId

  字符串

  应将值写入到的 GATT 特征描述符的实例 ID。

• 值

  ArrayBuffer

  应作为写入请求的一部分发送到远程描述符的值。

• callback

  函数（可选）

  callback 参数如下所示：

  () => void

返回

• Promise<void>

  Chrome 91 及更高版本

  只有 Manifest V3 及更高版本支持 Promise，其他平台需要使用回调。

事件

onCharacteristicReadRequest

Chrome 52 及更高版本

chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

当已连接的中央设备请求读取在本地 GATT 服务器上注册的特征的值时触发。如果长时间不响应此请求，可能会导致断开连接。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此事件才可用。并非所有应用都支持外围设备权限。

参数

• callback

  函数

  callback 参数如下所示：

  (request: Request, characteristicId: string) => void

  • request

    请求

  • characteristicId

    字符串

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

当远程 GATT 特性的值发生更改（可能是由于读取请求或值更改通知/指示）时触发。只有当应用通过调用 startCharacteristicNotifications 启用了通知时，系统才会发送此事件。

参数

• callback

  函数

  callback 参数如下所示：

  (characteristic: Characteristic) => void

  • 特征

    特征

onCharacteristicWriteRequest

Chrome 52 及更高版本

chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

当已连接的中央设备请求写入在本地 GATT 服务器上注册的特征的值时触发。如果长时间不响应此请求，可能会导致断开连接。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此事件才可用。并非所有应用都支持外围设备权限。

参数

• callback

  函数

  callback 参数如下所示：

  (request: Request, characteristicId: string) => void

  • request

    请求

  • characteristicId

    字符串

onDescriptorReadRequest

Chrome 52 及更高版本

chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

当已连接的中央设备请求读取在本地 GATT 服务器上注册的描述符的值时触发。如果长时间不响应此请求，可能会导致断开连接。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此事件才可用。并非所有应用都支持外围设备权限。

参数

• callback

  函数

  callback 参数如下所示：

  (request: Request, descriptorId: string) => void

  • request

    请求

  • descriptorId

    字符串

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

当远程 GATT 特征描述符的值发生变化时触发（通常是由于读取请求而发生变化）。此事件主要是为了方便起见，并且始终会在成功调用 readDescriptorValue 后发送。

参数

• callback

  函数

  callback 参数如下所示：

  (descriptor: Descriptor) => void

  • 描述符

    描述符

onDescriptorWriteRequest

Chrome 52 及更高版本

chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

当已连接的中央设备请求写入在本地 GATT 服务器上注册的描述符的值时触发。如果长时间不响应此请求，可能会导致断开连接。只有当应用将 bluetooth:low_energy 和 bluetooth:peripheral 权限都设为 true 时，此事件才可用。并非所有应用都支持外围设备权限。

参数

• callback

  函数

  callback 参数如下所示：

  (request: Request, descriptorId: string) => void

  • request

    请求

  • descriptorId

    字符串

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

在远程设备上发现新的 GATT 服务时触发。

参数

• callback

  函数

  callback 参数如下所示：

  (service: Service) => void

  • 服务

    服务

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

当远程 GATT 服务的状态发生变化时触发。这涉及向服务添加或从服务中移除的任何特性和/或描述符，以及来自远程设备的“ServiceChanged”通知。

参数

• callback

  函数

  callback 参数如下所示：

  (service: Service) => void

  • 服务

    服务

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

当之前在远程设备上发现的 GATT 服务被移除时触发。

参数

• callback

  函数

  callback 参数如下所示：

  (service: Service) => void

  • 服务

    服务