Opis
Interfejs chrome.bluetoothLowEnergy
API służy do komunikacji z urządzeniami Bluetooth Smart (Low Energy) z wykorzystaniem profilu atrybutu ogólnego (GATT).
Plik manifestu
Aby można było używać tego interfejsu API, następujące klucze muszą być zadeklarowane w pliku manifestu.
"bluetooth"
Typy
Advertisement
Właściwości
-
manufacturerData
ManufacturerData[] opcjonalny
Lista danych producenta, które mają być uwzględnione w polach „Dane producenta” w danych reklam.
-
serviceData
ServiceData[] opcjonalny
Lista danych usługi, które mają zostać uwzględnione w polach „Dane usługi” danych reklamowych.
-
serviceUuids
string[] opcjonalny
Lista identyfikatorów UUID, które mają zostać uwzględnione w polu „UUID usługi” Danych reklamowych. Identyfikatory te mogą być w formacie 16-, 32- lub 128-bitowym.
-
solicitUuids
string[] opcjonalny
Lista identyfikatorów UUID, które mają zostać uwzględnione w polu „Poproś o identyfikatory UUID” Danych reklamowych. Identyfikatory te mogą być w formacie 16-, 32- lub 128-bitowym.
-
Typ reklamy.
AdvertisementType
Typ reklamy. Jeśli wybrana jest opcja „transmisja”, typ wysyłanej reklamy to ADV_NONCONN_IND, a urządzenie będzie transmitować z losowym adresem MAC. Jeśli ustawisz wartość „peryferyjne”, typem reklamy będzie ADV_IND lub ADV_SCAN_IND, a urządzenie będzie przesyłać z użyciem rzeczywistego adresu MAC adaptera Bluetooth.
Enum
Characteristic
Właściwości
-
instanceId
ciąg znaków opcjonalny
Zwraca identyfikator przypisany do tej cechy. Identyfikator instancji służy do rozróżniania cech urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator cech. Występuje, jeśli to wystąpienie reprezentuje cechę zdalną.
-
usługi
Właściwości tej cechy.
-
usługa
Usługa opcjonalnie
Usługa GATT, do której należy dana cecha.
-
uuid
string,
Identyfikator UUID cechy, np. 00002a37-0000-1000-8000-00805f9b34fb.
-
value
Tablica SlateBuffer opcjonalna
Aktualnie zapisana wartość cechy. Ta wartość jest aktualizowana, gdy wartość cechy zostanie odczytana lub zaktualizowana za pomocą powiadomienia lub wskaźnika.
CharacteristicProperty
Wartości reprezentujące możliwe właściwości cechy. Uprawnienia charakterystyczne są określane na podstawie tych właściwości. Zapoznaj się ze specyfikacją Bluetooth 4.x, aby poznać znaczenie poszczególnych usług.
Enum
"read"
"writeWithoutResponse"
"write"
"indicate"
"authenticatedSignedWrites"
"reliableWrite"
"writableAuxiliaries"
"encryptRead"
"encryptWrite"
"encryptAuthenticatedRead"
"encryptAuthenticatedWrite"
ConnectProperties
Właściwości
-
trwałe
boolean
Flaga z informacją, czy połączenie z urządzeniem jest otwarte po wyładowaniu strony zdarzenia aplikacji (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest
false.
.
Descriptor
Właściwości
-
charakterystyczne
Charakter opcjonalny
Charakterystyka GATT, do której należy ten deskryptor.
-
instanceId
ciąg znaków opcjonalny
Zwraca identyfikator przypisany do tego deskryptora. Identyfikator instancji służy do rozróżniania deskryptorów z urządzeń peryferyjnych o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator deskryptora. Występuje, jeśli to wystąpienie reprezentuje cechę zdalną.
-
uprawnieniaChrome 52 i nowsze wersje
Uprawnienia do tego deskryptora.
-
uuid
string,
Identyfikator UUID deskryptora cechy, np. 00002902-0000-1000-8000-00805f9b34fb.
-
value
Tablica SlateBuffer opcjonalna
Aktualnie przechowywana w pamięci podręcznej wartość deskryptora. Ta wartość jest aktualizowana po odczytaniu wartości deskryptora.
DescriptorPermission
Wartości reprezentujące możliwe uprawnienia dla deskryptora. Aby poznać znaczenie poszczególnych uprawnień, zapoznaj się ze specyfikacją Bluetootha 4.x.
Enum
"read"
"write"
"encryptedRead"
"encryptedWrite"
"encryptedAuthenticatedRead"
"encryptedAuthenticatedWrite"
Device
Właściwości
-
adres
string,
Adres urządzenia w formacie „XX:XX:XX:XX:XX:XX”.
-
deviceClass
Liczba opcjonalnie
Klasa urządzenia, pole bitowe zdefiniowane przez http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband.
-
nazwa
ciąg znaków opcjonalny
Czytelna dla człowieka nazwa urządzenia.
ManufacturerData
Właściwości
-
dane
liczba[]
-
id
Liczba
Notification
Właściwości
-
shouldIndicate
wartość logiczna opcjonalna
Opcjonalna flaga wysyłania wskaźnika zamiast powiadomienia.
-
value
ArrayBuffer
Nowa wartość cechy.
NotificationProperties
Właściwości
-
trwałe
boolean
Flaga określająca, czy aplikacja powinna otrzymywać powiadomienia po wyładowaniu strony zdarzenia z aplikacji (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest
false
.
Request
Właściwości
-
urządzenie
Urządzenie, z którego wysłano tę prośbę.
-
requestId
Liczba
Unikalny identyfikator żądania. Użyj tego identyfikatora, gdy odpowiadasz na to żądanie.
-
value
Tablica SlateBuffer opcjonalna
Wartość do zapisania (jeśli jest to żądanie zapisu).
Response
Właściwości
-
isError
boolean
Jeśli jest to odpowiedź o błędzie, pole musi mieć wartość prawda.
-
requestId
Liczba
Identyfikator żądania, na które jest odpowiedź.
-
value
Tablica SlateBuffer opcjonalna
Wartość odpowiedzi. Żądania zapisu i odpowiedzi o błędach będą ignorować ten parametr.
Service
Właściwości
-
deviceAddress
ciąg znaków opcjonalny
Adres zdalnego urządzenia peryferyjnego, do którego należy usługa GATT. Występuje, jeśli ta instancja reprezentuje usługę zdalną.
-
instanceId
ciąg znaków opcjonalny
Zwraca identyfikator przypisany do tej usługi. Identyfikator instancji służy do rozróżniania usług z urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator usługi. Występuje, jeśli ta instancja reprezentuje usługę zdalną.
-
isPrimary
boolean
Wskazuje, czy typ tej usługi jest główny czy dodatkowy.
-
uuid
string,
Identyfikator UUID usługi, np. 0000180d-0000-1000-8000-00805f9b34fb.
ServiceData
Właściwości
-
dane
liczba[]
-
uuid
string,
Metody
connect()
chrome.bluetoothLowEnergy.connect(
deviceAddress: string,
properties?: ConnectProperties,
callback?: function,
)
Ustanawia połączenie między aplikacją a urządzeniem o podanym adresie. Urządzenie może być już połączone, a usługi GATT są dostępne bez wywoływania usługi connect
. Jednak aplikacja, która chce uzyskać dostęp do usług GATT na urządzeniu, powinna wywoływać tę funkcję, aby upewnić się, że połączenie z urządzeniem zostanie utrzymane. Jeśli urządzenie nie jest połączone, wszystkie jego usługi GATT zostaną wykryte po udanym wywołaniu funkcji connect
.
Parametry
-
deviceAddress
string,
Adres Bluetooth urządzenia zdalnego, z którym ma zostać nawiązane połączenie GATT.
-
usługi
ConnectProperties opcjonalnie
Właściwości połączenia (opcjonalne).
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
createCharacteristic()
chrome.bluetoothLowEnergy.createCharacteristic(
characteristic: Characteristic,
serviceId: string,
callback?: function,
)
Utwórz lokalnie hostowaną cechę GATT. Ta cecha musi być hostowana w prawidłowej usłudze. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
charakterystyczne
Cecha do utworzenia.
-
serviceId
string,
Identyfikator usługi, dla której chcesz utworzyć tę cechę.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(characteristicId: string) => void
-
characteristicId
string,
-
Akcje powrotne
-
Obietnica<string>
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.
createDescriptor()
chrome.bluetoothLowEnergy.createDescriptor(
descriptor: Descriptor,
characteristicId: string,
callback?: function,
)
Utwórz deskryptor GATT hostowany lokalnie. Ten deskryptor musi być hostowany z prawidłową cechą. Jeśli identyfikator cechy jest nieprawidłowy, ustawiany jest parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
deskryptor
Deskryptor do utworzenia.
-
characteristicId
string,
Identyfikator cechy, dla której ma zostać utworzony ten deskryptor.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(descriptorId: string) => void
-
descriptorId
string,
-
Akcje powrotne
-
Obietnica<string>
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.
createService()
chrome.bluetoothLowEnergy.createService(
service: Service,
callback?: function,
)
utworzyć usługę GATT hostowaną lokalnie. Usługa może zostać zarejestrowana jako dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
usługa
Usługa do utworzenia.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(serviceId: string) => void
-
serviceId
string,
-
Akcje powrotne
-
Obietnica<string>
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.
disconnect()
chrome.bluetoothLowEnergy.disconnect(
deviceAddress: string,
callback?: function,
)
Zamyka połączenie aplikacji z urządzeniem o podanym adresie. Pamiętaj, że nie zawsze spowoduje to zniszczenie samego linku fizycznego, ponieważ mogą istnieć inne aplikacje z otwartymi połączeniami.
Parametry
-
deviceAddress
string,
Adres Bluetooth urządzenia zdalnego.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
getCharacteristic()
chrome.bluetoothLowEnergy.getCharacteristic(
characteristicId: string,
callback?: function,
)
Pobierz cechę GATT z podanym identyfikatorem instancji, który należy do danej usługi GATT (jeśli istnieje).
Parametry
-
characteristicId
string,
Identyfikator instancji żądanej cechy GATT.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Characteristic) => void
-
wynik
-
Akcje powrotne
-
Promise<Characteristic>
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.
getCharacteristics()
chrome.bluetoothLowEnergy.getCharacteristics(
serviceId: string,
callback?: function,
)
uzyskać listę wszystkich wykrytych cech GATT, które należą do danej usługi;
Parametry
-
serviceId
string,
Identyfikator instancji usługi GATT, której cechy powinny zostać zwrócone.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Characteristic[]) => void
-
wynik
-
Akcje powrotne
-
Promise<Characteristic[]>
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.
getDescriptor()
chrome.bluetoothLowEnergy.getDescriptor(
descriptorId: string,
callback?: function,
)
Pobierz deskryptor cechy GATT z podanym identyfikatorem instancji.
Parametry
-
descriptorId
string,
Identyfikator instancji żądanego deskryptora cechy GATT.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Descriptor) => void
-
wynik
-
Akcje powrotne
-
Promise<Descriptor>
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.
getDescriptors()
chrome.bluetoothLowEnergy.getDescriptors(
characteristicId: string,
callback?: function,
)
Uzyskaj listę deskryptorów cech GATT, które należą do danej cechy.
Parametry
-
characteristicId
string,
Identyfikator instancji cechy GATT, której deskryptory powinny zostać zwrócone.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Descriptor[]) => void
-
wynik
-
Akcje powrotne
-
Promise<Descriptor[]>
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.
getIncludedServices()
chrome.bluetoothLowEnergy.getIncludedServices(
serviceId: string,
callback?: function,
)
Uzyskaj listę usług GATT, które są zawarte w danej usłudze.
Parametry
Akcje powrotne
-
Obietnica<Usługa[]>
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.
getService()
chrome.bluetoothLowEnergy.getService(
serviceId: string,
callback?: function,
)
Pobierz usługę GATT o podanym identyfikatorze instancji.
Parametry
-
serviceId
string,
Identyfikator instancji żądanej usługi GATT.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Service) => void
-
wynik
-
Akcje powrotne
-
Obiecywanie<Usługa>
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.
getServices()
chrome.bluetoothLowEnergy.getServices(
deviceAddress: string,
callback?: function,
)
Pobierz wszystkie usługi GATT wykryte na urządzeniu zdalnym za pomocą podanego adresu.
Uwaga: jeśli wykrywanie usług na urządzeniu nie zostało ukończone, ten interfejs API zwróci podzbiór usług (prawdopodobnie pusty). Aby obejść ten problem, należy dodać opóźnienie zależne od czasu lub wielokrotne wywoływanie połączenia do momentu zwrócenia oczekiwanej liczby usług.
Parametry
Akcje powrotne
-
Obietnica<Usługa[]>
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.
notifyCharacteristicValueChanged()
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
characteristicId: string,
notification: Notification,
callback?: function,
)
Powiadom zdalne urządzenie o nowej wartości cechy. Jeśli flaga powinnaWskazuje w obiekcie powiadomienia, że ma wartość Prawda, zamiast powiadomienia będzie wysyłany odpowiedni sygnał. Pamiętaj, że aby wywołanie to było skuteczne, cecha musi podczas tworzenia poprawnie ustawić właściwość „notify” lub „indicate”. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
characteristicId
string,
Cecha, dla której należy wysłać powiadomienie.
-
powiadomienie
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
readCharacteristicValue()
chrome.bluetoothLowEnergy.readCharacteristicValue(
characteristicId: string,
callback?: function,
)
Pobierz wartość określonej cechy z zdalnego urządzenia peryferyjnego.
Parametry
-
characteristicId
string,
Identyfikator instancji cechy GATT, której wartość należy odczytać z urządzenia zdalnego.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Characteristic) => void
-
wynik
-
Akcje powrotne
-
Promise<Characteristic>
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.
readDescriptorValue()
chrome.bluetoothLowEnergy.readDescriptorValue(
descriptorId: string,
callback?: function,
)
Pobierz wartość określonego deskryptora cechy ze zdalnego urządzenia peryferyjnego.
Parametry
-
descriptorId
string,
Identyfikator instancji deskryptora cechy GATT, którego wartość należy odczytać z urządzenia zdalnego.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(result: Descriptor) => void
-
wynik
-
Akcje powrotne
-
Promise<Descriptor>
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.
registerAdvertisement()
chrome.bluetoothLowEnergy.registerAdvertisement(
advertisement: Advertisement,
callback?: function,
)
Utwórz reklamę i zarejestruj ją w celu wyświetlania reklam. Aby wywołać tę funkcję, w aplikacji muszą być ustawione uprawnienia bluetooth:low_energy i bluetooth:peryferia na wartość Prawda. Dodatkowo ten interfejs API jest dostępny tylko w przypadku aplikacji uruchamianych automatycznie w trybie kiosku lub po ustawieniu przełącznika wiersza poleceń „--enable-ble-advertising-in-apps”. Więcej informacji znajdziesz na stronie https://developer.chrome.com/apps/manifest/Bluetooth W przypadku sprzętu, który nie obsługuje zarówno trybu centralnego, jak i peryferyjnego, próba użycia urządzenia w obu trybach spowoduje niezdefiniowane zachowanie lub uniemożliwi prawidłowe działanie innych aplikacji głównych (w tym wykrywanie urządzeń Bluetooth Low Energy).
Parametry
-
reklama
Reklama, która ma być reklamowana.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:(advertisementId: number) => void
-
advertisementId
Liczba
-
Akcje powrotne
-
Obietnica<number>
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.
registerService()
chrome.bluetoothLowEnergy.registerService(
serviceId: string,
callback?: function,
)
Zarejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
serviceId
string,
Unikalny identyfikator utworzonej usługi.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
removeService()
chrome.bluetoothLowEnergy.removeService(
serviceId: string,
callback?: function,
)
Usuń określoną usługę, wyrejestrowując ją, jeśli została zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
serviceId
string,
Unikalny identyfikator aktualnie zarejestrowanej usługi.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
resetAdvertising()
chrome.bluetoothLowEnergy.resetAdvertising(
callback?: function,
)
Resetuje reklamy na bieżącym urządzeniu. Wszystkie istniejące reklamy zostaną wyrejestrowane i wstrzymane.
Parametry
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
sendRequestResponse()
chrome.bluetoothLowEnergy.sendRequestResponse(
response: Response,
)
Wysyła odpowiedź na żądanie odczytu/zapisu dla cechy lub deskryptora. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
odpowiedź
Odpowiedź na żądanie.
setAdvertisingInterval()
chrome.bluetoothLowEnergy.setAdvertisingInterval(
minInterval: number,
maxInterval: number,
callback?: function,
)
Ustaw odstęp między dwiema kolejnymi reklamami. Uwaga: jest to najlepsza opcja. Rzeczywisty odstęp może odbiegać od żądanych przedziałów. Na niektórych urządzeniach odstęp minimalny to 100 ms. Minimalna i maksymalna wartość nie mogą przekraczać zakresu dozwolonego w specyfikacji Bluetooth 4.2.
Parametry
-
minInterval
Liczba
Minimalny odstęp między reklamami (w milisekundach). Nie może być on krótszy niż 20 ms (zgodnie ze specyfikacją).
-
maxInterval
Liczba
Maksymalny odstęp między reklamami (w milisekundach). Nie może to być więcej niż 10 240 ms (zgodnie ze specyfikacją).
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
startCharacteristicNotifications()
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
characteristicId: string,
properties?: NotificationProperties,
callback?: function,
)
Włącz powiadomienia o wartościach z określonej cechy. Po włączeniu tej funkcji aplikacja może nasłuchiwać powiadomień, korzystając ze zdarzenia onCharacteristicValueChanged
.
Parametry
-
characteristicId
string,
Identyfikator instancji cechy GATT, dla której mają być włączone powiadomienia.
-
usługi
Opcjonalne NotificationProperties
Właściwości sesji powiadomień (opcjonalne).
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
stopCharacteristicNotifications()
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
characteristicId: string,
callback?: function,
)
Wyłącz powiadomienia/wskaźniki dotyczące wartości określonej cechy. Po udanym połączeniu aplikacja przestanie otrzymywać powiadomienia/wskaźniki z tej cechy.
Parametry
-
characteristicId
string,
Identyfikator wystąpienia cechy GATT, w której przypadku należy zatrzymać sesję powiadomień z tej aplikacji.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
unregisterAdvertisement()
chrome.bluetoothLowEnergy.unregisterAdvertisement(
advertisementId: number,
callback?: function,
)
Wyrejestrowuje reklamę i przerywa jej wyświetlanie. Jeśli reklama się nie wyrejestruje, jedynym sposobem na wstrzymanie wyświetlania jest ponowne uruchomienie urządzenia.
Parametry
-
advertisementId
Liczba
Identyfikator reklamy do wyrejestrowania.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
unregisterService()
chrome.bluetoothLowEnergy.unregisterService(
serviceId: string,
callback?: function,
)
Wyrejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
serviceId
string,
Unikalny identyfikator aktualnie zarejestrowanej usługi.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
writeCharacteristicValue()
chrome.bluetoothLowEnergy.writeCharacteristicValue(
characteristicId: string,
value: ArrayBuffer,
callback?: function,
)
Zapisz wartość określonej cechy na zdalnym urządzeniu peryferyjnym.
Parametry
-
characteristicId
string,
Identyfikator instancji cechy GATT, w której należy zapisać wartość.
-
value
ArrayBuffer
Wartość, która powinna zostać wysłana do cechy zdalnej w ramach żądania zapisu.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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.
writeDescriptorValue()
chrome.bluetoothLowEnergy.writeDescriptorValue(
descriptorId: string,
value: ArrayBuffer,
callback?: function,
)
Zapisz wartość określonego deskryptora cechy na zdalnym urządzeniu peryferyjnym.
Parametry
-
descriptorId
string,
Identyfikator instancji deskryptora cechy GATT, w którym powinna zostać zapisana wartość.
-
value
ArrayBuffer
Wartość, która powinna zostać wysłana do zdalnego deskryptora w ramach żądania zapisu.
-
wywołanie zwrotne
funkcja opcjonalnie
Parametr
callback
wygląda tak:() => void
Akcje powrotne
-
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
onCharacteristicReadRequest
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
callback: function,
)
Uruchamiany, gdy podłączone urządzenie centralne prosi o odczyt wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(request: Request, characteristicId: string) => void
-
Poproś
-
characteristicId
string,
-
onCharacteristicValueChanged
chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
callback: function,
)
Uruchamiane, gdy wartość zdalnej cechy GATT zmieni się w wyniku żądania odczytu albo powiadomienia lub komunikatu o zmianie wartości. To zdarzenie będzie wysyłane tylko wtedy, gdy aplikacja włączyła powiadomienia przez wywołanie metody startCharacteristicNotifications
.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(characteristic: Characteristic) => void
-
charakterystyczne
-
onCharacteristicWriteRequest
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
callback: function,
)
Uruchamiany, gdy połączone centralne urządzenie wysyła żądanie zapisania wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(request: Request, characteristicId: string) => void
-
Poproś
-
characteristicId
string,
-
onDescriptorReadRequest
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
callback: function,
)
Uruchamiane, gdy połączone centralne urządzenie wysyła żądanie odczytu wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(request: Request, descriptorId: string) => void
-
Poproś
-
descriptorId
string,
-
onDescriptorValueChanged
chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
callback: function,
)
Uruchamiane, gdy wartość zdalnego deskryptora cechy GATT zmienia się, zwykle w wyniku żądania odczytu. To zdarzenie powstało głównie dla wygody użytkowników i zawsze jest wysyłane po udanym wywołaniu do readDescriptorValue
.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(descriptor: Descriptor) => void
-
deskryptor
-
onDescriptorWriteRequest
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
callback: function,
)
Uruchamiane, gdy połączone centralne urządzenie wysyła żądanie zapisania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(request: Request, descriptorId: string) => void
-
Poproś
-
descriptorId
string,
-
onServiceAdded
chrome.bluetoothLowEnergy.onServiceAdded.addListener(
callback: function,
)
Uruchomiono nową usługę GATT na urządzeniu zdalnym.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(service: Service) => void
-
usługa
-
onServiceChanged
chrome.bluetoothLowEnergy.onServiceChanged.addListener(
callback: function,
)
Uruchamiane po zmianie stanu zdalnej usługi GATT. Obejmuje to dowolne cechy lub deskryptory, które zostaną dodane do usługi lub z niej usunięte, a także powiadomienia „ServiceChanged” z urządzenia zdalnego.
Parametry
-
wywołanie zwrotne
funkcja
Parametr
callback
wygląda tak:(service: Service) => void
-
usługa
-
onServiceRemoved
chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
callback: function,
)
Uruchamiane, gdy usługa GATT, która została wcześniej wykryta na urządzeniu zdalnym, została usunięta.