chrome.bluetooth

Opis

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

Plik manifestu

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

"bluetooth"

Typy

AdapterState

Właściwości

  • adres

    ciąg znaków

    Adres adaptera w formacie „XX:XX:XX:XX:XX:XX”.

  • dostępne

    wartość logiczna

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

  • odkrywanie

    wartość logiczna

    Wskazuje, czy obecnie adapter jest wykrywany.

  • nazwa

    ciąg znaków

    Czytelna dla człowieka nazwa adaptera.

  • zasilanie

    wartość logiczna

    Wskazuje, czy zasilacz jest naładowany.

BluetoothFilter

Chrome w wersji 67 lub nowszej .

Właściwości

  • filterType

    Opcjonalny FilterType

    Typ filtra, który ma być zastosowany do listy urządzeń. Domyślna wartość to wszystko.

  • limit

    liczba opcjonalnie

    Maksymalna liczba urządzeń Bluetooth do zwrócenia. Jeśli nie określono limitu, wartość domyślna to 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

    liczba opcjonalnie

    Chrome w wersji 77 lub nowszej .

    Pozostała bateria urządzenia.

  • z możliwością połączenia

    Wartość logiczna opcjonalna

    Chrome w wersji 48 lub nowszej, .

    Wskazuje, czy urządzenie można połączyć.

  • Połączono

    Wartość logiczna opcjonalna

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

  • z przesiadką

    Wartość logiczna opcjonalna

    Chrome w wersji 48 lub nowszej, .

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

  • deviceClass

    liczba opcjonalnie

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

  • deviceId

    liczba opcjonalnie

  • inquiryRssi

    liczba opcjonalnie

    Chrome w wersji 44 lub nowszej .

    Siła sygnału odbieranego (w dBm). To pole jest dostępne i prawidłowe tylko podczas wykrywania. Poza wykrywaniem jego wartość nie jest określona.

  • inquiryTxPower

    liczba opcjonalnie

    Chrome w wersji 44 lub nowszej .

    Poziom mocy przesyłanej energii. To pole jest dostępne tylko w przypadku urządzeń LE, które zawierają to pole w AD. Są dostępne i ważne tylko podczas odkrywania.

  • nazwa

    ciąg znaków opcjonalny

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

  • sparowano

    Wartość logiczna opcjonalna

    Wskazuje, czy urządzenie jest sparowane z systemem.

  • productId

    liczba opcjonalnie

  • transport

    Opcjonalny transport

    Chrome w wersji 76 i nowszych .

    Typ transportu urządzenia Bluetooth.

  • typ

    Opcjonalne DeviceType

    Typ urządzenia, jeśli Chrome go rozpozna. Wartość ta jest uzyskiwana z pola deviceClass i przedstawia tylko niewielką część możliwych typów urządzeń. W razie wątpliwości zalecamy bezpośrednio użycie 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 pochodzi z danych EIR i tabel SDP. W przypadku urządzeń Low Energy ta lista pochodzi z usług podstawowych AD i GATT. W przypadku urządzeń w trybie podwójnym te dane można uzyskać z obu trybów.

  • vendorId

    liczba opcjonalnie

  • vendorIdSource

    Opcjonalne VendorIdSource

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

DeviceType

Typowe typy urządzeń rozpoznawane przez Chrome.

Typ wyliczeniowy

"komputer"

"phone"

"modem"

"audio"

"carAudio"

"video"

"peryferal"

"joystick"

"gamepad"

"keyboard"

"mysz"

"tablet"

"keyboardMouseCombo"

FilterType

Chrome w wersji 67 lub nowszej .

Typy filtrowania urządzeń Bluetooth.

Typ wyliczeniowy

"all"

"znane"

Transport

Chrome w wersji 76 i nowszych .

Rodzaj transportu urządzenia Bluetooth.

Typ wyliczeniowy

„nieprawidłowy”

"klasyczny"

"le"

"dual"

VendorIdSource

Urzędy alokacji na potrzeby identyfikatorów dostawców.

Typ wyliczeniowy

"bluetooth"

"usb"

Metody

getAdapterState()

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

Uzyskaj informacje o adapcie Bluetooth.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Obiekt zawierający informacje o adapterze.

Zwroty

  • Promise<AdapterState>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getDevice()

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

Uzyskanie informacji o urządzeniu Bluetooth znanym w systemie.

Parametry

  • deviceAddress

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (deviceInfo: Device) => void

    • deviceInfo

      Urządzenie

      Obiekt zawierający informacje o urządzeniu.

Zwroty

  • Promise<Device>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getDevices()

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

Uzyskaj listę urządzeń Bluetooth znanych w systemie, w tym urządzenia sparowane i ostatnio wykryte.

Parametry

  • filtr

    Opcjonalny BluetoothFilter

    Chrome w wersji 67 lub nowszej .

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (deviceInfos: Device[]) => void

    • deviceInfos

      Urządzenie[]

      Tablica obiektów z informacjami o urządzeniu.

Zwroty

  • Obietnica<Urządzenie[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

startDiscovery()

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

Rozpocznij odkrywanie. Nowo wykryte urządzenia będą zwracane w ramach zdarzenia onDeviceProducts. Wykryte wcześniej urządzenia, które są już znane z adaptera, należy uzyskać za pomocą metody getdevices i będą aktualizowane tylko za pomocą zdarzenia onDeviceChanged, jeśli zmienią się informacje o nich.

Wykrywanie nie rozpocznie się, jeśli ta aplikacja wywołała już funkcję startDiscovery. Odkrywanie może wymagać dużych nakładów zasobów: funkcja stopDiscovery należy wywołać jak najszybciej.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

stopDiscovery()

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

Zatrzymaj wykrywanie.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onAdapterStateChanged

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

Uruchamiane po zmianie stanu adaptera Bluetooth.

Parametry

onDeviceAdded

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

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (device: Device) => void

onDeviceChanged

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

Uruchamiane po zmianie informacji o znanym urządzeniu Bluetooth.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (device: Device) => void

onDeviceRemoved

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

Uruchamiane, gdy wykryte wcześniej urządzenie Bluetooth było poza zasięgiem na wystarczająco długo, aby zostało ponownie uznane za niedostępne, oraz gdy sparowane urządzenie zostało usunięte.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (device: Device) => void