chrome.bluetoothLowEnergy

Описание

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

Манифест

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

"bluetooth"

Типы

Advertisement

Хром 47+

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

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

    Данные производителя [] необязательно

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

  • serviceData

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

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

  • serviceUuids

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

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

  • solicitUuids

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

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

  • Вид рекламы.

AdvertisementType

Хром 47+

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

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

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

"периферийный"

Characteristic

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

  • идентификатор_экземпляра

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

    Возвращает идентификатор, назначенный данной характеристике. Используйте идентификатор экземпляра, чтобы различать характеристики периферийного устройства с одинаковым 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

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

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

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

    Характеристика ГАТТ, к которой принадлежит этот дескриптор.

  • идентификатор_экземпляра

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

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

  • разрешения

    DescriptorPermission []

    Хром 52+

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

  • uuid

    нить

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

  • ценить

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

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

DescriptorPermission

Хром 52+

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

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

"читать"

"писать"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Хром 52+

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

  • адрес

    нить

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

  • deviceClass

    номер необязательно

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

  • имя

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

    Понятное для человека название устройства.

ManufacturerData

Хром 47+

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

  • данные

    число[]

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

    число

Notification

Хром 52+

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

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

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

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

  • ценить

    ArrayBuffer

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

NotificationProperties

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

Request

Хром 52+

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

  • устройство

    Устройство

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

  • requestId

    число

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

  • ценить

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

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

Response

Хром 52+

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

  • isError

    булев

    Если это ответ об ошибке, то это должно быть правдой.

  • requestId

    число

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

  • ценить

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

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

Service

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

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

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

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

  • идентификатор_экземпляра

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

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

  • isPrimary

    булев

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

  • uuid

    нить

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

ServiceData

Хром 47+

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

  • данные

    число[]

  • uuid

    нить

Методы

connect()

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

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

Параметры

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

    нить

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

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

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

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

createCharacteristic()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

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

Параметры

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

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

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

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    (characteristicId: string) => void

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

      нить

Возврат

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

    Хром 91+

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

createDescriptor()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

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

Параметры

  • дескриптор

    Дескриптор

    Создаваемый дескриптор.

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

    нить

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

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

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

    Параметр callback выглядит так: 

    (descriptorId: string) => void

    • descriptorId

      нить

Возврат

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

    Хром 91+

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

createService()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

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

Параметры

  • услуга

    Услуга

    Услуга по созданию.

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

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

    Параметр callback выглядит так: 

    (serviceId: string) => void

    • идентификатор_службы

      нить

Возврат

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

    Хром 91+

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

disconnect()

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

getCharacteristic()

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Characteristic) => void

Возврат

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

    Хром 91+

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

getCharacteristics()

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

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Characteristic[]) => void

Возврат

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

    Хром 91+

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

getDescriptor()

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

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

Параметры

  • descriptorId

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Descriptor) => void

Возврат

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

    Хром 91+

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

getDescriptors()

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Descriptor[]) => void

Возврат

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

    Хром 91+

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

getIncludedServices()

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

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Service[]) => void

Возврат

  • Обещание< Услуга []>

    Хром 91+

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

getService()

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

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Service) => void

Возврат

  • Обещание< Услуга >

    Хром 91+

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

getServices()

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

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Service[]) => void

Возврат

  • Обещание< Услуга []>

    Хром 91+

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

notifyCharacteristicValueChanged()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

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

Параметры

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

    нить

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

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

    Уведомление

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

readCharacteristicValue()

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Characteristic) => void

Возврат

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

    Хром 91+

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

readDescriptorValue()

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

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

Параметры

  • descriptorId

    нить

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

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

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

    Параметр callback выглядит так: 

    (result: Descriptor) => void

Возврат

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

    Хром 91+

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

registerAdvertisement()

Обещание 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 с низким энергопотреблением).

Параметры

  • реклама

    Реклама

    Реклама для рекламы.

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

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

    Параметр callback выглядит так: 

    (advertisementId: number) => void

    • рекламный ID

      число

Возврат

  • Обещание<номер>

    Хром 91+

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

registerService()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

removeService()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

resetAdvertising()

Обещание Chrome 61+
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

Параметры

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

sendRequestResponse()

Хром 52+
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

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

Параметры

  • ответ

    Ответ

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

setAdvertisingInterval()

Обещание Chrome 55+
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

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

Параметры

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

    число

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

  • maxInterval

    число

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

startCharacteristicNotifications()

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

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

Параметры

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

    нить

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

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

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

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

stopCharacteristicNotifications()

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

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

Параметры

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

    нить

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

unregisterAdvertisement()

Обещание Chrome 47+
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

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

Параметры

  • рекламный ID

    число

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

unregisterService()

Обещание Chrome 52+
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

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

Параметры

  • идентификатор_службы

    нить

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

writeCharacteristicValue()

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

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

Параметры

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

    нить

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

  • ценить

    ArrayBuffer

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

writeDescriptorValue()

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

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

Параметры

  • descriptorId

    нить

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

  • ценить

    ArrayBuffer

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

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

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

    Параметр callback выглядит так: 

    () => void

Возврат

  • Обещание<void>

    Хром 91+

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

События

onCharacteristicReadRequest

Хром 52+
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

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

Параметры

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

    функция

    Параметр callback выглядит так: 

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

    • запрос

      Запрос

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

      нить

onCharacteristicValueChanged

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

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

Параметры

onCharacteristicWriteRequest

Хром 52+
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

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

Параметры

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

    функция

    Параметр callback выглядит так: 

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

    • запрос

      Запрос

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

      нить

onDescriptorReadRequest

Хром 52+
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

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

Параметры

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

    функция

    Параметр callback выглядит так: 

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

onDescriptorValueChanged

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

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

Параметры

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

    функция

    Параметр callback выглядит так: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Хром 52+
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

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

Параметры

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

    функция

    Параметр callback выглядит так: 

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

onServiceAdded

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

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

Параметры

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

    функция

    Параметр 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