chrome.bluetoothLowEnergy

Opis

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

Dostępność

Tylko w systemie ChromeOS

Plik manifestu

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

"bluetooth"

Typy

Advertisement

Chrome 47 lub nowsza wersja

Właściwości

  • manufacturerData

    ManufacturerData[] opcjonalne

    Lista danych specyficznych dla producenta, które mają być uwzględnione w polach „Dane specyficzne dla producenta” w danych reklamowych.

  • serviceData

    ServiceData[] opcjonalny

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

  • serviceUuids

    string[] opcjonalne

    Lista identyfikatorów UUID, które mają być uwzględnione w polu „Identyfikatory UUID usługi” w danych reklamowych. Te identyfikatory UUID mogą mieć format 16-bitowy, 32-bitowy lub 128-bitowy.

  • solicitUuids

    string[] opcjonalne

    Lista identyfikatorów UUID, które mają być uwzględnione w polu „Solicit UUIDs” (Identyfikatory UUID, o które należy prosić) w danych reklamowych. Te identyfikatory UUID mogą mieć format 16-bitowy, 32-bitowy lub 128-bitowy.

  • Typ reklamy.

AdvertisementType

Chrome 47 lub nowsza wersja

Typ reklamy. Jeśli wybierzesz „rozgłaszanie”, typ wysyłanej reklamy będzie ADV_NONCONN_IND, a urządzenie będzie rozgłaszać z losowym adresem MAC. Jeśli ustawisz wartość „peripheral”, typ reklamy będzie ADV_IND lub ADV_SCAN_IND, a urządzenie będzie nadawać z rzeczywistym 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żyj identyfikatora instancji, aby odróżnić cechy urządzenia peryferyjnego o tym samym identyfikatorze UUID i wywołać funkcje, które przyjmują identyfikator cechy. Występuje, jeśli ta instancja reprezentuje cechę zdalną.

  • właściwości

    CharacteristicProperty[]

    Właściwości tej cechy.

  • usługa

    Service opcjonalny

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

  • uuid

    tekst

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

  • wartość

    ArrayBuffer opcjonalny

    Aktualnie zapisana w pamięci podręcznej wartość charakterystyki. 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ą wnioskowane na podstawie tych właściwości. Znaczenie poszczególnych właściwości znajdziesz w specyfikacji Bluetooth 4.x.

Typ wyliczeniowy

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"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 aplikacji jest wyładowana (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false..

Descriptor

Właściwości

  • cecha

    Characteristic opcjonalny

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

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tego deskryptora. Użyj identyfikatora instancji, aby odróżnić deskryptory z urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywać wywołania funkcji, które przyjmują identyfikator deskryptora. Występuje, jeśli ta instancja reprezentuje cechę zdalną.

  • uprawnienia

    DescriptorPermission[]

    Chrome 52 lub nowsza wersja

    Uprawnienia tego deskryptora.

  • uuid

    tekst

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

  • wartość

    ArrayBuffer opcjonalny

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

DescriptorPermission

Chrome 52 lub nowsza wersja

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

Typ wyliczeniowy

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 lub nowsza wersja

Właściwości

  • adres

    tekst

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

  • deviceClass

    number optional

    Klasa urządzenia, pole bitowe zdefiniowane na stronie 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 47 lub nowsza wersja

Właściwości

  • dane

    number[]

  • id

    liczba

Notification

Chrome 52 lub nowsza wersja

Właściwości

  • shouldIndicate

    boolean opcjonalne

    Opcjonalna flaga do wysyłania wskazania zamiast powiadomienia.

  • wartość

    ArrayBuffer

    Nowa wartość cechy.

NotificationProperties

Właściwości

  • trwałe

    wartość logiczna

    Flaga wskazująca, czy aplikacja powinna otrzymywać powiadomienia, gdy strona zdarzenia aplikacji zostanie wyładowana (patrz Zarządzanie cyklem życia aplikacji). (wartością domyślną jest false);

Request

Chrome 52 lub nowsza wersja

Właściwości

  • urządzenie

    Urządzenie

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

  • requestId

    liczba

    Unikalny identyfikator tej prośby. Użyj tego identyfikatora, gdy będziesz odpowiadać na tę prośbę.

  • wartość

    ArrayBuffer opcjonalny

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

Response

Chrome 52 lub nowsza wersja

Właściwości

  • isError

    wartość logiczna

    Jeśli jest to odpowiedź o błędzie, powinna mieć wartość „true”.

  • requestId

    liczba

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

  • wartość

    ArrayBuffer opcjonalny

    Wartość odpowiedzi. Żądania zapisu i odpowiedzi o błędzie będą ignorować ten parametr.

Service

Właściwości

  • deviceAddress

    ciąg znaków opcjonalny

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

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej usługi. Użyj identyfikatora instancji, aby odróżnić usługi od urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywać wywołania funkcji, które przyjmują identyfikator usługi. Obecny, jeśli ta instancja reprezentuje usługę zdalną.

  • isPrimary

    wartość logiczna

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

  • uuid

    tekst

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

ServiceData

Chrome 47 lub nowsza wersja

Właściwości

  • dane

    number[]

  • uuid

    tekst

Metody

connect()

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

Nawiązuje połączenie między aplikacją a urządzeniem o podanym adresie. Urządzenie może być już połączone, a jego usługi GATT mogą być dostępne bez wywoływania funkcji connect. Jednak aplikacja, która chce uzyskać dostęp do usług GATT urządzenia, powinna wywołać tę funkcję, aby upewnić się, że połączenie z urządzeniem jest utrzymywane. Jeśli urządzenie nie jest połączone, wszystkie jego usługi GATT zostaną wykryte po udanym wywołaniu metody connect.

Parametry

  • deviceAddress

    tekst

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

  • właściwości

    ConnectProperties opcjonalne

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

createCharacteristic()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

Utwórz lokalnie hostowaną charakterystykę GATT. Ta charakterystyka musi być hostowana w ramach prawidłowej usługi. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • cecha

    Cechy

    Charakterystyka do utworzenia.

  • serviceId

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (characteristicId: string) => void

    • characteristicId

      tekst

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

createDescriptor()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

Utwórz lokalnie hostowany deskryptor GATT. Ten deskryptor musi być hostowany w ramach prawidłowej charakterystyki. Jeśli identyfikator cechy jest nieprawidłowy, zostanie ustawiony błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • deskryptor

    Deskryptor

    Deskryptor do utworzenia.

  • characteristicId

    tekst

    Identyfikator cechy, dla której ma zostać utworzony ten deskryptor.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (descriptorId: string) => void

    • descriptorId

      tekst

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

createService()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Utwórz usługę GATT hostowaną lokalnie. Tę usługę można zarejestrować, aby była dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • usługa

    Usługa

    Usługa, którą chcesz utworzyć.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (serviceId: string) => void

    • serviceId

      tekst

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

disconnect()

Obietnica 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
): Promise<void>

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

Parametry

  • deviceAddress

    tekst

    Adres Bluetooth urządzenia zdalnego.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getCharacteristic()

Obietnica 
chrome.bluetoothLowEnergy.getCharacteristic(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

Pobierz charakterystykę GATT o podanym identyfikatorze instancji, która należy do danej usługi GATT, jeśli ta charakterystyka istnieje.

Parametry

  • characteristicId

    tekst

    Identyfikator instancji żądanej charakterystyki GATT.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Characteristic) => void

Zwroty

  • Promise<Characteristic>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getCharacteristics()

Obietnica 
chrome.bluetoothLowEnergy.getCharacteristics(
  serviceId: string,
  callback?: function,
): Promise<Characteristic[]>

Pobierz listę wszystkich wykrytych charakterystyk GATT, które należą do danej usługi.

Parametry

  • serviceId

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Characteristic[]) => void

Zwroty

  • Promise<Characteristic[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getDescriptor()

Obietnica 
chrome.bluetoothLowEnergy.getDescriptor(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Pobierz deskryptor charakterystyki GATT z podanym identyfikatorem instancji.

Parametry

  • descriptorId

    tekst

    Identyfikator instancji żądanego deskryptora charakterystyki GATT.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Descriptor) => void

Zwroty

  • Promise<Descriptor>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getDescriptors()

Obietnica 
chrome.bluetoothLowEnergy.getDescriptors(
  characteristicId: string,
  callback?: function,
): Promise<Descriptor[]>

Pobierz listę deskryptorów charakterystyki GATT, które należą do danej charakterystyki.

Parametry

  • characteristicId

    tekst

    Identyfikator instancji charakterystyki GATT, której deskryptory mają zostać zwrócone.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Descriptor[]) => void

Zwroty

  • Promise<Descriptor[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getIncludedServices()

Obietnica 
chrome.bluetoothLowEnergy.getIncludedServices(
  serviceId: string,
  callback?: function,
): Promise<Service[]>

Pobierz listę usług GATT, które są uwzględnione w danej usłudze.

Parametry

  • serviceId

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Service[]) => void

Zwroty

  • Promise<Service[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getService()

Obietnica 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
): Promise<Service>

Pobierz usługę GATT z podanym identyfikatorem instancji.

Parametry

  • serviceId

    tekst

    Identyfikator instancji żądanej usługi GATT.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Service) => void

Zwroty

  • Promise<Service>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

getServices()

Obietnica 
chrome.bluetoothLowEnergy.getServices(
  deviceAddress: string,
  callback?: function,
): Promise<Service[]>

Pobierz wszystkie usługi GATT wykryte na urządzeniu zdalnym o podanym adresie.

Uwaga: jeśli wykrywanie usług nie zostało jeszcze zakończone na urządzeniu, ten interfejs API zwróci podzbiór usług (być może pusty). Obejście polega na dodaniu opóźnienia czasowego lub wielokrotnym wywoływaniu, aż zostanie zwrócona oczekiwana liczba usług.

Parametry

  • deviceAddress

    tekst

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Service[]) => void

Zwroty

  • Promise<Service[]>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

notifyCharacteristicValueChanged()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Powiadom urządzenie zdalne o nowej wartości cechy. Jeśli flaga shouldIndicate w obiekcie powiadomienia ma wartość „true”, zamiast powiadomienia zostanie wysłane wskazanie. Pamiętaj, że aby to wywołanie się powiodło, podczas tworzenia charakterystyki należy prawidłowo ustawić właściwość „notify” lub „indicate”. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • characteristicId

    tekst

    Charakterystyka, dla której ma zostać wysłane powiadomienie.

  • powiadomienie

    Powiadomienie

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

readCharacteristicValue()

Obietnica 
chrome.bluetoothLowEnergy.readCharacteristicValue(
  characteristicId: string,
  callback?: function,
): Promise<Characteristic>

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

Parametry

  • characteristicId

    tekst

    Identyfikator instancji cechy GATT, której wartość powinna zostać odczytana z urządzenia zdalnego.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Characteristic) => void

Zwroty

  • Promise<Characteristic>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

readDescriptorValue()

Obietnica 
chrome.bluetoothLowEnergy.readDescriptorValue(
  descriptorId: string,
  callback?: function,
): Promise<Descriptor>

Pobierz wartość określonego deskryptora cechy z urządzenia peryferyjnego.

Parametry

  • descriptorId

    tekst

    Identyfikator instancji deskryptora charakterystyki GATT, którego wartość powinna zostać odczytana z urządzenia zdalnego.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (result: Descriptor) => void

Zwroty

  • Promise<Descriptor>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

registerAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Utwórz reklamę i zarejestruj ją na potrzeby reklamowania. Aby wywołać tę funkcję, aplikacja musi mieć uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość „true”. Dodatkowo ten interfejs API jest dostępny tylko dla 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. Uwaga: na niektórych urządzeniach tryby centralny i peryferyjny są obsługiwane jednocześnie, ale na urządzeniach, które tego nie obsługują, to wywołanie przełączy urządzenie w tryb peryferyjny. 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 działanie lub uniemożliwi prawidłowe działanie innych aplikacji w trybie centralnym (w tym wykrywanie urządzeń Bluetooth Low Energy).

Parametry

  • reklama

    Reklama

    Reklama, którą chcesz wyświetlać.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    (advertisementId: number) => void

    • advertisementId

      liczba

Zwroty

  • Promise<number>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

registerService()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Zarejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • serviceId

    tekst

    Unikalny identyfikator utworzonej usługi.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

removeService()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Usuń określoną usługę i wyrejestruj ją, jeśli była zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • serviceId

    tekst

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

resetAdvertising()

Promise Chrome 61 lub nowsza wersja 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
): Promise<void>

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

Parametry

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

sendRequestResponse()

Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Wysyła odpowiedź na żądanie odczytu/zapisu charakterystyki lub deskryptora. Ta funkcja jest dostępna tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

setAdvertisingInterval()

Promise Chrome 55+ 
chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
): Promise<void>

Ustawia odstęp między 2 kolejnymi reklamami. Uwaga: jest to próba podjęcia wszelkich możliwych działań. Rzeczywisty interwał może się znacznie różnić od żądanego. Na niektórych urządzeniach minimalny interwał wynosi 100 ms. Wartości minimalne i maksymalne nie mogą przekraczać zakresu dozwolonego przez specyfikację 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 przekraczać 10 240 ms (zgodnie ze specyfikacją).

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

startCharacteristicNotifications()

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

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

Parametry

  • characteristicId

    tekst

    Identyfikator instancji charakterystyki GATT, dla której należy włączyć powiadomienia.

  • właściwości

    NotificationProperties opcjonalne

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

stopCharacteristicNotifications()

Obietnica 
chrome.bluetoothLowEnergy.stopCharacteristicNotifications(
  characteristicId: string,
  callback?: function,
): Promise<void>

Wyłącz powiadomienia/wskazania wartości z określonej charakterystyki. Po udanym wywołaniu aplikacja przestanie otrzymywać powiadomienia/wskazania z tej charakterystyki.

Parametry

  • characteristicId

    tekst

    Identyfikator instancji charakterystyki GATT, na której należy zatrzymać sesję powiadomień tej aplikacji.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

unregisterAdvertisement()

Promise Chrome 47+ 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Wyrejestrowuje reklamę i zatrzymuje jej rozgłaszanie. Jeśli nie uda się wyrejestrować rozgłaszania, jedynym sposobem na jego zatrzymanie może być ponowne uruchomienie urządzenia.

Parametry

  • advertisementId

    liczba

    Identyfikator reklamy, którą chcesz wyrejestrować.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

unregisterService()

Promise Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Wyrejestruj daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiony błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy zbiór uprawnień bluetooth:low_energy i bluetooth:peripheral ma wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • serviceId

    tekst

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

writeCharacteristicValue()

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

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

Parametry

  • characteristicId

    tekst

    Identyfikator instancji charakterystyki GATT, której wartość ma zostać zapisana.

  • wartość

    ArrayBuffer

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

writeDescriptorValue()

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

Zapisz wartość określonego deskryptora charakterystyki z urządzenia peryferyjnego.

Parametry

  • descriptorId

    tekst

    Identyfikator instancji deskryptora charakterystyki GATT, którego wartość ma zostać zapisana.

  • wartość

    ArrayBuffer

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

  • callback

    function opcjonalne

    Parametr callback wygląda tak:

    () => void

Zwroty

  • thought Promise<void>

    Chrome 91 lub nowsza wersja

    Obiekty Promise są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Na innych platformach należy używać wywołań zwrotnych.

Wydarzenia

onCharacteristicReadRequest

Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne żąda odczytu wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na tę prośbę przez dłuższy czas, może to doprowadzić do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

onCharacteristicValueChanged

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

Uruchamiane, gdy wartość zdalnej charakterystyki GATT ulega zmianie w wyniku żądania odczytu lub powiadomienia/wskazania zmiany wartości. To zdarzenie zostanie wysłane tylko wtedy, gdy aplikacja włączy powiadomienia przez wywołanie startCharacteristicNotifications.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne żąda zapisania wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na tę prośbę przez dłuższy czas, może to doprowadzić do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

onDescriptorReadRequest

Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne żąda odczytania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na tę prośbę przez dłuższy czas, może to doprowadzić do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

onDescriptorValueChanged

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

Uruchamiane, gdy zmienia się wartość deskryptora charakterystyki zdalnego GATT, zwykle w wyniku żądania odczytu. To zdarzenie istnieje głównie dla wygody i będzie zawsze wysyłane po udanym wywołaniu metody readDescriptorValue.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 lub nowsza wersja 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone urządzenie centralne żąda zapisania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na tę prośbę przez dłuższy czas, może to doprowadzić do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy aplikacja ma uprawnienia bluetooth:low_energy i bluetooth:peripheral ustawione na wartość true. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne we wszystkich aplikacjach.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

onServiceAdded

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

Uruchamiane, gdy na urządzeniu zdalnym zostanie wykryta nowa usługa GATT.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (service: Service) => void

onServiceChanged

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

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

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (service: Service) => void

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.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (service: Service) => void