chrome.bluetooth

Opis

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

Dostępność

Tylko w systemie ChromeOS

Plik manifestu

Aby używać tego interfejsu API, musisz zadeklarować te klucze w pliku manifestu.

"bluetooth"

Typy

AdapterState

Właściwości

  • adres

    tekst

    Adres adaptera 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 wykrywany.

  • nazwa

    tekst

    Zrozumiała dla człowieka nazwa adaptera.

  • powered

    wartość logiczna

    Wskazuje, czy adapter jest zasilany.

BluetoothFilter

Chrome 67 lub nowsza wersja

Właściwości

  • filterType

    FilterType opcjonalny

    Typ filtra, który ma zostać zastosowany do listy urządzeń. Wartość domyślna to wszystkie.

  • limit

    number optional

    Maksymalna liczba urządzeń Bluetooth do zwrócenia. Jeśli nie zostanie określona, domyślna wartość to 0 (brak limitu).

Device

Właściwości

  • adres

    tekst

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

  • batteryPercentage

    number optional

    Chrome 77 lub nowsza wersja

    pozostały poziom naładowania baterii urządzenia;

  • connectable

    boolean opcjonalne

    Chrome 48 lub nowsza wersja

    Wskazuje, czy z urządzeniem można się połączyć.

  • Połączono

    boolean opcjonalne

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

  • z przesiadką

    boolean opcjonalne

    Chrome 48 lub nowsza wersja

    Wskazuje, czy urządzenie łączy się obecnie z systemem.

  • deviceClass

    number optional

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

  • deviceId

    number optional

  • inquiryRssi

    number optional

    Chrome 44 lub nowsza wersja

    Siła odbieranego sygnału w dBm. To pole jest dostępne i ważne tylko podczas wykrywania. Poza wykrywaniem jej wartość nie jest określona.

  • inquiryTxPower

    number optional

    Chrome 44 lub nowsza wersja

    Poziom mocy transmisji. To pole jest dostępne tylko w przypadku urządzeń LE, które zawierają je w AD. Jest on dostępny i ważny tylko podczas wykrywania.

  • nazwa

    ciąg znaków opcjonalny

    Zrozumiała dla człowieka nazwa urządzenia.

  • sparowano

    boolean opcjonalne

    Wskazuje, czy urządzenie jest sparowane z systemem.

  • productId

    number optional

  • transport

    Transport opcjonalny

    Chrome 76 lub nowsza wersja

    Typ transportu urządzenia Bluetooth.

  • typ

    DeviceType opcjonalny

    Typ urządzenia, jeśli został rozpoznany przez Chrome. Te informacje pochodzą z pola deviceClass i reprezentują tylko niewielką część możliwych typów urządzeń. W razie wątpliwości użyj bezpośrednio pola deviceClass.

  • uuids

    string[] opcjonalne

    Identyfikatory UUID protokołów, profili i usług rozgłaszanych przez urządzenie. W przypadku klasycznych urządzeń Bluetooth ta lista jest uzyskiwana z danych EIR i tabel SDP. W przypadku urządzeń Low Energy ta lista jest uzyskiwana z usług podstawowych AD i GATT. W przypadku urządzeń z trybem dualnym można go uzyskać z obu.

  • vendorId

    number optional

  • vendorIdSource

    VendorIdSource opcjonalny

    Identyfikator urządzenia (jeśli jest dostępny).

DeviceType

Typowe rodzaje urządzeń rozpoznawane przez Chrome.

Typ wyliczeniowy

"computer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peripheral"

"joystick"

"gamepad"

"keyboard"

"mouse"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome 67 lub nowsza wersja

Typy do filtrowania urządzeń Bluetooth.

Typ wyliczeniowy

"all"

"known"

Transport

Chrome 76 lub nowsza wersja

Typ transportu urządzenia Bluetooth.

Typ wyliczeniowy

"invalid"

"classic"

"le"

"dual"

VendorIdSource

Urzędy przydzielające identyfikatory dostawców.

Typ wyliczeniowy

"bluetooth"

"usb"

Metody

getAdapterState()

Obietnica 
chrome.bluetooth.getAdapterState(
  callback?: function,
): Promise<AdapterState>

Uzyskaj informacje o adapterze Bluetooth.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Obiekt zawierający informacje o adapterze.

Zwroty

  • Promise<AdapterState>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getDevice()

Obietnica 
chrome.bluetooth.getDevice(
  deviceAddress: string,
  callback?: function,
): Promise<Device>

Uzyskaj informacje o urządzeniu Bluetooth znanym systemowi.

Parametry

  • deviceAddress

    tekst

    Adres urządzenia, które chcesz pobrać.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (deviceInfo: Device) => void

    • deviceInfo

      Urządzenie

      Obiekt zawierający informacje o urządzeniu.

Zwroty

  • Promise<Device>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getDevices()

Obietnica 
chrome.bluetooth.getDevices(
  filter?: BluetoothFilter,
  callback?: function,
): Promise<Device[]>

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

Parametry

  • filtr

    BluetoothFilter opcjonalny

    Chrome 67 lub nowsza wersja

    Kryteria filtrowania listy zwróconych urządzeń Bluetooth. Jeśli filtr jest nieskonfigurowany lub ma wartość {}, zwrócona lista urządzeń będzie zawierać wszystkie urządzenia Bluetooth. Obecnie jest to obsługiwane tylko w ChromeOS. Na innych platformach zwracana jest pełna lista.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (deviceInfos: Device[]) => void

    • deviceInfos

      Device[]

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

Zwroty

  • Promise<Device[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

startDiscovery()

Obietnica 
chrome.bluetooth.startDiscovery(
  callback?: function,
): Promise<void>

Uruchom wykrywanie. Nowo wykryte urządzenia zostaną zwrócone przez zdarzenie onDeviceAdded. Wcześniej wykryte urządzenia, które są już znane adapterowi, muszą zostać pobrane za pomocą metody getDevices i będą aktualizowane za pomocą zdarzenia onDeviceChanged tylko wtedy, gdy informacje o nich ulegną zmianie.

Wykrywanie nie rozpocznie się, jeśli ta aplikacja wywołała już funkcję startDiscovery. Wykrywanie może wymagać dużej ilości zasobów: należy jak najszybciej wywołać metodę stopDiscovery.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

stopDiscovery()

Obietnica 
chrome.bluetooth.stopDiscovery(
  callback?: function,
): Promise<void>

Zatrzymaj wykrywanie.

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onAdapterStateChanged

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

Uruchamiane, gdy zmienia się stan adaptera Bluetooth.

Parametry

onDeviceAdded

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

Uruchamiane, gdy dostępne są informacje o nowym urządzeniu Bluetooth.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (device: Device) => void

onDeviceChanged

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

Uruchamiane, gdy zmienią się informacje o znanym urządzeniu Bluetooth.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (device: Device) => void

onDeviceRemoved

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

Uruchamiane, gdy urządzenie Bluetooth, które zostało wcześniej wykryte, było poza zasięgiem przez wystarczająco długi czas, aby można je było uznać za niedostępne, oraz gdy sparowane urządzenie zostanie usunięte.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (device: Device) => void