хром.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+

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

  • deviceClass

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

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

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

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

  • запросRssi

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

    Хром 44+

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

  • запросTxPower

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

    Хром 44+

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

  • имя

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

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

  • в паре

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

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

  • productId

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

  • транспорт

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

    Хром 76+

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

  • тип

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

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

  • uuids

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

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

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

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

  • vendorIdSource

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

    Запись идентификатора устройства (если доступна).

DeviceType

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

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

"компьютер"

"телефон"

"модем"

"аудио"

"carAudio"

"видео"

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

"джойстик"

"геймпад"

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

"мышь"

"таблетка"

"keyboardMouseCombo"

FilterType

Хром 67+

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

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

"все"

"известный"

Transport

Хром 76+

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

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

"неверный"

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

"ле"

"двойной"

VendorIdSource

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

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

"Bluetooth"

"USB"

Методы

getAdapterState()

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

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

Параметры

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

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

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

    (adapterInfo: AdapterState) => void

Возврат

  • Хром 91+

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

getDevice()

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

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

Параметры

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

    нить

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

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

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

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

    (deviceInfo: Device) => void

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

      Устройство

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

Возврат

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

    Хром 91+

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

getDevices()

Обещать
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

Параметры

  • фильтр

    BluetoothFilter (опционально)

    Хром 67+

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

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

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

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

    (deviceInfos: Device[]) => void

    • deviceInfos

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

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

Возврат

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

    Хром 91+

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

startDiscovery()

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

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

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

Параметры

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

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

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

    () => void

Возврат

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

    Хром 91+

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

stopDiscovery()

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

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

Параметры

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

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

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