chrome.bluetoothLowEnergy

Opis

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

Plik manifestu

Aby można było używać tego interfejsu API, następujące klucze muszą być zadeklarowane w pliku manifestu.

"bluetooth"

Typy

Advertisement

Chrome 47 i nowsze wersje

Właściwości

  • manufacturerData

    ManufacturerData[] opcjonalny

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

  • serviceData

    ServiceData[] opcjonalny

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

  • serviceUuids

    string[] opcjonalny

    Lista identyfikatorów UUID, które mają zostać uwzględnione w polu „UUID usługi” Danych reklamowych. Identyfikatory te mogą być w formacie 16-, 32- lub 128-bitowym.

  • solicitUuids

    string[] opcjonalny

    Lista identyfikatorów UUID, które mają zostać uwzględnione w polu „Poproś o identyfikatory UUID” Danych reklamowych. Identyfikatory te mogą być w formacie 16-, 32- lub 128-bitowym.

  • Typ reklamy.

AdvertisementType

Chrome 47 i nowsze wersje

Typ reklamy. Jeśli wybrana jest opcja „transmisja”, typ wysyłanej reklamy to ADV_NONCONN_IND, a urządzenie będzie transmitować z losowym adresem MAC. Jeśli ustawisz wartość „peryferyjne”, typem reklamy będzie ADV_IND lub ADV_SCAN_IND, a urządzenie będzie przesyłać z użyciem rzeczywistego adresu MAC adaptera Bluetooth.

Enum

Characteristic

Właściwości

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej cechy. Identyfikator instancji służy do rozróżniania cech urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator cech. Występuje, jeśli to wystąpienie reprezentuje cechę zdalną.

  • Właściwości tej cechy.

  • usługa

    Usługa opcjonalnie

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

  • uuid

    string,

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

  • value

    Tablica SlateBuffer opcjonalna

    Aktualnie zapisana wartość cechy. Ta wartość jest aktualizowana, gdy wartość cechy zostanie odczytana lub zaktualizowana za pomocą powiadomienia lub wskaźnika.

CharacteristicProperty

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

Enum

"read"

"writeWithoutResponse"

"write"

"indicate"

"authenticatedSignedWrites"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Właściwości

  • trwałe

    boolean

    Flaga z informacją, czy połączenie z urządzeniem jest otwarte po wyładowaniu strony zdarzenia aplikacji (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false..

Descriptor

Właściwości

  • charakterystyczne

    Charakter opcjonalny

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

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tego deskryptora. Identyfikator instancji służy do rozróżniania deskryptorów z urządzeń peryferyjnych o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator deskryptora. Występuje, jeśli to wystąpienie reprezentuje cechę zdalną.

  • uprawnienia

    DescriptorPermission[]

    Chrome 52 i nowsze wersje

    Uprawnienia do tego deskryptora.

  • uuid

    string,

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

  • value

    Tablica SlateBuffer opcjonalna

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

DescriptorPermission

Chrome 52 i nowsze wersje

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

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 i nowsze wersje

Właściwości

  • adres

    string,

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

  • deviceClass

    Liczba opcjonalnie

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

  • nazwa

    ciąg znaków opcjonalny

    Czytelna dla człowieka nazwa urządzenia.

ManufacturerData

Chrome 47 i nowsze wersje

Właściwości

  • dane

    liczba[]

  • id

    Liczba

Notification

Chrome 52 i nowsze wersje

Właściwości

  • shouldIndicate

    wartość logiczna opcjonalna

    Opcjonalna flaga wysyłania wskaźnika zamiast powiadomienia.

  • value

    ArrayBuffer

    Nowa wartość cechy.

NotificationProperties

Właściwości

  • trwałe

    boolean

    Flaga określająca, czy aplikacja powinna otrzymywać powiadomienia po wyładowaniu strony zdarzenia z aplikacji (patrz Zarządzanie cyklem życia aplikacji). Wartością domyślną jest false.

Request

Chrome 52 i nowsze wersje

Właściwości

  • urządzenie

    Urządzenie

    Urządzenie, z którego wysłano tę prośbę.

  • requestId

    Liczba

    Unikalny identyfikator żądania. Użyj tego identyfikatora, gdy odpowiadasz na to żądanie.

  • value

    Tablica SlateBuffer opcjonalna

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

Response

Chrome 52 i nowsze wersje

Właściwości

  • isError

    boolean

    Jeśli jest to odpowiedź o błędzie, pole musi mieć wartość prawda.

  • requestId

    Liczba

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

  • value

    Tablica SlateBuffer opcjonalna

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

Service

Właściwości

  • deviceAddress

    ciąg znaków opcjonalny

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

  • instanceId

    ciąg znaków opcjonalny

    Zwraca identyfikator przypisany do tej usługi. Identyfikator instancji służy do rozróżniania usług z urządzenia peryferyjnego o tym samym identyfikatorze UUID i wykonywania wywołań funkcji, które przyjmują identyfikator usługi. Występuje, jeśli ta instancja reprezentuje usługę zdalną.

  • isPrimary

    boolean

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

  • uuid

    string,

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

ServiceData

Chrome 47 i nowsze wersje

Właściwości

  • dane

    liczba[]

  • uuid

    string,

Metody

connect()

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

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

Parametry

  • deviceAddress

    string,

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

  • usługi

    ConnectProperties opcjonalnie

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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ą cechę GATT. Ta cecha musi być hostowana w prawidłowej usłudze. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • charakterystyczne

    Cechy

    Cecha do utworzenia.

  • serviceId

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (characteristicId: string)=>void

    • characteristicId

      string,

Akcje powrotne

  • Obietnica<string>

    Chrome 91 i nowsze wersje

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

Utwórz deskryptor GATT hostowany lokalnie. Ten deskryptor musi być hostowany z prawidłową cechą. Jeśli identyfikator cechy jest nieprawidłowy, ustawiany jest parametr lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • deskryptor

    Deskryptor

    Deskryptor do utworzenia.

  • characteristicId

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (descriptorId: string)=>void

    • descriptorId

      string,

Akcje powrotne

  • Obietnica<string>

    Chrome 91 i nowsze wersje

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

createService()

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

utworzyć usługę GATT hostowaną lokalnie. Usługa może zostać zarejestrowana jako dostępna na lokalnym serwerze GATT. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • usługa

    Usługa

    Usługa do utworzenia.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (serviceId: string)=>void

    • serviceId

      string,

Akcje powrotne

  • Obietnica<string>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 samego linku fizycznego, ponieważ mogą istnieć inne aplikacje z otwartymi połączeniami.

Parametry

  • deviceAddress

    string,

    Adres Bluetooth urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

getCharacteristic()

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

Pobierz cechę GATT z podanym identyfikatorem instancji, który należy do danej usługi GATT (jeśli istnieje).

Parametry

  • characteristicId

    string,

    Identyfikator instancji żądanej cechy GATT.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Characteristic)=>void

Akcje powrotne

  • Promise<Characteristic>

    Chrome 91 i nowsze wersje

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

getCharacteristics()

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

uzyskać listę wszystkich wykrytych cech GATT, które należą do danej usługi;

Parametry

  • serviceId

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Characteristic[])=>void

Akcje powrotne

  • Promise<Characteristic[]>

    Chrome 91 i nowsze wersje

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

getDescriptor()

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

Pobierz deskryptor cechy GATT z podanym identyfikatorem instancji.

Parametry

  • descriptorId

    string,

    Identyfikator instancji żądanego deskryptora cechy GATT.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Descriptor)=>void

Akcje powrotne

  • Promise<Descriptor>

    Chrome 91 i nowsze wersje

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

getDescriptors()

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

Uzyskaj listę deskryptorów cech GATT, które należą do danej cechy.

Parametry

  • characteristicId

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Descriptor[])=>void

Akcje powrotne

  • Promise<Descriptor[]>

    Chrome 91 i nowsze wersje

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

getIncludedServices()

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

Uzyskaj listę usług GATT, które są zawarte w danej usłudze.

Parametry

  • serviceId

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Service[])=>void

Akcje powrotne

  • Obietnica<Usługa[]>

    Chrome 91 i nowsze wersje

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

  • serviceId

    string,

    Identyfikator instancji żądanej usługi GATT.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Service)=>void

Akcje powrotne

  • Obiecywanie<Usługa>

    Chrome 91 i nowsze wersje

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

getServices()

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

Pobierz wszystkie usługi GATT wykryte na urządzeniu zdalnym za pomocą podanego adresu.

Uwaga: jeśli wykrywanie usług na urządzeniu nie zostało ukończone, ten interfejs API zwróci podzbiór usług (prawdopodobnie pusty). Aby obejść ten problem, należy dodać opóźnienie zależne od czasu lub wielokrotne wywoływanie połączenia do momentu zwrócenia oczekiwanej liczby usług.

Parametry

  • deviceAddress

    string,

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Service[])=>void

Akcje powrotne

  • Obietnica<Usługa[]>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 zdalne urządzenie o nowej wartości cechy. Jeśli flaga powinnaWskazuje w obiekcie powiadomienia, że ma wartość Prawda, zamiast powiadomienia będzie wysyłany odpowiedni sygnał. Pamiętaj, że aby wywołanie to było skuteczne, cecha musi podczas tworzenia poprawnie ustawić właściwość „notify” lub „indicate”. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • characteristicId

    string,

    Cecha, dla której należy wysłać powiadomienie.

  • powiadomienie

    Powiadomienie

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

readCharacteristicValue()

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

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

Parametry

  • characteristicId

    string,

    Identyfikator instancji cechy GATT, której wartość należy odczytać z urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Characteristic)=>void

Akcje powrotne

  • Promise<Characteristic>

    Chrome 91 i nowsze wersje

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

readDescriptorValue()

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

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

Parametry

  • descriptorId

    string,

    Identyfikator instancji deskryptora cechy GATT, którego wartość należy odczytać z urządzenia zdalnego.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (result: Descriptor)=>void

Akcje powrotne

  • Promise<Descriptor>

    Chrome 91 i nowsze wersje

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

registerAdvertisement()

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

Utwórz reklamę i zarejestruj ją w celu wyświetlania reklam. Aby wywołać tę funkcję, w aplikacji muszą być ustawione uprawnienia bluetooth:low_energy i bluetooth:peryferia na wartość Prawda. Dodatkowo ten interfejs API jest dostępny tylko w przypadku aplikacji uruchamianych automatycznie w trybie kiosku lub po ustawieniu przełącznika wiersza poleceń „--enable-ble-advertising-in-apps”. Więcej informacji znajdziesz na stronie https://developer.chrome.com/apps/manifest/Bluetooth W przypadku sprzętu, który nie obsługuje zarówno trybu centralnego, jak i peryferyjnego, próba użycia urządzenia w obu trybach spowoduje niezdefiniowane zachowanie lub uniemożliwi prawidłowe działanie innych aplikacji głównych (w tym wykrywanie urządzeń Bluetooth Low Energy).

Parametry

  • reklama

    Reklama

    Reklama, która ma być reklamowana.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    (advertisementId: number)=>void

    • advertisementId

      Liczba

Akcje powrotne

  • Obietnica<number>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • serviceId

    string,

    Unikalny identyfikator utworzonej usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 została zarejestrowana. Jeśli identyfikator usługi jest nieprawidłowy, ustawiany jest błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • serviceId

    string,

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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. Wszystkie istniejące reklamy zostaną wyrejestrowane i wstrzymane.

Parametry

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

sendRequestResponse()

Chrome 52 i nowsze wersje 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
)

Wysyła odpowiedź na żądanie odczytu/zapisu dla cechy lub deskryptora. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

setAdvertisingInterval()

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

Ustaw odstęp między dwiema kolejnymi reklamami. Uwaga: jest to najlepsza opcja. Rzeczywisty odstęp może odbiegać od żądanych przedziałów. Na niektórych urządzeniach odstęp minimalny to 100 ms. Minimalna i maksymalna wartość nie mogą przekraczać zakresu dozwolonego w specyfikacji Bluetooth 4.2.

Parametry

  • minInterval

    Liczba

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

  • maxInterval

    Liczba

    Maksymalny odstęp między reklamami (w milisekundach). Nie może to być więcej niż 10 240 ms (zgodnie ze specyfikacją).

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

startCharacteristicNotifications()

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

Włącz powiadomienia o wartościach z określonej cechy. Po włączeniu tej funkcji aplikacja może nasłuchiwać powiadomień, korzystając ze zdarzenia onCharacteristicValueChanged.

Parametry

  • characteristicId

    string,

    Identyfikator instancji cechy GATT, dla której mają być włączone powiadomienia.

  • usługi

    Opcjonalne NotificationProperties

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

stopCharacteristicNotifications()

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

Wyłącz powiadomienia/wskaźniki dotyczące wartości określonej cechy. Po udanym połączeniu aplikacja przestanie otrzymywać powiadomienia/wskaźniki z tej cechy.

Parametry

  • characteristicId

    string,

    Identyfikator wystąpienia cechy GATT, w której przypadku należy zatrzymać sesję powiadomień z tej aplikacji.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

unregisterAdvertisement()

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

Wyrejestrowuje reklamę i przerywa jej wyświetlanie. Jeśli reklama się nie wyrejestruje, jedynym sposobem na wstrzymanie wyświetlania jest ponowne uruchomienie urządzenia.

Parametry

  • advertisementId

    Liczba

    Identyfikator reklamy do wyrejestrowania.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

    Obietnice są obsługiwane tylko w przypadku platformy Manifest V3 i nowszych platform. 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 błąd lastError. Ta funkcja jest dostępna tylko wtedy, gdy dla aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:peryferyjnych mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • serviceId

    string,

    Unikalny identyfikator aktualnie zarejestrowanej usługi.

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

writeCharacteristicValue()

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

Zapisz wartość określonej cechy na zdalnym urządzeniu peryferyjnym.

Parametry

  • characteristicId

    string,

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

  • value

    ArrayBuffer

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

writeDescriptorValue()

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

Zapisz wartość określonego deskryptora cechy na zdalnym urządzeniu peryferyjnym.

Parametry

  • descriptorId

    string,

    Identyfikator instancji deskryptora cechy GATT, w którym powinna zostać zapisana wartość.

  • value

    ArrayBuffer

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

  • wywołanie zwrotne

    funkcja opcjonalnie

    Parametr callback wygląda tak: 

    ()=>void

Akcje powrotne

  • Promise<void>

    Chrome 91 i nowsze wersje

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

Wydarzenia

onCharacteristicReadRequest

Chrome 52 i nowsze wersje 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Uruchamiany, gdy podłączone urządzenie centralne prosi o odczyt wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

onCharacteristicValueChanged

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

Uruchamiane, gdy wartość zdalnej cechy GATT zmieni się w wyniku żądania odczytu albo powiadomienia lub komunikatu o zmianie wartości. To zdarzenie będzie wysyłane tylko wtedy, gdy aplikacja włączyła powiadomienia przez wywołanie metody startCharacteristicNotifications.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (characteristic: Characteristic)=>void

    • charakterystyczne

      Cechy

onCharacteristicWriteRequest

Chrome 52 i nowsze wersje 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Uruchamiany, gdy połączone centralne urządzenie wysyła żądanie zapisania wartości cechy zarejestrowanej na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

onDescriptorReadRequest

Chrome 52 i nowsze wersje 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone centralne urządzenie wysyła żądanie odczytu wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

onDescriptorValueChanged

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

Uruchamiane, gdy wartość zdalnego deskryptora cechy GATT zmienia się, zwykle w wyniku żądania odczytu. To zdarzenie powstało głównie dla wygody użytkowników i zawsze jest wysyłane po udanym wywołaniu do readDescriptorValue.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (descriptor: Descriptor)=>void

onDescriptorWriteRequest

Chrome 52 i nowsze wersje 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Uruchamiane, gdy połączone centralne urządzenie wysyła żądanie zapisania wartości deskryptora zarejestrowanego na lokalnym serwerze GATT. Jeśli nie odpowiesz na to żądanie przez dłuższy czas, może dojść do rozłączenia. To zdarzenie jest dostępne tylko wtedy, gdy w przypadku aplikacji uprawnienia bluetooth:low_energy i ustawienia bluetooth:urządzenia peryferyjnego mają wartość Prawda. Uprawnienia dotyczące urządzeń peryferyjnych mogą nie być dostępne dla wszystkich aplikacji.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

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

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 dowolne cechy lub deskryptory, które zostaną dodane do usługi lub z niej usunięte, a także powiadomienia „ServiceChanged” z urządzenia zdalnego.

Parametry

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (service: Service)=>void

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

  • wywołanie zwrotne

    funkcja

    Parametr callback wygląda tak: 

    (service: Service)=>void