chrome.bluetoothLowEnergy

Описание

chrome.bluetoothLowEnergy API используется для связи с устройствами Bluetooth Smart (Low Energy) с помощью профиля общих атрибутов (GATT).

Доступность

Только для ChromeOS

Манифест

Чтобы использовать этот API, в манифесте нужно объявить следующие ключи:

"bluetooth"

Типы

Advertisement

Chrome 47 и более поздних версий;

Свойства

  • manufacturerData

    ManufacturerData[] необязательный

    Список данных, относящихся к производителю, которые должны быть включены в поля "Данные, относящиеся к производителю" рекламных данных.

  • serviceData

    ServiceData[] необязательный

    Список данных сервиса, которые будут включены в поля Service Data рекламных данных.

  • serviceUuids

    string[] необязательно

    Список UUID, которые нужно включить в поле Service UUIDs (UUID сервисов) в Advertising Data (Рекламные данные). Эти UUID могут быть 16-, 32- или 128-битными.

  • solicitUuids

    string[] необязательно

    Список UUID, которые нужно включить в поле Solicit UUIDs (Запрашиваемые UUID) рекламных данных. Эти UUID могут быть 16-, 32- или 128-битными.

  • Тип объявления.

AdvertisementType

Chrome 47 и более поздних версий;

Тип объявления. Если выбрано значение broadcast, тип отправляемого объявления будет ADV_NONCONN_IND, а устройство будет транслировать со случайным MAC-адресом. Если задано значение peripheral, тип объявления будет ADV_IND или ADV_SCAN_IND, а устройство будет передавать данные с MAC-адресом реального адаптера Bluetooth.

Перечисление

"broadcast"

"peripheral"

Characteristic

Свойства

  • instanceId

    Строка (необязательно)

    Возвращает идентификатор, назначенный этой характеристике. Используйте идентификатор экземпляра, чтобы различать характеристики периферийного устройства с одним и тем же UUID и вызывать функции, которые принимают идентификатор характеристики. Присутствует, если этот экземпляр представляет удаленную характеристику.

  • объекты

    CharacteristicProperty[]

    Свойства этой характеристики.

  • сервис

    Служба доставки необязательный

    Сервис GATT, к которому относится эта характеристика.

  • uuid

    string

    UUID характеристики, например 00002a37-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer (необязательно)

    Текущее кешированное значение характеристики. Это значение обновляется, когда значение характеристики считывается или обновляется с помощью уведомления или индикации.

CharacteristicProperty

Значения, представляющие возможные свойства характеристики. Разрешения характеристик выводятся из этих свойств. Значение каждого свойства можно найти в спецификации Bluetooth 4.x.

Перечисление

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

thought "encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Свойства

  • постоянный

    Логическое значение

    Флаг, указывающий, остается ли подключение к устройству открытым, когда страница событий приложения выгружается (см. Управление жизненным циклом приложения). Значение по умолчанию – false..

Descriptor

Свойства

  • характеристика

    Характеристика необязательно

    Характеристика GATT, к которой относится этот дескриптор.

  • instanceId

    Строка (необязательно)

    Возвращает идентификатор, назначенный этому дескриптору. Используйте идентификатор экземпляра, чтобы различать дескрипторы периферийного устройства с одинаковым UUID и вызывать функции, которые принимают идентификатор дескриптора. Присутствует, если этот экземпляр представляет удаленную характеристику.

  • разрешения

    DescriptorPermission[]

    Chrome 52 и более поздних версий;

    Разрешения этого дескриптора.

  • uuid

    string

    UUID дескриптора характеристики, например 00002902-0000-1000-8000-00805f9b34fb.

  • value

    ArrayBuffer (необязательно)

    Текущее кешированное значение дескриптора. Это значение обновляется при считывании значения дескриптора.

DescriptorPermission

Chrome 52 и более поздних версий;

Значения, представляющие возможные разрешения для дескриптора. Значение каждого разрешения можно найти в спецификации Bluetooth 4.x.

Перечисление

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 и более поздних версий;

Свойства

  • Обращаться (к определенному вопросу)

    string

    Адрес устройства в формате 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

    Логическое значение (необязательно)

    Необязательный флаг для отправки индикации вместо уведомления.

  • value

    ArrayBuffer

    Новое значение характеристики.

NotificationProperties

Свойства

  • постоянный

    Логическое значение

    Флаг, указывающий, должно ли приложение получать уведомления, когда страница событий приложения выгружается (см. Управление жизненным циклом приложения). Значение по умолчанию – false.

Request

Chrome 52 и более поздних версий;

Свойства

  • устройство

    Устройство

    Устройство, отправившее этот запрос.

  • requestId

    число

    Уникальный идентификатор запроса. Используйте этот идентификатор при ответе на запрос.

  • value

    ArrayBuffer (необязательно)

    Значение, которое нужно записать (если это запрос на запись).

Response

Chrome 52 и более поздних версий;

Свойства

  • isError

    Логическое значение

    Если это ответ об ошибке, значение должно быть true.

  • requestId

    число

    Идентификатор запроса, на который отправлен ответ.

  • value

    ArrayBuffer (необязательно)

    Значение ответа. Запросы на запись и ответы об ошибках будут игнорировать этот параметр.

Service

Свойства

  • deviceAddress

    Строка (необязательно)

    Адрес удаленного периферийного устройства, к которому относится сервис GATT. Присутствует, если этот экземпляр представляет удаленный сервис.

  • instanceId

    Строка (необязательно)

    Возвращает идентификатор, назначенный этому сервису. Используйте идентификатор экземпляра, чтобы различать сервисы периферийного устройства с одинаковым UUID и вызывать функции, принимающие идентификатор сервиса. Присутствует, если этот экземпляр представляет удаленный сервис.

  • isPrimary

    Логическое значение

    Указывает, является ли сервис основным или дополнительным.

  • uuid

    string

    UUID сервиса, например 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 и более поздних версий;

Свойства

  • делал.

    number[]

  • uuid

    string

Методы

connect()

Promise 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

Устанавливает подключение между приложением и устройством с заданным адресом. Устройство может быть уже подключено, а его сервисы GATT – доступны без вызова connect. Однако приложение, которому нужен доступ к сервисам GATT устройства, должно вызвать эту функцию, чтобы убедиться, что подключение к устройству поддерживается. Если устройство не подключено, все его сервисы GATT будут обнаружены после успешного вызова connect.

Параметры

  • deviceAddress

    string

    Адрес Bluetooth удаленного устройства, с которым нужно установить GATT-подключение.

  • объекты

    ConnectProperties необязательный

    Свойства подключения (необязательно).

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

createCharacteristic()

Promise Chrome 52 и более поздних версий 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

Создайте локально размещенную характеристику GATT. Эта характеристика должна размещаться в допустимом сервисе. Если идентификатор сервиса недействителен, будет задано значение lastError. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • характеристика

    Характеристика

    Характеристика, которую нужно создать.

  • serviceId

    string

    Идентификатор сервиса, для которого нужно создать характеристику.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (characteristicId: string) => void

    • characteristicId

      string

Возвраты

  • Promise<string>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

createDescriptor()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

Создайте локально размещенный дескриптор GATT. Этот дескриптор должен размещаться в допустимой характеристике. Если идентификатор характеристики недействителен, будет установлено значение lastError. Эта функция доступна, только если для набора разрешений bluetooth:low_energy и bluetooth:peripheral установлено значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • дескриптор

    Дескриптор

    Дескриптор, который нужно создать.

  • characteristicId

    string

    Идентификатор характеристики, для которой нужно создать дескриптор.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (descriptorId: string) => void

    • descriptorId

      string

Возвраты

  • Promise<string>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

createService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Создание локально размещенного сервиса GATT. Этот сервис можно зарегистрировать, чтобы он был доступен на локальном сервере GATT. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • сервис

    Сервис

    Услуга, которая будет создана.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (serviceId: string) => void

    • serviceId

      string

Возвраты

  • Promise<string>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

disconnect()

Promise 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

Закрывает подключение приложения к устройству с указанным адресом. Обратите внимание, что это не всегда приводит к разрыву физического соединения, поскольку у других приложений могут быть открытые подключения.

Параметры

  • deviceAddress

    string

    Адрес Bluetooth удаленного устройства.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getCharacteristic()

Promise 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Получает характеристику GATT с заданным идентификатором экземпляра, которая принадлежит заданному сервису GATT, если характеристика существует.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра запрошенной характеристики GATT.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Characteristic) => void

Возвраты

  • Promise<Characteristic>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getCharacteristics()

Promise 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Получить список всех обнаруженных характеристик GATT, принадлежащих указанному сервису.

Параметры

  • serviceId

    string

    Идентификатор экземпляра сервиса GATT, характеристики которого нужно вернуть.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Characteristic[]) => void

Возвраты

  • Promise<Characteristic[]>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getDescriptor()

Promise 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Получить дескриптор характеристики GATT с заданным идентификатором экземпляра.

Параметры

  • descriptorId

    string

    Идентификатор экземпляра запрошенного дескриптора характеристики GATT.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Descriptor) => void

Возвраты

  • Promise<Descriptor>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getDescriptors()

Promise 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

Получить список дескрипторов характеристик GATT, принадлежащих данной характеристике.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра характеристики GATT, дескрипторы которой нужно вернуть.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Descriptor[]) => void

Возвраты

  • Promise<Descriptor[]>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getIncludedServices()

Promise 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Получить список сервисов GATT, включенных в указанный сервис.

Параметры

  • serviceId

    string

    Идентификатор экземпляра сервиса GATT, включенные сервисы которого нужно вернуть.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Service[]) => void

Возвраты

  • Promise<Service[]>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getService()

Promise 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

Получить сервис GATT с указанным идентификатором экземпляра.

Параметры

  • serviceId

    string

    Идентификатор экземпляра запрашиваемого сервиса GATT.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Service) => void

Возвраты

  • Promise<Service>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

getServices()

Promise 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

Получить все сервисы GATT, обнаруженные на удаленном устройстве с указанным адресом.

Примечание. Если обнаружение сервисов на устройстве ещё не завершено, API вернет подмножество сервисов (возможно, пустое). В качестве временного решения можно добавить задержку по времени и/или повторно вызывать метод, пока не будет возвращено ожидаемое количество сервисов.

Параметры

  • deviceAddress

    string

    Адрес Bluetooth удаленного устройства, службы GATT которого нужно вернуть.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Service[]) => void

Возвраты

  • Promise<Service[]>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

notifyCharacteristicValueChanged()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Уведомлять удаленное устройство о новом значении характеристики. Если флаг shouldIndicate в объекте уведомления имеет значение true, вместо уведомления будет отправлено указание. Обратите внимание, что для успешного вызова необходимо правильно задать свойство notify или indicate при создании характеристики. Эта функция доступна, только если для набора разрешений bluetooth:low_energy и bluetooth:peripheral установлено значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • characteristicId

    string

    Характеристика, для которой нужно отправить уведомление.

  • уведомление

    Уведомление

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

readCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Получить значение указанной характеристики с удаленного периферийного устройства.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра характеристики GATT, значение которой должно быть считано с удаленного устройства.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Characteristic) => void

Возвраты

  • Promise<Characteristic>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

readDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Получить значение указанного дескриптора характеристики с удаленного периферийного устройства.

Параметры

  • descriptorId

    string

    Идентификатор экземпляра дескриптора характеристики GATT, значение которого нужно считать с удаленного устройства.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (result: Descriptor) => void

Возвраты

  • Promise<Descriptor>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

registerAdvertisement()

Promise Chrome 47 и более поздние версии 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Создайте объявление и зарегистрируйте его для рекламы. Чтобы вызвать эту функцию, в приложении должны быть заданы разрешения bluetooth:low_energy и bluetooth:peripheral. Кроме того, этот API доступен только для автоматически запускаемых приложений в режиме киоска или при использовании параметра командной строки --enable-ble-advertising-in-apps. Подробная информация приведена на странице https://developer.chrome.com/apps/manifest/bluetooth. Примечание. На некоторых устройствах поддерживается одновременная работа в режимах центрального и периферийного устройств. Если это не так, то при вызове устройство переключится в режим периферийного устройства. Если аппаратное обеспечение не поддерживает оба режима, попытка использовать устройство в обоих режимах приведет к неопределенному поведению или помешает правильной работе других приложений в центральном режиме (включая обнаружение устройств Bluetooth с низким энергопотреблением).

Параметры

  • реклама, рекламное объявление

    Реклама

    Объявление, которое нужно рекламировать.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    (advertisementId: number) => void

    • advertisementId

      число

Возвраты

  • Promise<number>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

registerService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Зарегистрируйте указанный сервис на локальном сервере GATT. Если идентификатор сервиса недействителен, будет задано свойство lastError. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • serviceId

    string

    Уникальный идентификатор созданного сервиса.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

removeService()

Promise Chrome 52+ 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Удаляет указанный сервис и отменяет его регистрацию, если он был зарегистрирован. Если идентификатор сервиса недействителен, будет задано свойство lastError. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • serviceId

    string

    Уникальный идентификатор текущего зарегистрированного сервиса.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

resetAdvertising()

Promise Chrome 61 и более поздние версии 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

Сброс рекламного идентификатора на текущем устройстве. Регистрация всех существующих объявлений будет отменена, а их показ – остановлен.

Параметры

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

sendRequestResponse()

Chrome 52 и более поздних версий; 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Отправляет ответ на запрос чтения/записи характеристики или дескриптора. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • Ответ

    Ответ

    Ответ на запрос.

setAdvertisingInterval()

Promise Chrome 55 и более поздние версии 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Задает интервал между двумя последовательными объявлениями. Примечание. Это приблизительные данные. Фактический интервал может значительно отличаться от запрошенного. На некоторых устройствах минимальный интервал составляет 100 мс. Минимальное и максимальное значения не могут выходить за пределы диапазона, разрешенного спецификацией Bluetooth 4.2.

Параметры

  • minInterval

    число

    Минимальный интервал между объявлениями (в миллисекундах). Согласно спецификации, это значение не может быть меньше 20 мс.

  • maxInterval

    число

    Максимальный интервал между объявлениями (в миллисекундах). Согласно спецификации, это значение не может превышать 10 240 мс.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

startCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

Включить уведомления/индикацию значений для указанной характеристики. После этого приложение сможет прослушивать уведомления с помощью события onCharacteristicValueChanged.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра характеристики GATT, для которой нужно включить уведомления.

  • объекты

    NotificationProperties необязательный

    Параметры сеанса уведомлений (необязательно).

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

stopCharacteristicNotifications()

Promise 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

Отключить уведомления/индикацию значений для указанной характеристики. После успешного вызова приложение перестанет получать уведомления/индикации от этой характеристики.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра характеристики GATT, на которой должен быть остановлен сеанс уведомлений этого приложения.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

unregisterAdvertisement()

Promise Chrome 47 и более поздние версии 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Отменяет регистрацию объявления и прекращает его показ. Если отменить регистрацию объявления не удается, единственным способом остановить его показ может быть перезапуск устройства.

Параметры

  • advertisementId

    число

    Идентификатор объявления, регистрацию которого нужно отменить.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

unregisterService()

Promise Chrome 52 и более поздних версий 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Отменить регистрацию указанного сервиса на локальном сервере GATT. Если идентификатор сервиса недействителен, будет задано свойство lastError. Эта функция доступна, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • serviceId

    string

    Уникальный идентификатор текущего зарегистрированного сервиса.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

writeCharacteristicValue()

Promise 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

Записать значение указанной характеристики с удаленного периферийного устройства.

Параметры

  • characteristicId

    string

    Идентификатор экземпляра характеристики GATT, значение которой нужно записать.

  • value

    ArrayBuffer

    Значение, которое должно быть отправлено удаленной характеристике в рамках запроса на запись.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

writeDescriptorValue()

Promise 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

Записать значение указанного дескриптора характеристики с удаленного периферийного устройства.

Параметры

  • descriptorId

    string

    Идентификатор экземпляра дескриптора характеристики GATT, значение которого нужно записать.

  • value

    ArrayBuffer

    Значение, которое должно быть отправлено удаленному дескриптору в рамках запроса на запись.

  • обратный вызов

    function необязательно

    Параметр callback выглядит следующим образом: 

    () => void

Возвраты

  • Promise<void>

    Chrome 91 и более поздних версий

    Объекты Promise поддерживаются только в Manifest V3 и более поздних версиях. На других платформах нужно использовать обратные вызовы.

События

onCharacteristicReadRequest

Chrome 52 и более поздних версий; 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Срабатывает, когда подключенное центральное устройство запрашивает чтение значения характеристики, зарегистрированной на локальном сервере GATT. Если вы долго не будете отвечать на этот запрос, связь может быть прервана. Это событие доступно, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

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

onCharacteristicValueChanged

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

Срабатывает, когда значение удаленной характеристики GATT изменяется в результате запроса на чтение или уведомления/индикации об изменении значения. Это событие будет отправлено, только если приложение включило уведомления, вызвав startCharacteristicNotifications.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 и более поздних версий; 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Срабатывает, когда подключенное центральное устройство запрашивает запись значения характеристики, зарегистрированной на локальном сервере GATT. Если вы долго не будете отвечать на этот запрос, связь может быть прервана. Это событие доступно, только если для набора разрешений bluetooth:low_energy и bluetooth:peripheral установлено значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

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

onDescriptorReadRequest

Chrome 52 и более поздних версий; 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Срабатывает, когда подключенное центральное устройство запрашивает чтение значения дескриптора, зарегистрированного на локальном сервере GATT. Если вы долго не будете отвечать на этот запрос, связь может быть прервана. Это событие доступно, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

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

onDescriptorValueChanged

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

Срабатывает, когда значение дескриптора характеристики удаленного GATT меняется, обычно в результате запроса на чтение. Это событие существует в основном для удобства и всегда отправляется после успешного вызова readDescriptorValue.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 и более поздних версий; 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Срабатывает, когда подключенное центральное устройство запрашивает запись значения дескриптора, зарегистрированного на локальном сервере GATT. Если вы долго не будете отвечать на этот запрос, связь может быть прервана. Это событие доступно, только если для разрешений bluetooth:low_energy и bluetooth:peripheral задано значение true. Разрешение на доступ к периферийным устройствам может быть доступно не для всех приложений.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

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

onServiceAdded

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

Срабатывает, когда на удаленном устройстве обнаружен новый сервис GATT.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (service: Service) => void

onServiceChanged

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

Срабатывает, когда меняется состояние удаленного сервиса GATT. Это касается любых характеристик и/или дескрипторов, которые добавляются в сервис или удаляются из него, а также уведомлений ServiceChanged от удаленного устройства.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (service: Service) => void

onServiceRemoved

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

Срабатывает, когда сервис GATT, ранее обнаруженный на удаленном устройстве, удаляется.

Параметры

  • обратный вызов

    function

    Параметр callback выглядит следующим образом: 

    (service: Service) => void