chrome.bluetoothLowEnergy

Описание

API chrome.bluetoothLowEnergy используется для связи с устройствами Bluetooth Smart (Low Energy) с использованием профиля Generic Attribute Profile (GATT) .

Доступность

Только для ChromeOS

Манифест

Для использования этого API в манифесте необходимо указать следующие ключи.

"bluetooth"

Типы

Advertisement

Chrome 47+

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

  • производительДанные

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

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

  • сервисДанные

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

    Список сервисных данных, которые должны быть включены в поля «Сервисные данные» рекламной информации.

  • serviceUuids

    строка[] необязательный

    Список UUID, которые следует включить в поле "UUID сервиса" в рекламных данных. Эти UUID могут быть в 16-битном, 32-битном или 128-битном формате.

  • solicitUuids

    строка[] необязательный

    Список UUID, которые следует включить в поле "UUID для рассылки" в рекламных данных. Эти UUID могут быть в 16-битном, 32-битном или 128-битном формате.

  • Тип рекламы.

AdvertisementType

Chrome 47+

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

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

"транслировать"

«периферийный»

Characteristic

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

  • instanceId

    строка необязательный

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

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

  • услуга

    Услуга необязательна.

    Данная характеристика относится к сервису ГАТТ.

  • uuid

    нить

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

  • ценить

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

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

CharacteristicProperty

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

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

"транслировать"

"читать"

"writeWithoutResponse"

"писать"

"уведомить"

"указывать"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

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

  • настойчивый

    логический

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

Descriptor

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

  • характерный

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

    Данный дескриптор относится к характеристике ГАТТ.

  • instanceId

    строка необязательный

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

  • разрешения

    DescriptorPermission []

    Chrome 52+

    Права доступа, указанные в этом описании.

  • uuid

    нить

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

  • ценить

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

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

DescriptorPermission

Chrome 52+

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

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

"читать"

"писать"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52+

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

  • адрес

    нить

    Адрес устройства в формате 'XX:XX:XX:XX:XX:XX'.

  • deviceClass

    число необязательно

    Класс устройства — это битовое поле, определенное в соответствии с http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • имя

    строка необязательный

    Удобочитаемое название устройства.

ManufacturerData

Chrome 47+

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

  • данные

    число[]

  • идентификатор

    число

Notification

Chrome 52+

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

  • следует указать

    логический необязательный

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

  • ценить

    ArrayBuffer

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

NotificationProperties

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

  • настойчивый

    логический

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

Request

Chrome 52+

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

  • устройство

    Устройство

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

  • requestId

    число

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

  • ценить

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

    Значение для записи (если это запрос на запись).

Response

Chrome 52+

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

  • isError

    логический

    Если это сообщение об ошибке, то должно быть истинно.

  • requestId

    число

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

  • ценить

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

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

Service

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

  • адрес устройства

    строка необязательный

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

  • instanceId

    строка необязательный

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

  • isPrimary

    логический

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

  • uuid

    нить

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

ServiceData

Chrome 47+

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

  • данные

    число[]

  • uuid

    нить

Методы

connect()

Обещать
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
): Promise<void>

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

Параметры

  • адрес устройства

    нить

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

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

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

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для 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

    нить

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

  • перезвонить

    функция необязательна

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

    (characteristicId: string) => void

    • characteristicId

      нить

Возвраты

  • Promise<string>

    Chrome 91+

    Поддержка промисов доступна только для 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

    нить

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

  • перезвонить

    функция необязательна

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

    (descriptorId: string) => void

    • descriptorId

      нить

Возвраты

  • Promise<string>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

createService()

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

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

Параметры

  • услуга

    Услуга

    Сервис для создания.

  • перезвонить

    функция необязательна

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

    (serviceId: string) => void

    • serviceId

      нить

Возвраты

  • Promise<string>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

disconnect()

Обещать
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

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

Параметры

  • адрес устройства

    нить

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getCharacteristic()

Обещать
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

Параметры

  • characteristicId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Characteristic) => void

Возвраты

  • Обещание< Характеристика >

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getCharacteristics()

Обещать
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Получите список всех обнаруженных характеристик ГАТТ, относящихся к указанной службе.

Параметры

  • serviceId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Characteristic[]) => void

Возвраты

  • Обещание< Характеристика []>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getDescriptor()

Обещать
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

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

Параметры

  • descriptorId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Descriptor) => void

Возвраты

  • Promise< Descriptor >

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getDescriptors()

Обещать
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

Получите список дескрипторов характеристик ГАТТ, относящихся к заданной характеристике.

Параметры

  • characteristicId

    нить

    Идентификатор экземпляра характеристики ГАТТ, дескрипторы которой должны быть возвращены.

  • перезвонить

    функция необязательна

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

    (result: Descriptor[]) => void

Возвраты

  • Обещание< Дескриптор []>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getIncludedServices()

Обещать
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Получите список услуг ГАТТ, которые включены в данную услугу.

Параметры

  • serviceId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Service[]) => void

Возвраты

  • Обещание< Сервис []>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getService()

Обещать
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

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

Параметры

  • serviceId

    нить

    Идентификатор экземпляра запрошенной услуги ГАТТ.

  • перезвонить

    функция необязательна

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

    (result: Service) => void

Возвраты

  • Обещание< Сервис >

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

getServices()

Обещать
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

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

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

Параметры

  • адрес устройства

    нить

    Bluetooth-адрес удалённого устройства, для которого должны быть возвращены GATT-сервисы.

  • перезвонить

    функция необязательна

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

    (result: Service[]) => void

Возвраты

  • Обещание< Сервис []>

    Chrome 91+

    Поддержка промисов доступна только для 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

    нить

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

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

    Уведомление

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

readCharacteristicValue()

Обещать
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

Параметры

  • characteristicId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Characteristic) => void

Возвраты

  • Обещание< Характеристика >

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

readDescriptorValue()

Обещать
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

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

Параметры

  • descriptorId

    нить

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

  • перезвонить

    функция необязательна

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

    (result: Descriptor) => void

Возвраты

  • Promise< Descriptor >

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

registerAdvertisement()

Promise Chrome 47+
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

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

Параметры

  • реклама

    Реклама

    Рекламное объявление для рекламы.

  • перезвонить

    функция необязательна

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

    (advertisementId: number) => void

    • advertisementId

      число

Возвраты

  • Обещание<число>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

registerService()

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

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

Параметры

  • serviceId

    нить

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

removeService()

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

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

Параметры

  • serviceId

    нить

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

resetAdvertising()

Promise Chrome 61+
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

Параметры

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для 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.

Параметры

  • минИнтервал

    число

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

  • maxInterval

    число

    Максимальный интервал между показом рекламы (в миллисекундах). Он не может превышать 10240 мс (согласно спецификации).

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

startCharacteristicNotifications()

Обещать
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
): Promise<void>

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

Параметры

  • characteristicId

    нить

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

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

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

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

stopCharacteristicNotifications()

Обещать
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

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

Параметры

  • characteristicId

    нить

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

unregisterAdvertisement()

Promise Chrome 47+
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • advertisementId

    число

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

unregisterService()

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

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

Параметры

  • serviceId

    нить

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

writeCharacteristicValue()

Обещать
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

Параметры

  • characteristicId

    нить

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

  • ценить

    ArrayBuffer

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

writeDescriptorValue()

Обещать
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
): Promise<void>

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

Параметры

  • descriptorId

    нить

    Идентификатор экземпляра дескриптора характеристики ГАТТ, значение которого должно быть записано.

  • ценить

    ArrayBuffer

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

  • перезвонить

    функция необязательна

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

    () => void

Возвраты

  • Обещание<пустота>

    Chrome 91+

    Поддержка промисов доступна только для Manifest V3 и более поздних версий; для других платформ необходимо использовать колбэки.

События

onCharacteristicReadRequest

Chrome 52+
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

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

Параметры

  • перезвонить

    функция

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

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

onCharacteristicValueChanged

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

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

Параметры

  • перезвонить

    функция

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

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52+
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

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

Параметры

  • перезвонить

    функция

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

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

onDescriptorReadRequest

Chrome 52+
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

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

Параметры

  • перезвонить

    функция

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

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

onDescriptorValueChanged

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

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

Параметры

  • перезвонить

    функция

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

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52+
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

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

Параметры

  • перезвонить

    функция

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

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

onServiceAdded

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

Срабатывает при обнаружении новой службы ГАТТ на удаленном устройстве.

Параметры

  • перезвонить

    функция

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

    (service: Service) => void

onServiceChanged

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

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

Параметры

  • перезвонить

    функция

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

    (service: Service) => void

onServiceRemoved

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

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

Параметры

  • перезвонить

    функция

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

    (service: Service) => void