хром.Bluetooth

Описание

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

Доступность

Только для ChromeOS

Манифест

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

"bluetooth"

Типы

AdapterState

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

  • адрес

    нить

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

  • доступный

    логический

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

  • открытие

    логический

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

  • имя

    нить

    Удобочитаемое название адаптера.

  • с питанием

    логический

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

BluetoothFilter

Chrome 67+

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

  • filterType

    FilterType ( необязательный параметр)

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

  • лимит

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

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

Device

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

  • адрес

    нить

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

  • Процент заряда батареи

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

    Chrome 77+

    Оставшийся заряд батареи устройства.

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

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

    Chrome 48+

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

  • подключенный

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

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

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

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

    Chrome 48+

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

  • deviceClass

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

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

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

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

  • inquiryRssi

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

    Chrome 44+

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

  • inquiryTxPower

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

    Chrome 44+

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

  • имя

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

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

  • парный

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

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

  • продуктId

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

  • транспорт

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

    Chrome 76+

    Тип передачи данных устройства Bluetooth.

  • тип

    DeviceType ( необязательный параметр)

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

  • uuids

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

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

  • vendorId

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

  • vendorIdSource

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

    Идентификатор устройства (Device ID), если таковой имеется.

DeviceType

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

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

«компьютер»

"телефон"

"модем"

"аудио"

"carAudio"

"видео"

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

"джойстик"

"геймпад"

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

"мышь"

"планшет"

"keyboardMouseCombo"

FilterType

Chrome 67+

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

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

"все"

"известный"

Transport

Chrome 76+

Тип передачи данных устройства Bluetooth.

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

"неверный"

"классика"

"ле"

"двойной"

VendorIdSource

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

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

"Bluetooth"

"USB"

Методы

getAdapterState()

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

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

Параметры

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

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

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

    (adapterInfo: AdapterState) => void

    • адаптерИнформация

      AdapterState

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

Возвраты

  • Promise< AdapterState >

    Chrome 91+

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

getDevice()

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

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

Параметры

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

    нить

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

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

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

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

    (deviceInfo: Device) => void

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

      Устройство

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

Возвраты

  • Chrome 91+

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

getDevices()

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

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

Параметры

  • фильтр

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

    Chrome 67+

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

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

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

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

    (deviceInfos: Device[]) => void

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

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

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

Возвраты

  • Promise< Устройство []>

    Chrome 91+

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

startDiscovery()

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

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

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

Параметры

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

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

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

    () => void

Возвраты

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

    Chrome 91+

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

stopDiscovery()

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

Прекратите поиск.

Параметры

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

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

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

    () => void

Возвраты

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

    Chrome 91+

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

События

onAdapterStateChanged

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

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

Параметры

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

    функция

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

    (state: AdapterState) => void

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