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
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ń Bluetooth 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 wersjePozostały poziom baterii urządzenia.
-
można połączyć
wartość logiczna opcjonalna
Chrome 48 i nowsze wersjeWskazuje, 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 wersjeWskazuje, 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 wersjeSił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 wersjePoziom 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 wersjeTyp transportu urządzenia Bluetooth.
-
Niestandardowy typ treści
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 poladeviceClass
. -
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.
Typ wyliczeniowy
"modem"
"audio"
"carAudio"
"joystick"
"gamepad"
FilterType
Rodzaje filtrowania urządzeń Bluetooth.
Typ wyliczeniowy
Transport
Typ transportu urządzenia Bluetooth.
Typ wyliczeniowy
"le"
VendorIdSource
Organy alokacji identyfikatorów dostawców.
Typ wyliczeniowy
Metody
getAdapterState()
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
Obiekt zawierający informacje o adapterze.
-
Zwroty
-
Promise<AdapterState>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getDevice()
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
Obiekt zawierający informacje o urządzeniu.
-
Zwroty
-
Obietnica<urządzenie>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
getDevices()
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 wersjeNiektó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
Tablica obiektów z informacjami o urządzeniu.
-
Zwroty
-
Obietnica<urządzenie[]>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
startDiscovery()
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
Zwroty
-
Promise<void>
Chrome 91 i nowsze wersjeObietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. Inne platformy muszą używać wywołań zwrotnych.
stopDiscovery()
chrome.bluetooth.stopDiscovery(
callback?: function,
)
Zatrzymaj wykrywanie.
Parametry
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Zwroty
-
Promise<void>
Chrome 91 i nowsze wersjeObietnice 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
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(state: AdapterState) => void
-
state
-
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
-
urządzenie
-
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
-
urządzenie
-
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
-
urządzenie
-