chrome.bluetooth

Opis

Aby połączyć się z urządzeniem Bluetooth, użyj interfejsu API chrome.bluetooth. Wszystkie funkcje zgłaszają błędy za pomocą chrome.runtime.lastError.

Plik manifestu

Aby korzystać z tego interfejsu API, musisz zadeklarować te klucze w pliku manifestu.

"bluetooth"

Typy

AdapterState

Właściwości

  • adres

    ciąg znaków

    Adres karty sieciowej w formacie „XX:XX:XX:XX:XX:XX”.

  • dostępne

    wartość logiczna

    Wskazuje, czy adapter jest dostępny (czyli włączony).

  • odkrywanie

    wartość logiczna

    Wskazuje, czy adapter jest obecnie w procesie wykrywania.

  • nazwa

    ciąg znaków

    Czytelna nazwa karty.

  • napędzany

    wartość logiczna

    Wskazuje, czy adapter jest zasilany.

BluetoothFilter

Chrome 67 lub nowszy

Właściwości

  • filterType

    FilterType opcjonalny

    Typ filtra, który ma być zastosowany do listy urządzeń. Wartość domyślna to „all” (wszystko).

  • limit

    number opcjonalny

    Maksymalna liczba urządzeń Bluetooth do zwrócenia. Jeśli nie zostanie podana wartość, domyślnie zostanie ustawiona wartość 0 (bez limitu).

Device

Właściwości

  • adres

    ciąg znaków

    Adres urządzenia w formacie „XX:XX:XX:XX:XX:XX”.

  • batteryPercentage

    number opcjonalny

    Chrome 77 lub nowszy

    Pozostały poziom naładowania baterii urządzenia.

  • łączyć

    wartość logiczna opcjonalna

    Chrome 48+

    Wskazuje, czy urządzenie jest dostępne do połączenia.

  • Połączono

    wartość logiczna opcjonalna

    Wskazuje, czy urządzenie jest obecnie połączone z systemem.

  • z przesiadką

    wartość logiczna opcjonalna

    Chrome 48+

    Wskazuje, czy urządzenie jest obecnie połączone z systemem.

  • deviceClass

    number opcjonalny

    Klasa urządzenia, pole bitowe zdefiniowane przez http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.

  • deviceId

    number opcjonalny

  • inquiryRssi

    number opcjonalny

    Chrome 44 lub nowszy

    Siła odbieranego sygnału (dBm). To pole jest dostępne i ważne tylko podczas tworzenia. Poza fazą odkrywania nie jest ona określana.

  • inquiryTxPower

    number opcjonalny

    Chrome 44 lub nowszy

    Przesyłany poziom mocy. To pole jest dostępne tylko w przypadku urządzeń LE, które zawierają to pole w AD. Jest ona dostępna i ważna tylko podczas tworzenia.

  • nazwa

    ciąg znaków opcjonalny

    Czytelna nazwa urządzenia.

  • sparowano

    wartość logiczna opcjonalna

    Wskazuje, czy urządzenie jest sparowane z systemem.

  • productId

    number opcjonalny

  • transport

    Transport opcjonalny

    Chrome 76 lub nowszy

    Typ transportu urządzenia Bluetooth.

  • typ

    DeviceType opcjonalnie

    Typ urządzenia, jeśli jest rozpoznawany przez Chrome. Wartość ta jest uzyskiwana z pola deviceClass i reprezentuje tylko niewielką część możliwych typów urządzeń. W razie wątpliwości użyj bezpośrednio pola deviceClass.

  • uuids

    string[] opcjonalnie

    identyfikatory UUID protokołów, profili i usług reklamowanych przez urządzenie; W przypadku klasycznych urządzeń Bluetooth ta lista jest tworzona na podstawie danych EIR i tablic SDP. W przypadku urządzeń Low Energy ta lista jest pobierana z usług AD i GATT. W przypadku urządzeń obsługujących dwa tryby można uzyskać te informacje z obu.

  • vendorId

    number opcjonalny

  • vendorIdSource

    VendorIdSource opcjonalny

    Rekord identyfikatora urządzenia, jeśli jest dostępny.

DeviceType

Typy urządzeń rozpoznawane przez Chrome.

Typ wyliczeniowy

"computer"

„phone”

"modem"

„audio”

"carAudio"

"video"

„peripheral”

„joystick”

„gamepad”

"keyboard"

"mouse"

„tablet”

"keyboardMouseCombo"

FilterType

Chrome 67 lub nowszy

Typy filtrów urządzeń Bluetooth.

Typ wyliczeniowy

„all”

„znany”

Transport

Chrome 76 lub nowszy

Typ transportu urządzenia Bluetooth.

Typ wyliczeniowy

"invalid"

„classic”

"le"

„dual”

VendorIdSource

Uprawnienia do przydzielania identyfikatorów dostawcy.

Typ wyliczeniowy

"bluetooth"

"usb"

Metody

getAdapterState()

Obietnice 
chrome.bluetooth.getAdapterState(
  callback?: function,
)

Informacje o adapterze Bluetooth.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Obiekt zawierający informacje o adapterze.

Zwroty

  • Promise<AdapterState>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getDevice()

Obietnice 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
)

Pobieranie informacji o urządzeniu Bluetooth znanym systemowi.

Parametry

  • deviceAddress

    ciąg znaków

    Adres urządzenia do pobrania.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (deviceInfo: Device) => void

    • deviceInfo

      Urządzenie

      Obiekt zawierający informacje o urządzeniu.

Zwroty

  • Obietnice<Urządzenie>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getDevices()

Obietnice 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
)

Pobiera listę urządzeń Bluetooth znanych systemowi, w tym sparowanych i niedawno wykrytych.

Parametry

  • filtr

    BluetoothFilter opcjonalnie

    Chrome 67 lub nowszy

    kryteria filtrowania listy zwróconych urządzeń Bluetooth; Jeśli filtr nie jest ustawiony lub ma wartość {}, zwrócona lista urządzeń będzie zawierać wszystkie urządzenia Bluetooth. Obecnie ta funkcja jest obsługiwana tylko w ChromeOS. W przypadku innych platform zwracana jest pełna lista.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (deviceInfos: Device[]) => void

    • deviceInfos

      Urządzenie[]

      Tablica obiektów zawierających informacje o urządzeniu.

Zwroty

  • Obietnice<Device[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

startDiscovery()

Obietnice 
chrome.bluetooth.startDiscovery(
  callback?: function,
)

Rozpocznij odkrywanie. Nowo wykryte urządzenia będą zwracane za pomocą zdarzenia onDeviceAdded. Wcześniej wykryte urządzenia, które są już znane adapterowi, należy uzyskać za pomocą metody getDevices. Będą one aktualizowane tylko za pomocą zdarzenia onDeviceChanged, jeśli informacje o nich ulegną zmianie.

Wyszukiwanie nie rozpocznie się, jeśli ta aplikacja wywołała już funkcję startDiscovery. Wykrywanie może być czasochłonne: wywołanie stopDiscovery należy wykonać jak najszybciej.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

stopDiscovery()

Obietnice 
chrome.bluetooth.stopDiscovery(
  callback?: function,
)

Zatrzymaj odkrywanie.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onAdapterStateChanged

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

Wyzwalany, gdy zmienia się stan adaptera Bluetooth.

Parametry

onDeviceAdded

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

Wywoływane, gdy dostępne są informacje o nowym urządzeniu Bluetooth.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (device: Device) => void

onDeviceChanged

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

Wywoływany, gdy zmienią się informacje o znanym urządzeniu Bluetooth.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (device: Device) => void

onDeviceRemoved

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

Wywoływany, gdy wcześniej wykryte urządzenie Bluetooth znajduje się poza zasięgiem przez wystarczająco długi czas, aby uznać je za niedostępne, oraz gdy sparowane urządzenie zostanie usunięte.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (device: Device) => void