chrome.bluetoothLowEnergy

Описание

API chrome.bluetoothLowEnergy используется для связи с устройствами Bluetooth Smart (с низким энергопотреблением) с использованием общего профиля атрибутов (GATT) .

Манифест

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

"bluetooth"

Типы

Advertisement

Хром 47+

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

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

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

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

  • данные службы

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

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

  • сервисUuids

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

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

  • запрашивать Uuids

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

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

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

AdvertisementType

Хром 47+

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

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

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

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

Characteristic

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

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

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

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

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

    ХарактеристикаСвойство []

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

  • услуга

    Дополнительное обслуживание

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

  • uuid

    нить

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

  • ценить

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

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

CharacteristicProperty

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

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

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

"читать"

"запись без ответа"

"писать"

"уведомить"

"указывать"

"аутентифицированныеподписанные записи"

"расширенные свойства"

"надежная запись"

"записываемые вспомогательные устройства"

"зашифроватьЧтение"

"зашифроватьзапись"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

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

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

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

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

Descriptor

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

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

    Характеристика опционально

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

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

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

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

  • Хром 52+

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

  • uuid

    нить

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

  • ценить

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

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

DescriptorPermission

Хром 52+

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

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

"читать"

"писать"

"зашифрованноеЧтение"

"зашифрованная запись"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Хром 52+

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

  • адрес

    нить

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

  • класс устройства

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

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

  • имя

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

    Читабельное имя устройства.

ManufacturerData

Хром 47+

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

  • данные

    число[]

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

    число

Notification

Хром 52+

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

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

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

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

  • ценить

    МассивБуфер

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

NotificationProperties

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

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

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

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

Request

Хром 52+

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

  • устройство

    Устройство

    Устройство, отправляющее этот запрос.

  • идентификатор запроса

    число

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

  • ценить

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

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

Response

Хром 52+

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

  • isError

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

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

  • идентификатор запроса

    число

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

  • ценить

    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,
)

Устанавливает соединение между приложением и устройством с заданным адресом. Устройство может быть уже подключено и его службы 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,
)

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

Параметры

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

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

    Характеристика для создания.

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

    нить

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

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

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

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

    (characteristicId: string) => void

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

      нить

Возврат

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

    Хром 91+

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

createDescriptor()

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

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

Параметры

  • дескриптор

    Дескриптор

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

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

    нить

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

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

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

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

    (descriptorId: string) => void

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

      нить

Возврат

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

    Хром 91+

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

createService()

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

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

Параметры

  • услуга

    Услуга

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

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

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

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

    (serviceId: string) => void

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

      нить

Возврат

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

    Хром 91+

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

disconnect()

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

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

Параметры

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

    нить

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

getCharacteristic()

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

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

Параметры

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

    нить

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

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

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

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

    (result: Characteristic) => void

Возврат

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

    Хром 91+

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

getCharacteristics()

Обещать
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

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

Параметры

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

    нить

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

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

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

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

    (result: Characteristic[]) => void

Возврат

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

    Хром 91+

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

getDescriptor()

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

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

Параметры

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

    нить

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

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

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

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

    (result: Descriptor) => void

Возврат

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

    Хром 91+

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

getDescriptors()

Обещать
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

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

Параметры

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

    нить

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

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

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

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

    (result: Descriptor[]) => void

Возврат

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

    Хром 91+

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

getIncludedServices()

Обещать
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Получите список услуг GATT, включенных в данную услугу.

Параметры

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

    нить

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

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

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

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

    (result: Service[]) => void

Возврат

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

    Хром 91+

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

getService()

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

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

Параметры

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

    нить

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

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

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

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

    (result: Service) => void

Возврат

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

    Хром 91+

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

getServices()

Обещать
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

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

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

Параметры

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

    нить

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

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

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

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

    (result: Service[]) => void

Возврат

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

    Хром 91+

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

notifyCharacteristicValueChanged()

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

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

Параметры

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

    нить

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

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

    Уведомление

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

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

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

    () => void

Возврат

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

    Хром 91+

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

readCharacteristicValue()

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

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

Параметры

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

    нить

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

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

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

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

    (result: Characteristic) => void

Возврат

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

    Хром 91+

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

readDescriptorValue()

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

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

Параметры

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

    нить

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

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

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

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

    (result: Descriptor) => void

Возврат

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

    Хром 91+

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

registerAdvertisement()

Обещание Chrome 47+
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

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

Параметры

  • реклама

    Реклама

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

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

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

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

    (advertisementId: number) => void

    • рекламный идентификатор

      число

Возврат

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

    Хром 91+

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

registerService()

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

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

Параметры

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

    нить

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

removeService()

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

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

Параметры

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

    нить

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

resetAdvertising()

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

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

Параметры

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

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

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

    () => void

Возврат

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

    Хром 91+

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

sendRequestResponse()

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

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

Параметры

  • ответ

    Ответ

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

setAdvertisingInterval()

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

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

Параметры

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

    число

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

  • МаксИнтервал

    число

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

startCharacteristicNotifications()

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

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

Параметры

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

    нить

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

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

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

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

stopCharacteristicNotifications()

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

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

Параметры

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

    нить

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

unregisterAdvertisement()

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

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

Параметры

  • рекламный идентификатор

    число

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

unregisterService()

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

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

Параметры

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

    нить

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

writeCharacteristicValue()

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

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

Параметры

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

    нить

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

  • ценить

    МассивБуфер

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

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

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

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

    () => void

Возврат

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

    Хром 91+

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

writeDescriptorValue()

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

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

Параметры

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

    нить

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

  • ценить

    МассивБуфер

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

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

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

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

    • запрос

      Запрос

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

      нить

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

    • запрос

      Запрос

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

      нить

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