chrome.bluetoothLowEnergy

Opis

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

Plik manifestu

Aby używać tego interfejsu API, należy zadeklarować te klucze w pliku manifestu.

"bluetooth"

Typy

Advertisement

Chrome w wersji 47 lub nowszej .

Właściwości

  • manufacturerData

    ManufacturerData[] opcjonalny

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

  • serviceData

    ServiceData[] opcjonalny

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

  • serviceUuids

    string[] opcjonalnie

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

  • solicitUuids

    string[] opcjonalnie

    Lista identyfikatorów UUID do uwzględnienia w przypadku identyfikatorów UUID do zamawiania w danych reklamowych. Identyfikatory UUID mogą być w formacie 16-bitowym, 32-bitowym lub 128-bitowym.

  • Typ reklamy.

AdvertisementType

Chrome w wersji 47 lub nowszej .

Typ reklamy. Jeśli „transmisja” zostanie wybrany typ wysłanej reklamy: ADV_NONCONN_IND, a urządzenie będzie transmitować z losowym adresem MAC. Jeśli ustawisz wartość „peryferyjne”, reklama będzie mieć typ ADV_IND lub ADV_SCAN_IND, a urządzenie będzie wysyłać z prawdziwego adresu MAC adaptera Bluetooth.

Typ wyliczeniowy

"broadcast"

"peryferal"

Characteristic

Właściwości

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej cechy. Za pomocą identyfikatora instancji możesz rozróżnić cechy urządzenia peryferyjnego z tym samym identyfikatorem UUID i wywoływać funkcje, które przyjmują charakterystyczny identyfikator. Obecność, jeśli ta instancja reprezentuje cechę zdalną.

  • Właściwości tej cechy.

  • usługa

    Usługa opcjonalna

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

  • UUID

    ciąg znaków

    Identyfikator UUID cechy, np. 00002a37-0000-1000-8000-00805f9b34fb.

  • wartość

    SlateBuffer opcjonalnie

    Wartość charakterystyczna aktualnie zapisana w pamięci podręcznej. Ta wartość jest aktualizowana, gdy wartość cechy jest odczytywana lub aktualizowana za pomocą powiadomienia lub wskaźnika.

CharacteristicProperty

Wartości reprezentujące możliwe właściwości cechy. Uprawnienia charakterystyczne są ustalane na podstawie tych właściwości. Informacje o poszczególnych usługach znajdziesz w specyfikacji Bluetooth 4.x.

Typ wyliczeniowy

"broadcast"

"read"

"writeWithoutResponse"

"write"

"powiadom"

"indicate"

"authenticatedSignedWrites"

"extendedWłaściwości"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Właściwości

  • trwała

    wartość logiczna

    Flaga z informacją, czy połączenie z urządzeniem jest otwarte po wyłączeniu strony zdarzenia aplikacji (zobacz Zarządzanie cyklem życia aplikacji). Wartość domyślna to 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óżnić deskryptory od urządzenia peryferyjnego z tym samym identyfikatorem UUID i tworzyć wywołania funkcji, które przyjmują identyfikator deskryptora. Obecność, jeśli ta instancja reprezentuje cechę zdalną.

  • uprawnienia

    DescriptorPermission[]

    Chrome w wersji 52 lub nowszej .

    Uprawnienia tego deskryptora.

  • UUID

    ciąg znaków

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

  • wartość

    SlateBuffer opcjonalnie

    Wartość deskryptora aktualnie przechowywanego w pamięci podręcznej. Ta wartość jest aktualizowana po odczytaniu wartości deskryptora.

DescriptorPermission

Chrome w wersji 52 lub nowszej .

Wartości reprezentujące możliwe uprawnienia deskryptora. Aby poznać znaczenie poszczególnych uprawnień, zapoznaj się ze specyfikacją Bluetooth 4.x.

Typ wyliczeniowy

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome w wersji 52 lub nowszej .

Właściwości

  • adres

    ciąg znaków

    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

    Zrozumiała dla człowieka nazwa urządzenia.

ManufacturerData

Chrome w wersji 47 lub nowszej .

Właściwości

  • dane

    liczba[]

  • id

    liczba

Notification

Chrome w wersji 52 lub nowszej .

Właściwości

  • shouldIndicate

    Wartość logiczna opcjonalna

    Opcjonalna flaga do wysyłania powiadomienia zamiast powiadomienia.

  • wartość

    SlateBuffer

    Nowa wartość cechy.

NotificationProperties

Właściwości

  • trwała

    wartość logiczna

    Flaga z informacją, czy aplikacja powinna otrzymywać powiadomienia, gdy jej strona zdarzenia zostanie wyładowana z pamięci (zobacz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false.

Request

Chrome w wersji 52 lub nowszej .

Właściwości

  • urządzenie

    Urządzenie

    Urządzenie, z którego wysłano to żądanie.

  • requestId

    liczba

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

  • wartość

    SlateBuffer opcjonalnie

    Wartość do zapisu (jeśli jest to żądanie zapisu).

Response

Chrome w wersji 52 lub nowszej .

Właściwości

  • isError

    wartość logiczna

    Jeśli odpowiedź dotyczy błędu, musi mieć wartość prawda.

  • requestId

    liczba

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

  • wartość

    SlateBuffer opcjonalnie

    Wartość odpowiedzi. Żądania zapisu i odpowiedzi na błędy będą ignorować 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. Obecność, 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 z tym samym identyfikatorem UUID i do wykonywania wywołań funkcji, które przyjmują identyfikator usługi. Obecność, jeśli ta instancja reprezentuje usługę zdalną.

  • isPrimary

    wartość logiczna

    Wskazuje, czy typ tej usługi jest główny czy dodatkowy.

  • UUID

    ciąg znaków

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

ServiceData

Chrome w wersji 47 lub nowszej .

Właściwości

  • dane

    liczba[]

  • UUID

    ciąg znaków

Metody

connect()

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

Nawiązuje połączenie między aplikacją a urządzeniem o podanym adresie. Urządzenie może być już połączone, a usługi GATT dostępne bez wywołania interfejsu connect. Jednak aplikacja, która chce korzystać na urządzeniu z usług GATT, powinna wywołać tę funkcję, aby upewnić się, że połączenie z urządzeniem zostanie utrzymane. Jeśli urządzenie nie jest połączone, wszystkie usługi GATT zostaną wykryte po udanym wywołaniu urządzenia connect.

Parametry

  • deviceAddress

    ciąg znaków

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

  • usługi

    Opcjonalne ConnectProperties

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

createCharacteristic()

Obietnica Chrome w wersji 52 lub nowszej 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Utwórz lokalnie hostowaną charakterystykę GATT. Ta cecha musi być hostowana w ramach prawidłowej usługi. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • cecha

    Cecha

    Cecha do utworzenia.

  • identyfikator usługi

    ciąg znaków

    Identyfikator usługi, dla której ma zostać utworzona ta cecha.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (characteristicId: string) => void

    • characteristicId

      ciąg znaków

Zwroty

  • Obietnica<ciąg>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

createDescriptor()

Obietnica Chrome w wersji 52 lub nowszej 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Tworzenie deskryptora GATT hostowanego 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 aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • deskryptor

    Deskryptor

    Deskryptor do utworzenia.

  • characteristicId

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (descriptorId: string) => void

    • descriptorId

      ciąg znaków

Zwroty

  • Obietnica<ciąg>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

createService()

Obietnica Chrome w wersji 52 lub nowszej 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Utwórz lokalnie hostowaną usługę GATT. Ta usługa może zostać zarejestrowana jako dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • usługa

    Usługa

    Usługa do utworzenia.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (serviceId: string) => void

    • identyfikator usługi

      ciąg znaków

Zwroty

  • Obietnica<ciąg>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

disconnect()

Obietnica .
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 fizycznego linku, ponieważ mogą istnieć inne aplikacje z otwartymi połączeniami.

Parametry

  • deviceAddress

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getCharacteristic()

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

Uzyskaj charakterystykę GATT przy użyciu podanego identyfikatora instancji, która należy do danej usługi GATT, o ile cecha istnieje.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji żądanej cechy GATT.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Characteristic) => void

Zwroty

  • Obietnica<Cecha>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getCharacteristics()

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

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

Parametry

  • identyfikator usługi

    ciąg znaków

    Identyfikator instancji usługi GATT, której cechy powinny zostać zwrócone.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Characteristic[]) => void

Zwroty

  • Obietnica<Cecha[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getDescriptor()

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

Pobierz deskryptor charakterystyki GATT z podanym identyfikatorem instancji.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator instancji żądanego deskryptora cechy GATT.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Descriptor) => void

Zwroty

  • Promise&lt;Descriptor&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getDescriptors()

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

Uzyskaj listę deskryptorów cech GATT należących do danej cechy.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji danej cechy GATT, której deskryptory powinny zostać zwrócone.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Descriptor[]) => void

Zwroty

  • Promise&lt;Descriptor[]&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getIncludedServices()

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

Pobieranie listy usług GATT zawartych w danej usłudze.

Parametry

  • identyfikator usługi

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Service[]) => void

Zwroty

  • Obietnica<Usługa[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getService()

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

Pobierz usługę GATT o podanym identyfikatorze instancji.

Parametry

  • identyfikator usługi

    ciąg znaków

    Identyfikator instancji żądanej usługi GATT.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Service) => void

Zwroty

  • Promise&lt;Service&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

getServices()

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

Pobieranie wszystkich usług GATT, które zostały wykryte na urządzeniu zdalnym, z podanym adresem urządzenia.

Uwaga: jeśli wykrywanie usług na urządzeniu nie zostało ukończone, ten interfejs API zwróci podzbiór usług (być może pusty). Aby obejść ten problem, należy dodać opóźnienie w czasie lub wielokrotne nawiązywanie połączeń do momentu zwrócenia oczekiwanej liczby usług.

Parametry

  • deviceAddress

    ciąg znaków

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Service[]) => void

Zwroty

  • Obietnica<Usługa[]>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

notifyCharacteristicValueChanged()

Obietnica Chrome w wersji 52 lub nowszej 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Powiadom urządzenie zdalne o nowej wartości cechy. Jeśli flaga należyWskazać w obiekcie powiadomienia ma wartość true (prawda), zamiast powiadomienia zostanie wysłane powiadomienie. Uwaga: cecha musi prawidłowo ustawić opcję „powiadom” lub „wskaż” właściwość podczas tworzenia, aby zapewnić powodzenie tego wywołania. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • characteristicId

    ciąg znaków

    Cecha, o której ma zostać wysłane powiadomienie.

  • powiadomienie

    Powiadomienie

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

readCharacteristicValue()

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

Pobierz wartość określonej cechy ze zdalnego urządzenia peryferyjnego.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji o charakterze GATT, której wartość ma zostać odczytana z urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Characteristic) => void

Zwroty

  • Obietnica<Cecha>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

readDescriptorValue()

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

Pobierz wartość określonego deskryptora charakterystyki ze zdalnego urządzenia peryferyjnego.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator instancji deskryptora charakterystyki GATT, którego wartość ma być odczytywana z urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (result: Descriptor) => void

Zwroty

  • Promise&lt;Descriptor&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

registerAdvertisement()

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

Utwórz reklamę i zarejestruj ją w celu wyświetlania reklam. Aby można było wywołać tę funkcję, aplikacja musi mieć uprawnienia bluetooth:low_energy i bluetooth:peripheral - true. Dodatkowo ten interfejs API jest dostępny tylko w przypadku aplikacji uruchamianych automatycznie w trybie kiosku lub przez ustawienie opcji „--enable-ble-advertising-in-apps” za pomocą przełącznika wiersza poleceń. Patrz https://developer.chrome.com/apps/manifest/bluetooth Uwaga: w przypadku niektórych urządzeń jednocześnie obsługiwany jest tryb centralny i peryferyjny, ale w przypadku sprzętu, który tego nie obsługuje, wywołanie spowoduje przejście urządzenia w tryb peryferyjny. Próba korzystania z urządzenia w obu tych trybach może spowodować nieoczekiwane zachowanie lub uniemożliwiać prawidłowe działanie innych aplikacji, które pełnią kluczową rolę (w tym wykrywania urządzeń Bluetooth Low Energy).

Parametry

  • reklama

    Reklama

    Reklama, która ma być reklamowana.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    (advertisementId: number) => void

    • advertisementId

      liczba

Zwroty

  • Promise&lt;number&gt;

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

registerService()

Obietnica Chrome w wersji 52 lub nowszej 
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 parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • identyfikator usługi

    ciąg znaków

    Unikalny identyfikator utworzonej usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

removeService()

Obietnica Chrome w wersji 52 lub nowszej 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Usuń określoną usługę, wyrejestrowując ją, jeśli była zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • identyfikator usługi

    ciąg znaków

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

resetAdvertising()

Obietnica Chrome w wersji 61 lub nowszej 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Resetuje reklamy na bieżącym urządzeniu. Spowoduje to wyrejestrowanie konta i zatrzymanie wyświetlania wszystkich reklam.

Parametry

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

sendRequestResponse()

Chrome w wersji 52 lub nowszej .
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Wysyła odpowiedź na żądanie odczytu/zapisu charakterystyki lub deskryptora. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

setAdvertisingInterval()

Obietnica Chrome w wersji 55 lub nowszej 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Jest to interwał między 2 kolejnymi reklamami. Uwaga: spróbujemy jak najlepiej. Rzeczywisty odstęp może odbiegać od żądanych przedziałów czasowo. Na niektórych urządzeniach minimalny odstęp czasu wynosi 100 ms. Minimalne i maksymalne wartości nie mogą przekraczać zakresu dozwolonego w specyfikacji Bluetooth 4.2.

Parametry

  • minInterval

    liczba

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

  • maxInterval

    liczba

    Maksymalny odstęp między reklamami (w milisekundach). Wartość nie może być większa niż 10 240 ms (zgodnie ze specyfikacją).

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

startCharacteristicNotifications()

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

Włącz powiadomienia lub wskaźniki dotyczące wartości od określonej cechy. Po włączeniu tej funkcji 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 opcjonalne

    Właściwości sesji powiadomień (opcjonalnie).

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

stopCharacteristicNotifications()

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

Wyłącz powiadomienia lub wskaźniki dotyczące wartości od określonej cechy. Po udanym wywołaniu aplikacja przestanie otrzymywać powiadomienia/wskazówki dotyczące tej cechy.

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji właściwości GATT, w której przypadku sesja powiadomień tej aplikacji powinna zostać zatrzymana.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

unregisterAdvertisement()

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

Wyrejestrowuje reklamę i przerywa jej wyświetlanie. Jeśli nie uda się wyrejestrować reklamy, jedynym sposobem na zatrzymanie wyświetlania reklam może być ponowne uruchomienie urządzenia.

Parametry

  • advertisementId

    liczba

    Identyfikator reklamy do wyrejestrowania.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

unregisterService()

Obietnica Chrome w wersji 52 lub nowszej 
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 parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma zarówno uprawnienia bluetooth:low_energy, jak i bluetooth:peryferal, ustawione na true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • identyfikator usługi

    ciąg znaków

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

writeCharacteristicValue()

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

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

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji danej cechy GATT, w której należy zapisać wartość.

  • wartość

    SlateBuffer

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

writeDescriptorValue()

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

Zapisz wartość określonego deskryptora charakterystycznego ze zdalnego urządzenia peryferyjnego.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator instancji deskryptora charakterystyki GATT, w którym należy zapisywać wartość.

  • wartość

    SlateBuffer

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

  • wywołanie zwrotne

    funkcja optional

    Parametr callback wygląda tak: 

    () => void

Zwroty

  • Obietnica<void>

    Chrome w wersji 91 lub nowszej .

    Obietnice są obsługiwane tylko na platformie Manifest V3 i nowszych, inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onCharacteristicReadRequest

Chrome w wersji 52 lub nowszej .
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne wysyła żądanie odczytu wartości cechy zarejestrowanej na lokalnym serwerze GATT. Nie odpowiadanie na to żądanie przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral - true. 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

onCharacteristicValueChanged

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

Uruchamiane, gdy wartość zdalnej cechy GATT zmieni się w wyniku żądania odczytu lub powiadomienia/wskazania o zmianie wartości. To zdarzenie będzie wysyłane tylko wtedy, gdy aplikacja włączy powiadomienia, wywołując metodę startCharacteristicNotifications.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome w wersji 52 lub nowszej .
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne wysyła żądanie zapisu wartości cechy zarejestrowanej na lokalnym serwerze GATT. Nie odpowiadanie na to żądanie przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral - true. 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

onDescriptorReadRequest

Chrome w wersji 52 lub nowszej .
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne wysyła żądanie odczytu wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Nie odpowiadanie na to żądanie przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral - true. 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

onDescriptorValueChanged

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

Uruchamiane, gdy wartość zdalnego deskryptora charakterystyki GATT zmieni się, zwykle w wyniku żądania odczytu. To zdarzenie powstało głównie dla wygody użytkownika i będzie zawsze wysyłane po pomyślnym wywołaniu numeru readDescriptorValue.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome w wersji 52 lub nowszej .
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne wysyła żądanie zapisu wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Nie odpowiadanie na to żądanie przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral - true. 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

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

onServiceChanged

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

Uruchamiane po zmianie stanu zdalnej usługi GATT. Obejmuje to wszelkie cechy lub deskryptory, które są dodawane do usługi lub z niej usuwane, a także „ServiceChanged” powiadomienia z urządzenia zdalnego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (service: Service) => void

onServiceRemoved

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

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

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (service: Service) => void