chrome.bluetooth

Opis

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

Plik manifestu

Aby można było używać tego interfejsu API, następujące klucze muszą być zadeklarowane w pliku manifestu.

"bluetooth"

Typy

AdapterState

Właściwości

  • adres

    string,

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

  • dostępne

    boolean

    Wskazuje, czy przejściówka jest dostępna (tj. włączona).

  • odkrywanie

    boolean

    Wskazuje, czy adapter obecnie wykrywa adapter.

  • nazwa

    string,

    Czytelna dla człowieka nazwa adaptera.

  • zasilany

    boolean

    Wskazuje, czy ładowarka jest zasilana.

BluetoothFilter

Chrome 67 i nowsze wersje

Właściwości

  • filterType

    FilterType (Typ filtra) – opcjonalny

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

  • limit

    Liczba opcjonalnie

    Maksymalna liczba urządzeń bluetoth do zwrócenia. Jeśli nie określono inaczej, domyślna wartość to 0 (bez limitu).

Device

Właściwości

  • adres

    string,

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

  • batteryPercentage

    Liczba opcjonalnie

    Chrome 77 i nowsze wersje

    Pozostały poziom baterii urządzenia.

  • można połączyć

    wartość logiczna opcjonalna

    Chrome 48 i nowsze wersje

    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 48 i nowsze wersje

    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 44 i nowsze wersje

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

  • inquiryTxPower

    Liczba opcjonalnie

    Chrome 44 i nowsze wersje

    Poziom mocy przesyłanej. 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 wtedy, gdy jest wykrywana.

  • nazwa

    ciąg znaków opcjonalny

    Czytelna dla człowieka nazwa urządzenia.

  • sparowano

    wartość logiczna opcjonalna

    Wskazuje, czy urządzenie jest sparowane z systemem.

  • productId

    Liczba opcjonalnie

  • transport

    Transport opcjonalny

    Chrome 76 i nowsze wersje

    Typ transportu urządzenia Bluetooth.

  • typ

    Opcjonalny DeviceType

    Typ urządzenia, jeśli został rozpoznany przez Chrome. Wartość jest uzyskiwana z pola deviceClass i stanowi tylko mały ułamek możliwych typów urządzeń. W razie wątpliwości użyj bezpośrednio pola deviceClass.

  • UID

    string[] opcjonalny

    Identyfikatory UUID protokołów, profili i usług rozgłaszanych przez urządzenie. W przypadku klasycznych urządzeń Bluetooth ta lista jest pobierana z danych EIR i tabel SDP. W przypadku urządzeń energooszczędnych ta lista jest pobierana z usług podstawowych AD i GATT. W przypadku urządzeń działających w trybie podwójnym można to uzyskać od obydwu.

  • vendorId

    Liczba opcjonalnie

  • vendorIdSource

    VendorIdSource opcjonalnie

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

DeviceType

Typowe rodzaje urządzeń rozpoznawanych przez Chrome.

Enum

"modem"

"audio"

"carAudio"

"joystick"

"gamepad"

FilterType

Chrome 67 i nowsze wersje

Rodzaje filtrowania urządzeń Bluetooth.

Enum

Transport

Chrome 76 i nowsze wersje

Typ transportu urządzenia Bluetooth.

Enum

"le"

VendorIdSource

Organy alokacji identyfikatorów dostawców.

Enum

Metody

getAdapterState()

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

Uzyskaj informacje o przejściówce Bluetooth.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (adapterInfo: AdapterState)=>void

    • adapterInfo

      AdapterState

      Obiekt zawierający informacje o adapterze.

Akcje powrotne

  • Promise<AdapterState>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getDevice()

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

Uzyskaj informacje o urządzeniu Bluetooth znanym systemowi.

Parametry

  • deviceAddress

    string,

    Adres urządzenia, na które chcesz uzyskać dostęp.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (deviceInfo: Device)=>void

    • deviceInfo

      Urządzenie

      Obiekt zawierający informacje o urządzeniu.

Akcje powrotne

  • Obietnica<urządzenie>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

getDevices()

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

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

Parametry

  • filter

    BluetoothFilter – opcjonalny

    Chrome 67 i nowsze wersje

    Niektóre 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

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (deviceInfos: Device[])=>void

    • deviceInfos

      Urządzenie[]

      Tablica obiektów z informacjami o urządzeniu.

Akcje powrotne

  • Obietnica<urządzenie[]>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

startDiscovery()

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

Rozpocznij odkrywanie. Nowo wykryte urządzenia będą zwracane za pomocą zdarzenia onDevice added. Urządzenia wykryte wcześniej dla adaptera trzeba pobrać za pomocą polecenia getdevices. Zostaną one zaktualizowane za pomocą zdarzenia onDeviceChanged tylko wtedy, gdy ulegną zmianie informacje o nich.

Wykrywanie nie rozpocznie się, jeśli ta aplikacja już wywołała startDiscovery. Wykrywanie może wymagać znacznych zasobów – należy wywoływać funkcję stopDiscovery jak najszybciej.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.

stopDiscovery()

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

Zatrzymaj wykrywanie.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 urządzenie Bluetooth, które zostało wcześniej wykryte, było poza zasięgiem na tyle długo, by można było ponownie uznać je za niedostępne, oraz po usunięciu sparowanego urządzenia.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (device: Device)=>void