chrome.bluetoothLowEnergy

Opis

Interfejs chrome.bluetoothLowEnergy API służy do komunikacji z urządzeniami Bluetooth Smart (Low Energy) za pomocą profilu atrybutów ogólnych (GATT).

Plik manifestu

Aby korzystać z tego interfejsu API, musisz zadeklarować te klucze w pliku manifestu.

"bluetooth"

Typy

Advertisement

Chrome 47 lub nowszy

Właściwości

  • manufacturerData

    ManufacturerData[] opcjonalnie

    Lista danych producenta, które należy uwzględnić w polach „Dane producenta” danych reklamowych.

  • serviceData

    ServiceData[] opcjonalny

    Lista danych usługi, które mają być uwzględnione w polach „Dane usługi” danych reklamowych.

  • serviceUuids

    string[] opcjonalnie

    Lista identyfikatorów UUID do uwzględnienia w polu „Identyfikatory UUID usługi” w sekcji „Dane reklamowe”. Identyfikatory UUID mogą być w formacie 16-, 32- lub 128-bitowym.

  • solicitUuids

    string[] opcjonalnie

    Lista identyfikatorów UUID do uwzględnienia w polu „Solicit UUIDs” w sekcji „Dane reklam”. Identyfikatory UUID mogą być w formacie 16-, 32- lub 128-bitowym.

  • Typ reklamy.

AdvertisementType

Chrome 47 lub nowszy

Typ reklamy. Jeśli wybrana jest opcja „broadcast”, wysyłany typ reklamy to ADV_NONCONN_IND, a urządzenie będzie nadawać z losowym adresem MAC. Jeśli ma wartość „peripheral” (peryferyjne), typ reklamy będzie ADV_IND lub ADV_SCAN_IND, a urządzenie będzie nadawać z prawdziwym adresem MAC adaptera Bluetooth.

Typ wyliczeniowy

„broadcast”

„peripheral”

Characteristic

Właściwości

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej cechy. Używaj identyfikatora instancji, aby rozróżniać cechy peryferyjne o tym samym identyfikatorze UUID, oraz do wywoływania funkcji, które przyjmują identyfikator cechy. True, jeśli ta instancja reprezentuje odległą cechę.

  • Właściwości tej cechy.

  • usługa

    Usługa opcjonalna

    Usługa GATT, do której należy ta cecha.

  • identyfikator UUID

    ciąg znaków

    Identyfikator UUID właściwości, np. 00002a37-0000-1000-8000-00805f9b34fb.

  • wartość

    ArrayBuffer opcjonalny

    Wartość cechy zapisanej w pamięci podręcznej. Ta wartość jest aktualizowana, gdy wartość cechy jest odczytywana lub aktualizowana za pomocą powiadomienia lub wskazania.

CharacteristicProperty

Wartości reprezentujące możliwe właściwości cechy. Uprawnienia dotyczące cech są określane na podstawie tych właściwości. Aby poznać znaczenie poszczególnych właściwości, zapoznaj się ze specyfikacją Bluetooth 4.x.

Typ wyliczeniowy

„broadcast”

"read"

"writeWithoutResponse"

"write"

„notify”

„wskaż”

„authenticatedSignedWrites”

„rozszerzoneWłaściwości”

"reliableWrite"

„writableAuxiliaries”

„encryptRead”

„encryptWrite”

„encryptAuthenticatedRead”

„encryptAuthenticatedWrite”

ConnectProperties

Właściwości

  • trwałe

    wartość logiczna

    Flaga wskazująca, czy połączenie z urządzeniem pozostaje otwarte, gdy strona zdarzenia w aplikacji jest nieobsługiwana (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false..

Descriptor

Właściwości

  • cecha

    Cecha opcjonalna

    Charakterystyka GATT, do której należy ten deskryptor.

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tego deskryptora. Używaj identyfikatora instancji, aby odróżniać deskryptory z peryferyjnych urządzeń o tym samym identyfikatorze UUID, a także do wywoływania funkcji, które przyjmują identyfikator deskryptora. True, jeśli ta instancja reprezentuje odległą cechę.

  • uprawnienia

    DescriptorPermission[]

    Chrome 52+

    Uprawnienia tego deskryptora.

  • identyfikator UUID

    ciąg znaków

    Identyfikator UUID opisu cechy, np. 00002902-0000-1000-8000-00805f9b34fb.

  • wartość

    ArrayBuffer opcjonalny

    Wartość opisu w pamięci podręcznej. Ta wartość jest aktualizowana, gdy odczytana zostanie wartość opisu.

DescriptorPermission

Chrome 52+

Wartości reprezentujące możliwe uprawnienia dla deskryptora. Informacje o znaczeniu poszczególnych uprawnień znajdziesz w specyfikacji Bluetooth 4.x.

Typ wyliczeniowy

"read"

"write"

„encryptedRead”

„encryptedWrite”

„encryptedAuthenticatedRead”

„encryptedAuthenticatedWrite”

Device

Chrome 52 lub nowszy

Właściwości

  • adres

    ciąg znaków

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

  • deviceClass

    number opcjonalny

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

  • nazwa

    ciąg znaków opcjonalny

    Czytelna nazwa urządzenia.

ManufacturerData

Chrome 47 lub nowszy

Właściwości

  • dane

    number[]

  • id

    liczba

Notification

Chrome 52+

Właściwości

  • shouldIndicate

    wartość logiczna opcjonalna

    Opcjonalna flaga umożliwiająca wysyłanie informacji zamiast powiadomienia.

  • wartość

    ArrayBuffer

    Nowa wartość cechy.

NotificationProperties

Właściwości

  • trwałe

    wartość logiczna

    Flaga wskazująca, czy aplikacja ma otrzymywać powiadomienia, gdy strona wydarzenia jest wczytana (patrz Zarządzanie cyklem życia aplikacji). (wartością domyślną jest false);

Request

Chrome 52+

Właściwości

  • urządzenie

    Urządzenie

    Urządzenie, które wysłało to żądanie.

  • requestId

    liczba

    Unikalny identyfikator tego żądania. Użyj tego identyfikatora, odpowiadając na to żądanie.

  • wartość

    ArrayBuffer opcjonalny

    Wartość do zapisania (jeśli jest to prośba o zapisywanie).

Response

Chrome 52+

Właściwości

  • isError

    wartość logiczna

    Jeśli jest to odpowiedź na błąd, wartość powinna być równa TRUE.

  • requestId

    liczba

    Identyfikator żądania, na które odpowiada ta odpowiedź.

  • wartość

    ArrayBuffer opcjonalny

    Wartość odpowiedzi. Żądania zapisu i odpowiedzi na błędy zignorują ten parametr.

Service

Właściwości

  • deviceAddress

    ciąg znaków opcjonalny

    Adres urządzenia zdalnego urządzenia peryferyjnego, do którego należy usługa GATT. True, jeśli ta instancja reprezentuje usługę zdalna.

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej usługi. Używaj identyfikatora instancji, aby rozróżniać usługi od urządzeń peryferyjnych z tym samym identyfikatorem UUID, a także do wywoływania funkcji, które przyjmują identyfikator usługi. True, jeśli ta instancja reprezentuje usługę zdalną.

  • isPrimary

    wartość logiczna

    Wskazuje, czy usługa jest usługą podstawową czy dodatkową.

  • identyfikator UUID

    ciąg znaków

    Identyfikator UUID usługi, np. 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 lub nowszy

Właściwości

  • dane

    number[]

  • identyfikator UUID

    ciąg znaków

Metody

connect()

Obietnice 
chrome.bluetoothLowEnergy.connect(
  deviceAddress: string,
  properties?: ConnectProperties,
  callback?: function,
)

Nawiązuje połączenie między aplikacją a urządzeniem o danym adresie. Urządzenie może być już połączone, a usługi GATT mogą być dostępne bez wywołania funkcji connect, ale aplikacja, która chce uzyskać dostęp do usług GATT urządzenia, powinna wywołać tę funkcję, aby zapewnić utrzymanie połączenia z urządzeniem. Jeśli urządzenie nie jest połączone, po wywołaniu funkcji connect zostaną wykryte wszystkie usługi GATT tego urządzenia.

Parametry

  • deviceAddress

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego, z którym ma zostać otwarte połączenie GATT.

  • usługi

    ConnectProperties opcjonalny

    Właściwości połączenia (opcjonalnie).

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

createCharacteristic()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Utwórz lokalnie hostowaną cechę GATT. Ta cecha musi być hostowana w ramach prawidłowej usługi. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiona wartość lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • cecha

    Cecha

    Charakterystyka do utworzenia.

  • serviceId

    ciąg znaków

    Identyfikator usługi, dla której chcesz utworzyć tę cechę.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (characteristicId: string) => void

    • characteristicId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

createDescriptor()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Utwórz lokalnie hostowany opis GATT. Ten deskryptor musi być hostowany w ramach prawidłowej cechy. Jeśli identyfikator cechy jest nieprawidłowy, zostanie ustawiony element lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • deskryptor

    Descriptor

    Deskryptor do utworzenia.

  • characteristicId

    ciąg znaków

    Identyfikator cechy, dla której chcesz utworzyć ten deskryptor.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (descriptorId: string) => void

    • descriptorId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

createService()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Utwórz usługę GATT hostowaną lokalnie. Usługę można zarejestrować, aby była dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • usługa

    Usługa

    Usługa do utworzenia.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (serviceId: string) => void

    • serviceId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

disconnect()

Obietnice 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Zamyka połączenie aplikacji z urządzeniem o danym adresie. Pamiętaj, że nie zawsze spowoduje to zniszczenie samego fizycznego połączenia, ponieważ inne aplikacje mogą mieć otwarte połączenia.

Parametry

  • deviceAddress

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getCharacteristic()

Obietnice 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
)

Pobierz zwracaną cechę GATT z danym identyfikatorem instancji, która należy do danej usługi GATT (jeśli cecha istnieje).

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji żądanej właściwości GATT.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Characteristic) => void

Zwroty

  • Obietnica<Characteristic>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getCharacteristics()

Obietnice 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
)

Pobranie listy wszystkich wykrytych cech GATT należących do danej usługi.

Parametry

  • serviceId

    ciąg znaków

    Identyfikator instancji usługi GATT, której właściwości mają zostać zwrócone.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Characteristic[]) => void

Zwroty

  • Promise<Characteristic[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getDescriptor()

Obietnice 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
)

Pobierz opis atrybutu GATT z podanym identyfikatorem instancji.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator instancji żądanego deskryptora właściwości GATT.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Descriptor) => void

Zwroty

  • Obietnice<Descriptor>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getDescriptors()

Obietnice 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
)

Pobiera listę identyfikatorów GATT, które należą do danej właściwości.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji właściwości GATT, której opisy mają zostać zwrócone.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Descriptor[]) => void

Zwroty

  • Promise<Descriptor[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getIncludedServices()

Obietnice 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
)

Pobranie listy usług GATT, które są zawarte w danej usłudze.

Parametry

  • serviceId

    ciąg znaków

    Identyfikator instancji usługi GATT, której usługi mają zostać zwrócone.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Service[]) => void

Zwroty

  • Obietnice<Service[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getService()

Obietnice 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Pobierz usługę GATT o podanym identyfikatorze instancji.

Parametry

  • serviceId

    ciąg znaków

    Identyfikator instancji żądanej usługi GATT.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Service) => void

Zwroty

  • Obietnice<Usługa>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

getServices()

Obietnice 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
)

Pobierz wszystkie usługi GATT wykryte na urządzeniu zdalnym z danym adresem urządzenia.

Uwaga: jeśli wykrywanie usług nie zostało jeszcze ukończone na urządzeniu, to wywołanie interfejsu API zwróci podzbiór (być może pusty) usług. Aby obejść ten problem, możesz dodać opóźnienie czasowe lub wielokrotnie wywołać usługę, aż do uzyskania oczekiwanej liczby usług.

Parametry

  • deviceAddress

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego, którego usługi GATT mają zostać zwrócone.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Service[]) => void

Zwroty

  • Obietnice<Service[]>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

notifyCharacteristicValueChanged()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Powiadomić urządzenie zdalne o nowej wartości właściwości. Jeśli w obiekcie powiadomienia parametr shouldIndicate ma wartość true, zamiast powiadomienia zostanie wysłany komunikat. Aby wywołanie zakończyło się powodzeniem, podczas tworzenia cechy należy prawidłowo ustawić właściwość „notify” lub „indicate”. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • characteristicId

    ciąg znaków

    Charakterystyka, dla której chcesz wysłać powiadomienie.

  • powiadomienie

    Powiadomienie

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

readCharacteristicValue()

Obietnice 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
)

Pobiera wartość określonej cechy z peryferyjnego urządzenia zdalnego.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator wystąpienia właściwości GATT, której wartość powinna być odczytana z urządzenia zdalnego.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Characteristic) => void

Zwroty

  • Obietnica<Characteristic>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

readDescriptorValue()

Obietnice 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
)

Pobiera wartość określonego deskryptora właściwości z urządzenia peryferyjnego.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator wystąpienia deskryptora właściwości GATT, którego wartość powinna być odczytana z urządzenia zdalnego.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (result: Descriptor) => void

Zwroty

  • Obietnice<Descriptor>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

registerAdvertisement()

Obietnica Chrome 47 lub nowszy 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Utwórz reklamę i zarejestruj ją na potrzeby reklamowania. Aby wywołać tę funkcję, aplikacja musi mieć ustawione na „true” uprawnienia bluetooth:low_energy i bluetooth:peripheral. Ponadto ten interfejs API jest dostępny tylko w przypadku aplikacji uruchamianych automatycznie w trybie kiosku lub po ustawieniu przełącznika w linii poleceń „--enable-ble-advertising-in-apps”. Więcej informacji znajdziesz na stronie https://developer.chrome.com/apps/manifest/bluetooth. Uwaga: w przypadku niektórych urządzeń jednocześnie obsługiwane są tryb centralny i peryferyjny, ale w przypadku urządzeń, które nie obsługują obu trybów, wywołanie spowoduje przełączenie urządzenia w tryb peryferyjny. W przypadku sprzętu, który nie obsługuje trybu centralnego i peryferyjnego, próba użycia urządzenia w obu trybach spowoduje nieokreślone działanie lub uniemożliwi prawidłowe działanie innych aplikacji pełniących rolę centrali (w tym wykrywanie urządzeń Bluetooth Low Energy).

Parametry

  • reklama

    Reklama

    Reklama, którą chcesz reklamować.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    (advertisementId: number) => void

    • advertisementId

      liczba

Zwroty

  • Obietnice<number>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

registerService()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
)

Zarejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony element lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator utworzonej usługi.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

removeService()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Usuń określoną usługę, wyrejestruj ją, jeśli była zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony element lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator bieżącej zarejestrowanej usługi.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

resetAdvertising()

Obietnice Chrome 61 i nowsze wersje 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Resetuje reklamy na bieżącym urządzeniu. Spowoduje to wyrejestrowanie i zatrzymanie wszystkich dotychczasowych reklam.

Parametry

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

sendRequestResponse()

Chrome 52+ 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Wysyła odpowiedź na żądanie odczytu/zapisu dotyczące charakterystycznej cechy lub opisu. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

setAdvertisingInterval()

Obietnice Chrome 55 i nowsze 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Określa odstęp między 2 kolejnymi reklamami. Uwaga: to jest możliwe najlepsza obsługa. Rzeczywisty interwał może się znacznie różnić od żądanych interwałów. W przypadku niektórych urządzeń minimalny interwał wynosi 100 ms. Wartości minimalna i maksymalna nie mogą wykraczać poza zakres określony w specyfikacji Bluetooth 4.2.

Parametry

  • minInterval

    liczba

    Minimalny odstęp między reklamami (w milisekundach). Nie może być mniejsza niż 20 ms (zgodnie ze specyfikacją).

  • maxInterval

    liczba

    Maksymalny odstęp między reklamami (w milisekundach). Nie może być dłuższy niż 10240 ms (zgodnie ze specyfikacją).

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

startCharacteristicNotifications()

Obietnice 
chrome.bluetoothLowEnergy.startCharacteristicNotifications(
  characteristicId: string,
  properties?: NotificationProperties,
  callback?: function,
)

Włącz powiadomienia/wskazania wartości z określonej cechy. Po włączeniu aplikacja może nasłuchiwać powiadomień za pomocą zdarzenia onCharacteristicValueChanged.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji właściwości GATT, dla której mają być włączone powiadomienia.

  • usługi

    NotificationProperties opcjonalnie

    Właściwości sesji powiadomienia (opcjonalnie).

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

stopCharacteristicNotifications()

Obietnice 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
)

Wyłącz powiadomienia/wskazania wartości z określonej cechy. Po zakończeniu wywołania aplikacja przestanie otrzymywać powiadomienia/wskazania z tej właściwości.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator wystąpienia właściwości GATT, w której sesji powiadomień ma zostać zatrzymana aplikacja.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

unregisterAdvertisement()

Obietnica Chrome 47 lub nowszy 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

anuluje rejestrację reklamy i zatrzymuje jej wyświetlanie. Jeśli reklama nie zostanie odrejestrowana, jedynym sposobem na zaprzestanie wyświetlania reklam może być ponowne uruchomienie urządzenia.

Parametry

  • advertisementId

    liczba

    Identyfikator reklamy, którą chcesz anulować.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

unregisterService()

Obietnice Chrome 52 lub nowszy 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Wyrejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony element lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma ustawione uprawnienia bluetooth:low_energy i bluetooth:peripheral na Prawda. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator bieżącej zarejestrowanej usługi.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

writeCharacteristicValue()

Obietnice 
chrome.bluetoothLowEnergy.writeCharacteristicValue(
  characteristicId: string,
  value: ArrayBuffer,
  callback?: function,
)

Zapisz wartość określonej cechy z peryferyjnego urządzenia zdalnego.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator wystąpienia właściwości GATT, do której ma zostać zapisana wartość.

  • wartość

    ArrayBuffer

    Wartość, która powinna zostać wysłana do właściwości zdalnej w ramach żądania zapisu.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

writeDescriptorValue()

Obietnice 
chrome.bluetoothLowEnergy.writeDescriptorValue(
  descriptorId: string,
  value: ArrayBuffer,
  callback?: function,
)

Zapisz wartość określonego opisu właściwości z urządzenia peryferyjnego zdalnego.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator wystąpienia deskryptora właściwości GATT, do którego ma zostać zapisana wartość.

  • wartość

    ArrayBuffer

    Wartość, która powinna zostać wysłana do zdalnego deskryptora w ramach żądania zapisu.

  • wywołanie zwrotne

    function opcjonalny

    Parametr callback ma postać:

    () => void

Zwroty

  • Obietnica<void>

    Chrome 91 lub nowszy

    Obietnice są obsługiwane tylko w przypadku pliku manifestu w wersji 3 lub nowszej, na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onCharacteristicReadRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Wywoływany, gdy połączone urządzenie centralne żąda odczytu wartości właściwości zarejestrowanej na lokalnym serwerze GATT. Nieodpowiedzenie na tę prośbę przez długi czas może spowodować odłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma ustawione na „Prawda” oba uprawnienia bluetooth:low_energy i bluetooth:peripheral. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (request: Request, characteristicId: string) => void

onCharacteristicValueChanged

chrome.bluetoothLowEnergy.onCharacteristicValueChanged.addListener(
  callback: function,
)

Wywoływane, gdy zmienia się wartość zdalnej właściwości GATT, na przykład w wyniku żądania odczytu lub powiadomienia/wskazania o zmianie wartości. To zdarzenie zostanie wysłane tylko wtedy, gdy aplikacja włączyła powiadomienia przez wywołanie funkcji startCharacteristicNotifications.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Wywoływany, gdy połączone urządzenie centralne prosi o zapisanie wartości właściwości zarejestrowanej na lokalnym serwerze GATT. Nieodpowiedzenie na tę prośbę przez długi czas może spowodować odłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma ustawione na „Prawda” oba uprawnienia bluetooth:low_energy i bluetooth:peripheral. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (request: Request, characteristicId: string) => void

onDescriptorReadRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Wywoływany, gdy połączone urządzenie centralne żąda odczytania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Nieodpowiedzenie na tę prośbę przez długi czas może spowodować odłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma ustawione na „Prawda” oba uprawnienia bluetooth:low_energy i bluetooth:peripheral. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (request: Request, descriptorId: string) => void

onDescriptorValueChanged

chrome.bluetoothLowEnergy.onDescriptorValueChanged.addListener(
  callback: function,
)

Wywoływany, gdy zmienia się wartość opisu właściwości GATT zdalnego, zwykle w wyniku żądania odczytu. To zdarzenie istnieje głównie dla wygody i zawsze jest wysyłane po pomyślnym wywołaniu funkcji readDescriptorValue.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52+ 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Wywoływany, gdy połączone urządzenie centralne prosi o zapisanie wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Nieodpowiedzenie na tę prośbę przez długi czas może spowodować odłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma ustawione na „Prawda” oba uprawnienia bluetooth:low_energy i bluetooth:peripheral. Zezwolenie na dostęp do urządzeń peryferyjnych może nie być dostępne w przypadku niektórych aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (request: Request, descriptorId: string) => void

onServiceAdded

chrome.bluetoothLowEnergy.onServiceAdded.addListener(
  callback: function,
)

Wywoływany, gdy na urządzeniu zdalnym wykryto nową usługę GATT.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (service: Service) => void

onServiceChanged

chrome.bluetoothLowEnergy.onServiceChanged.addListener(
  callback: function,
)

Wyzwalany po zmianie stanu zdalnej usługi GATT. Dotyczy to wszystkich cech lub deskryptorów dodanych lub usuniętych z usługi, a także powiadomień „ServiceChanged” z urządzenia zdalnego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (service: Service) => void

onServiceRemoved

chrome.bluetoothLowEnergy.onServiceRemoved.addListener(
  callback: function,
)

Wywoływany po usunięciu usługi GATT, która została wcześniej wykryta na urządzeniu zdalnym.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback ma postać:

    (service: Service) => void