chrome.bluetoothLowEnergy

Opis

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

Dostępność

Tylko ChromeOS

Plik manifestu

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

"bluetooth"

Typy

Advertisement

Chrome 47 lub nowszy

Właściwości

  • manufacturerData

    ManufacturerData[] opcjonalny

    Lista danych specyficznych dla producenta, które należy uwzględnić w polach „Dane specyficzne dla producenta” w danych dotyczących reklam.

  • serviceData

    ServiceData[] opcjonalny

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

  • serviceUuids

    string[] opcjonalny

    Lista identyfikatorów UUID do uwzględnienia w polu „Service UUIDs” (Identyfikatory UUID usługi) w danych reklamowych. Identyfikatory UUID mogą być w formatach 16-bitowym, 32-bitowym lub 128-bitowym.

  • solicitUuids

    string[] opcjonalny

    Lista identyfikatorów UUID do uwzględnienia w polu „Solicit UUIDs” (Prośba o identyfikatory UUID) w danych reklamowych. Identyfikatory UUID mogą być w formatach 16-bitowym, 32-bitowym lub 128-bitowym.

  • Typ reklamy.

AdvertisementType

Chrome 47 lub nowszy

Typ reklamy. Jeśli wybierzesz „broadcast”, wysłany typ reklamy to ADV_NONCONN_IND, a urządzenie będzie nadawać z losowym adresem MAC. Jeśli ma wartość „peripheral”, typ reklamy to ADV_IND lub ADV_SCAN_IND, a urządzenie będzie transmitować 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żyj identyfikatora instancji, aby odróżnić cechy urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywać wywołania funkcji, 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

    ciąg znaków

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

  • wartość

    ArrayBuffer opcjonalny

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

CharacteristicProperty

Wartości reprezentujące możliwe właściwości cechy. Uprawnienia charakterystyczne są wywnioskowane z 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 po zamknięciu strony wydarzenia aplikacji (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false..

Descriptor

Właściwości

  • charakterystyczny,

    Characteristic opcjonalny

    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 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

    Uprawnienia tego deskryptora.

  • uuid

    ciąg znaków

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

  • wartość

    ArrayBuffer opcjonalny

    Obecnie zapisana w pamięci podręcznej wartość deskryptora. Ta wartość jest aktualizowana po odczytaniu wartości deskryptora.

DescriptorPermission

Chrome 52 lub nowsza

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

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 na stronie 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 lub nowsza

Właściwości

  • shouldIndicate

    wartość logiczna opcjonalna

    Opcjonalna flaga do wysyłania sygnału 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 wydarzenia aplikacji zostanie zwolniona (patrz Zarządzanie cyklem życia aplikacji). (wartością domyślną jest false);

Request

Chrome 52 lub nowsza

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, gdy będziesz odpowiadać na to żądanie.

  • wartość

    ArrayBuffer opcjonalny

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

Response

Chrome 52 lub nowsza

Właściwości

  • isError

    Wartość logiczna

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

  • requestId

    liczba

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

  • wartość

    ArrayBuffer opcjonalny

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

Service

Właściwości

  • deviceAddress

    ciąg znaków opcjonalny

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

  • instanceId

    ciąg znaków opcjonalny

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

  • isPrimary

    Wartość logiczna

    Wskazuje, czy typ tej usługi jest podstawowy czy dodatkowy.

  • 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[]

  • uuid

    ciąg znaków

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 dostępne bez wywoływania funkcji connect. Aplikacja, która chce uzyskać dostęp do usług GATT urządzenia, powinna jednak wywołać tę funkcję, aby mieć pewność, że połączenie z urządzeniem jest utrzymywane. Jeśli urządzenie nie jest połączone, wszystkie usługi GATT urządzenia zostaną wykryte po pomyślnym wywołaniu funkcji connect.

Parametry

  • deviceAddress

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego, z którym należy otworzyć połączenie GATT.

  • właściwości

    ConnectProperties opcjonalny

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

createCharacteristic()

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

Utwórz charakterystykę GATT hostowaną lokalnie. 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 w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • charakterystyczny,

    Cechy

    Charakterystyka do utworzenia.

  • serviceId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (characteristicId: string) => void

    • characteristicId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

createDescriptor()

Promise Chrome 52 lub nowszy 
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 ustawiona zmienna lastError. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • deskryptor,

    Descriptor

    Deskryptor do utworzenia.

  • characteristicId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (descriptorId: string) => void

    • descriptorId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

createService()

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

Utwórz lokalnie hostowaną usługę GATT. Usługę można zarejestrować, aby była dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • usługa

    Usługa

    Usługa do utworzenia.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (serviceId: string) => void

    • serviceId

      ciąg znaków

Zwroty

  • Promise<string>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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

    ciąg znaków

    Adres Bluetooth urządzenia zdalnego.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getCharacteristic()

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

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

Parametry

  • characteristicId

    ciąg znaków

    Identyfikator instancji żądanej charakterystyki GATT.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Characteristic) => void

Zwroty

  • Promise<Characteristic>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getCharacteristics()

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

Pobierz listę wszystkich wykrytych charakterystyk GATT należących do danej usługi.

Parametry

  • serviceId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Characteristic[]) => void

Zwroty

  • Promise<Characteristic[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getDescriptor()

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

Pobiera deskryptor charakterystyki GATT o podanym identyfikatorze instancji.

Parametry

  • descriptorId

    ciąg znaków

    Identyfikator instancji deskryptora charakterystyki GATT, o który prosisz.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Descriptor) => void

Zwroty

  • Promise<Descriptor>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getDescriptors()

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

Pobierz listę deskryptorów charakterystyki GATT należących do danej charakterystyki.

Parametry

  • characteristicId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Descriptor[]) => void

Zwroty

  • Promise<Descriptor[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Service[]) => void

Zwroty

  • Promise<Service[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

getService()

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

Pobierz usługę GATT o podanym identyfikatorze instancji.

Parametry

  • serviceId

    ciąg znaków

    Identyfikator instancji żądanej usługi GATT.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Service) => void

Zwroty

  • Promise<Service>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 na urządzeniu nie zostało jeszcze zakończone, to interfejs API zwróci podzbiór usług (który może być pusty). Obejście tego problemu polega na dodaniu opóźnienia opartego na czasie lub wielokrotnym wywoływaniu, dopóki nie zostanie zwrócona oczekiwana liczba usług.

Parametry

  • deviceAddress

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Service[]) => void

Zwroty

  • Promise<Service[]>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

notifyCharacteristicValueChanged()

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

Powiadamianie urządzenia zdalnego o nowej wartości cechy. Jeśli flaga shouldIndicate w obiekcie powiadomienia ma wartość „true”, zamiast powiadomienia zostanie wysłana informacja. 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 w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • characteristicId

    ciąg znaków

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

  • powiadomienie

    Powiadomienie

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

readCharacteristicValue()

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

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

Parametry

  • characteristicId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Characteristic) => void

Zwroty

  • Promise<Characteristic>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

readDescriptorValue()

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

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

Parametry

  • descriptorId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (result: Descriptor) => void

Zwroty

  • Promise<Descriptor>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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 wyświetlania. 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 w przypadku automatycznie uruchamianych aplikacji 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: niektóre urządzenia obsługują jednocześnie tryb centralny i peryferyjny, ale na urządzeniach, które tego nie obsługują, wywołanie tej funkcji 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 zachowanie lub uniemożliwi prawidłowe działanie innych aplikacji pełniących rolę centralną (w tym wykrywanie urządzeń Bluetooth Low Energy).

Parametry

  • reklama

    Reklama

    Reklama, którą chcesz reklamować.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    (advertisementId: number) => void

    • advertisementId

      liczba

Zwroty

  • Promise<number>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

registerService()

Promise Chrome 52 lub nowszy 
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 ustawiona wartość lastError. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator utworzonej usługi.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

removeService()

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

Usuwa określoną usługę, wyrejestrowując ją, jeśli była zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiona wartość lastError. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

resetAdvertising()

Promise Chrome 61 lub nowszy 
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

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

sendRequestResponse()

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

Wysyła odpowiedź na żądanie odczytu lub zapisu charakterystyki lub deskryptora. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

setAdvertisingInterval()

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

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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

    ciąg znaków

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

  • właściwości

    NotificationProperties opcjonalne

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

stopCharacteristicNotifications()

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

Wyłącza powiadomienia/wskazania wartości z określonej charakterystyki. Po udanej rozmowie aplikacja przestanie otrzymywać powiadomienia lub sygnały z tego atrybutu.

Parametry

  • characteristicId

    ciąg znaków

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

unregisterAdvertisement()

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

Wyrejestrowuje reklamę i przestaje ją wyświetlać. Jeśli rozgłaszanie nie zostanie wyrejestrowane, jedynym sposobem na zatrzymanie rozgłaszania może być ponowne uruchomienie urządzenia.

Parametry

  • advertisementId

    liczba

    Identyfikator reklamy, której rejestrację chcesz anulować.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

unregisterService()

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

Wyrejestrowuje daną usługę na lokalnym serwerze GATT. Jeśli identyfikator usługi jest nieprawidłowy, zostanie ustawiona wartość lastError. Ta funkcja jest dostępna tylko wtedy, gdy w przypadku uprawnień bluetooth:low_energy i bluetooth:peripheral ustawiono wartość „true”. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • serviceId

    ciąg znaków

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

writeCharacteristicValue()

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

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

Parametry

  • characteristicId

    ciąg znaków

    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

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą 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

    ciąg znaków

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

  • wartość

    ArrayBuffer

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

  • callback

    funkcja opcjonalna

    Parametr callback wygląda tak:

    () => void

Zwroty

  • Promise<void>

    Chrome 91 lub nowsza

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych. Inne platformy muszą używać wywołań zwrotnych.

Wydarzenia

onCharacteristicReadRequest

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

Wywoływane, gdy połączone urządzenie centralne wysyła żądanie odczytania wartości charakterystyki zarejestrowanej na lokalnym serwerze GATT. Brak odpowiedzi na tę prośbę przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy w aplikacji uprawnienia bluetooth:low_energy i bluetooth:peripheral mają wartość true. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • żądanie

      Żądanie

    • characteristicId

      ciąg znaków

onCharacteristicValueChanged

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

Występuje, gdy wartość zdalnej charakterystyki GATT ulegnie zmianie w wyniku żądania odczytu lub powiadomienia/wskazania o zmianie wartości. To zdarzenie jest wysyłane tylko wtedy, gdy aplikacja włączyła powiadomienia, wywołując metodę startCharacteristicNotifications.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (characteristic: Characteristic) => void

    • charakterystyczny,

      Cechy

onCharacteristicWriteRequest

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

Wywoływane, gdy połączone urządzenie centralne wysyła żądanie zapisu wartości charakterystyki zarejestrowanej na lokalnym serwerze GATT. Brak odpowiedzi na tę prośbę przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy w aplikacji uprawnienia bluetooth:low_energy i bluetooth:peripheral mają wartość true. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • żądanie

      Żądanie

    • characteristicId

      ciąg znaków

onDescriptorReadRequest

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

Wywoływane, gdy połączone urządzenie centralne wysyła żądanie odczytania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Brak odpowiedzi na tę prośbę przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy w aplikacji uprawnienia bluetooth:low_energy i bluetooth:peripheral mają wartość true. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • żądanie

      Żądanie

    • descriptorId

      ciąg znaków

onDescriptorValueChanged

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

Występuje, gdy wartość zdalnego deskryptora charakterystyki GATT ulegnie zmianie, zwykle w wyniku żądania odczytu. To zdarzenie jest wysyłane głównie dla wygody i zawsze po udanym wywołaniu funkcji readDescriptorValue.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

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

Wywoływane, gdy połączone urządzenie centralne wysyła żądanie zapisu wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Brak odpowiedzi na tę prośbę przez dłuższy czas może spowodować rozłączenie. To zdarzenie jest dostępne tylko wtedy, gdy w aplikacji uprawnienia bluetooth:low_energy i bluetooth:peripheral mają wartość true. Uprawnienia do urządzeń peryferyjnych mogą nie być dostępne w przypadku wszystkich aplikacji.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

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

    • żądanie

      Żądanie

    • descriptorId

      ciąg znaków

onServiceAdded

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

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

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (service: Service) => void

onServiceChanged

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

Wywoływane, gdy zmieni się stan zdalnej usługi GATT. Obejmuje to wszelkie cechy lub deskryptory 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,
)

Wysyłane, gdy usunięto usługę GATT, która została wcześniej wykryta na urządzeniu zdalnym.

Parametry

  • callback

    funkcja

    Parametr callback wygląda tak:

    (service: Service) => void