хром.Bluetooth

Описание

Используйте API chrome.bluetooth для подключения к устройству Bluetooth. Все функции сообщают об ошибках через chrome.runtime.lastError.

Манифест

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

"bluetooth"

Типы

AdapterState

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

  • адрес

    нить

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

  • доступный

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

    Указывает, доступен ли адаптер (т. е. включен).

  • обнаружение

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

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

  • имя

    нить

    Понятное для человека имя адаптера.

  • питание

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

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

BluetoothFilter

Хром 67+

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

  • Тип фильтра

    Тип фильтра необязательно

    Тип фильтра, применяемого к списку устройств. По умолчанию все.

  • предел

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

    Максимальное количество возвращаемых устройств Bluetooth. По умолчанию — 0 (без ограничений), если не указано.

Device

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

  • адрес

    нить

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

  • батарея в процентах

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

    Хром 77+

    Оставшийся аккумулятор устройства.

  • подключаемый

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

    Хром 48+

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

  • подключен

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

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

  • подключение

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

    Хром 48+

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

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

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

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

  • идентификатор устройства

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

  • запросRssi

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

    Хром 44+

    Уровень полученного сигнала в дБм. Это поле доступно и действительно только во время обнаружения. За пределами открытия его значение не указано.

  • запросTxPower

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

    Хром 44+

    Уровень передаваемой мощности. Это поле доступно только для устройств LE, которые включают это поле в AD. Он доступен и действителен только во время обнаружения.

  • имя

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

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

  • парный

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

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

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

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

  • транспорт

    Транспорт по желанию

    Хром 76+

    Тип транспорта устройства Bluetooth.

  • тип

    Тип устройства необязательно

    Тип устройства, если оно распознается Chrome. Он получается из поля deviceClass и представляет собой лишь небольшую часть возможных типов устройств. В случае сомнений вам следует использовать поле deviceClass напрямую.

  • uuids

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

    UUID протоколов, профилей и сервисов, рекламируемых устройством. Для классических устройств Bluetooth этот список получается из данных EIR и таблиц SDP. Для устройств с низким энергопотреблением этот список получен из первичных служб AD и GATT. Для двухрежимных устройств это можно получить обоими способами.

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

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

  • поставщикIdSource

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

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

DeviceType

Распространенные типы устройств, распознаваемые Chrome.

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

"компьютер"

"телефон"

"модем"

"аудио"

"автоаудио"

"видео"

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

"джойстик"

"геймпад"

"клавиатура"

"мышь"

"таблетка"

«Комбинация клавиатуры и мыши»

FilterType

Хром 67+

Типы фильтрации Bluetooth-устройств.

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

"все"

"известный"

Transport

Хром 76+

Тип транспорта устройства Bluetooth.

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

"неверный"

"классический"

"ле"

"двойной"

VendorIdSource

Полномочия по распределению идентификаторов поставщиков.

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

"Bluetooth"

"USB"

Методы

getAdapterState()

Обещать
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Получите информацию об адаптере Bluetooth.

Параметры

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

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

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

    (adapterInfo: AdapterState) => void

Возврат

  • Обещание < АдаптерСостояние >

    Хром 91+

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

getDevice()

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

Получите информацию об устройстве Bluetooth, известном системе.

Параметры

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

    нить

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

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

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

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

    (deviceInfo: Device) => void

    • информация об устройстве

      Устройство

      Объект, содержащий информацию об устройстве.

Возврат

  • Обещание < Устройство >

    Хром 91+

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

getDevices()

Обещать
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

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

Параметры

  • фильтр

    Bluetoothфильтр опционально

    Хром 67+

    Некоторые критерии для фильтрации списка возвращенных устройств Bluetooth. Если фильтр не установлен или установлен на {} , возвращаемый список устройств будет содержать все устройства Bluetooth. На данный момент это поддерживается только в ChromeOS, для других платформ возвращается полный список.

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

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

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

    (deviceInfos: Device[]) => void

    • информация об устройстве

      Устройство []

      Массив объекта, содержащего информацию об устройстве.

Возврат

  • Обещание < Устройство []>

    Хром 91+

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

startDiscovery()

Обещать
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Начать открытие. Недавно обнаруженные устройства будут возвращены через событие onDeviceAdded. Ранее обнаруженные устройства, уже известные адаптеру, должны быть получены с помощью getDevices и будут обновлены с помощью события onDeviceChanged только в случае изменения информации о них.

Discovery не запустится, если это приложение уже вызвало startDiscovery. Обнаружение может быть ресурсоемким: метод stopDiscovery следует вызывать как можно скорее.

Параметры

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

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

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

    () => void

Возврат

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

    Хром 91+

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

stopDiscovery()

Обещать
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Остановите открытие.

Параметры

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

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

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

    () => void

Возврат

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

    Хром 91+

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

События

onAdapterStateChanged

chrome.bluetooth.onAdapterStateChanged.addListener(
  callback: function,
)

Срабатывает при изменении состояния адаптера Bluetooth.

Параметры

onDeviceAdded

chrome.bluetooth.onDeviceAdded.addListener(
  callback: function,
)

Запускается, когда доступна информация о новом устройстве Bluetooth.

Параметры

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

    функция

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

    (device: Device) => void

onDeviceChanged

chrome.bluetooth.onDeviceChanged.addListener(
  callback: function,
)

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

Параметры

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

    функция

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

    (device: Device) => void

onDeviceRemoved

chrome.bluetooth.onDeviceRemoved.addListener(
  callback: function,
)

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

Параметры

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

    функция

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

    (device: Device) => void