chrome.bluetooth

Opis

Użyj interfejsu chrome.bluetooth API, aby połączyć się z urządzeniem 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 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 obecnie wykrywa.

  • nazwa

    ciąg znaków

    Zrozumiała dla człowieka nazwa karty.

  • zasilany

    Wartość logiczna

    Wskazuje, czy zasilacz jest podłączony do zasilania.

BluetoothFilter

Chrome 67 lub nowsza

Właściwości

  • filterType

    FilterType opcjonalny

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

  • limit

    number opcjonalny

    Maksymalna liczba urządzeń Bluetooth do zwrócenia. Jeśli nie zostanie podana, domyślnie wynosi 0 (brak 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 nowsza

    Pozostały poziom baterii urządzenia.

  • możliwość połączenia,

    wartość logiczna opcjonalna

    Chrome 48 lub nowsza

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

  • Podłączono

    wartość logiczna opcjonalna

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

  • z przesiadką

    wartość logiczna opcjonalna

    Chrome 48 lub nowsza

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

  • deviceClass

    number opcjonalny

    Klasa urządzenia, pole bitowe zdefiniowane na stronie 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 w dBm. To pole jest dostępne i ważne tylko podczas wykrywania. Poza procesem wykrywania jego wartość nie jest określona.

  • inquiryTxPower

    number opcjonalny

    Chrome 44 lub nowszy

    Poziom mocy transmisji. 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 wykrywania.

  • nazwa

    string opcjonalny

    Czytelna nazwa urządzenia.

  • sparowane,

    wartość logiczna opcjonalna

    Wskazuje, czy urządzenie jest sparowane z systemem.

  • productId

    number opcjonalny

  • transport

    Transport opcjonalny

    Chrome w wersji 76 lub nowszej

    Rodzaj transportu urządzenia Bluetooth.

  • typ

    DeviceType opcjonalny

    Typ urządzenia, jeśli jest rozpoznawany przez Chrome. Pochodzi ona z pola deviceClass i stanowi tylko niewielki odsetek 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 reklamowanych przez urządzenie. W przypadku urządzeń Bluetooth Classic lista jest pobierana z danych EIR i tabel SDP. W przypadku urządzeń o niskim zużyciu energii ta lista jest pobierana z usług podstawowych AD i GATT. W przypadku urządzeń dwuzakresowych można je uzyskać z obu zakresów.

  • vendorId

    number opcjonalny

  • vendorIdSource

    VendorIdSource opcjonalny

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

DeviceType

Typowe typy urządzeń rozpoznawane przez Chrome.

Typ wyliczeniowy

„computer”

„phone”

„modem”

„audio”

„carAudio”

„video”

„peryferyjne”

„joystick”

„gamepad”

„keyboard”

„mouse”

„tablet”

"keyboardMouseCombo"

FilterType

Chrome 67 lub nowsza

Typy filtrowania urządzeń Bluetooth.

Typ wyliczeniowy

„all”

„znane”

Transport

Chrome w wersji 76 lub nowszej

Rodzaj transportu urządzenia Bluetooth.

Typ wyliczeniowy

„invalid”

„classic”

"le"

„dual”

VendorIdSource

Organy 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

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (adapterInfo: AdapterState) => void

    • adapterInfo

      AdapterState

      Obiekt zawierający informacje o adapterze.

Zwroty

  • Promise<AdapterState>

    Chrome 91 lub nowsza

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

getDevice()

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

Pobieranie informacji o urządzeniu Bluetooth znanym systemowi.

Parametry

  • deviceAddress

    ciąg znaków

    Adres urządzenia, który chcesz uzyskać.

  • callback

    funkcja opcjonalna

    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

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

getDevices()

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

Pobieranie listy urządzeń Bluetooth znanych systemowi, w tym sparowanych i ostatnio wykrytych.

Parametry

  • filtr

    BluetoothFilter opcjonalny

    Chrome 67 lub nowsza

    Kryteria filtrowania listy zwróconych urządzeń Bluetooth. Jeśli filtr nie jest skonfigurowany 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.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (deviceInfos: Device[]) => void

    • deviceInfos

      Urządzenie[]

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

Zwroty

  • Promise<Device[]>

    Chrome 91 lub nowsza

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

startDiscovery()

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

Rozpocznij wykrywanie. 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ą funkcji getDevices. Będą one aktualizowane tylko za pomocą zdarzenia onDeviceChanged, jeśli zmienią się informacje o nich.

Wykrywanie nie zostanie uruchomione, jeśli ta aplikacja wywołała już funkcję startDiscovery. Wykrywanie może zużywać dużo zasobów. Funkcję stopDiscovery należy wywołać jak najszybciej.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

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

stopDiscovery()

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

Zatrzymaj odkrywanie.

Parametry

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

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

Wydarzenia

onAdapterStateChanged

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

Wysyłane, gdy zmieni 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

  • callback

    funkcja

    Parametr callback wygląda tak:

    (device: Device) => void

onDeviceChanged

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

Wywoływane, 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,
)

Wydarzenie wywoływane, gdy urządzenie Bluetooth, które zostało wcześniej wykryte, jest poza zasięgiem na tyle długo, że można je uznać za ponownie niedostępne, oraz gdy sparowane urządzenie zostanie usunięte.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (device: Device) => void