chrome.bluetoothLowEnergy

Beschreibung

Die chrome.bluetoothLowEnergy API wird für die Kommunikation mit Bluetooth Smart-Geräten (Low Energy) über das Generic Attribute Profile (GATT) verwendet.

Verfügbarkeit

Nur ChromeOS

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, um diese API zu verwenden.

"bluetooth"

Typen

Advertisement

Chrome 47 oder höher

Attribute

  • manufacturerData

    ManufacturerData[] optional

    Liste der herstellerspezifischen Daten, die in die Felder „Herstellerspezifische Daten“ der Werbedaten aufgenommen werden sollen.

  • serviceData

    ServiceData[] optional

    Liste der Dienstdaten, die in die Felder „Service Data“ der Werbedaten aufgenommen werden sollen.

  • serviceUuids

    string[] optional

    Liste der UUIDs, die im Feld „Service UUIDs“ (Dienst-UUIDs) der Advertising Data (Werbedaten) enthalten sein sollen. Diese UUIDs können im 16-Bit-, 32-Bit- oder 128-Bit-Format vorliegen.

  • solicitUuids

    string[] optional

    Liste der UUIDs, die in das Feld „Solicit UUIDs“ der Werbedaten aufgenommen werden sollen. Diese UUIDs können im 16-Bit-, 32-Bit- oder 128-Bit-Format vorliegen.

  • Anzeigentyp.

AdvertisementType

Chrome 47 oder höher

Anzeigentyp. Wenn „broadcast“ ausgewählt ist, wird der gesendete Advertisement-Typ ADV_NONCONN_IND sein und das Gerät sendet mit einer zufälligen MAC-Adresse. Wenn „Peripheriegerät“ festgelegt ist, ist der Advertisement-Typ ADV_IND oder ADV_SCAN_IND und das Gerät sendet mit der MAC-Adresse des echten Bluetooth-Adapters.

Enum

"broadcast"

"peripheral"

Characteristic

Attribute

  • instanceId

    String optional

    Gibt die Kennung zurück, die diesem Merkmal zugewiesen ist. Verwende die Instanz-ID, um zwischen Merkmalen eines Peripheriegeräts mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Merkmals-ID verwenden. Vorhanden, wenn diese Instanz ein Remote-Merkmal darstellt.

  • Properties

    CharacteristicProperty[]

    Die Eigenschaften dieses Merkmals.

  • Dienst

    Service optional

    Der GATT-Dienst, zu dem dieses Merkmal gehört.

  • uuid

    String

    Die UUID des Merkmals, z.B. 00002a37-0000-1000-8000-00805f9b34fb.

  • Wert

    ArrayBuffer optional

    Der aktuell im Cache gespeicherte Wert des Merkmals. Dieser Wert wird aktualisiert, wenn der Wert des Merkmals über eine Benachrichtigung oder Anzeige gelesen oder aktualisiert wird.

CharacteristicProperty

Werte, die die möglichen Eigenschaften eines Merkmals darstellen. Die Berechtigungen für die Merkmale werden von diesen Eigenschaften abgeleitet. Die Bedeutung der einzelnen Eigenschaften finden Sie in der Bluetooth 4.x-Spezifikation.

Enum

"broadcast"

"read"

"writeWithoutResponse"

"write"

"notify"

"indicate"

"authenticatedSignedWrites"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Attribute

  • nichtflüchtige

    boolean

    Flag, das angibt, ob eine Verbindung zum Gerät offen bleibt, wenn die Ereignisseite der Anwendung entladen wird (siehe Manage App Lifecycle). Der Standardwert ist false..

Descriptor

Attribute

  • characteristic

    Merkmal optional

    Das GATT-Merkmal, zu dem dieser Deskriptor gehört.

  • instanceId

    String optional

    Gibt die diesem Deskriptor zugewiesene Kennung zurück. Verwenden Sie die Instanz-ID, um zwischen Deskriptoren von einem Peripheriegerät mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Deskriptor-ID verwenden. Vorhanden, wenn diese Instanz ein Remote-Merkmal darstellt.

  • Berechtigungen

    DescriptorPermission[]

    Chrome 52 oder höher

    Die Berechtigungen dieses Deskriptors.

  • uuid

    String

    Die UUID des Merkmalsdeskriptors, z.B. 00002902-0000-1000-8000-00805f9b34fb.

  • Wert

    ArrayBuffer optional

    Der aktuell im Cache gespeicherte Deskriptorwert. Dieser Wert wird aktualisiert, wenn der Wert des Deskriptors gelesen wird.

DescriptorPermission

Chrome 52 oder höher

Werte, die mögliche Berechtigungen für einen Deskriptor darstellen. Die Bedeutung der einzelnen Berechtigungen finden Sie in der Bluetooth 4.x-Spezifikation.

Enum

"read"

"write"

"encryptedRead"

"encryptedWrite"

"encryptedAuthenticatedRead"

"encryptedAuthenticatedWrite"

Device

Chrome 52 oder höher

Attribute

  • Adresse

    String

    Die Adresse des Geräts im Format „XX:XX:XX:XX:XX:XX“.

  • deviceClass

    number optional

    Die Klasse des Geräts, ein Bitfeld, das unter http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband definiert ist.

  • name

    String optional

    Der menschenlesbare Name des Geräts.

ManufacturerData

Chrome 47 oder höher

Attribute

  • Daten

    number[]

  • id

    Zahl

Notification

Chrome 52 oder höher

Attribute

  • shouldIndicate

    Boolesch optional

    Optionales Flag zum Senden einer Anzeige anstelle einer Benachrichtigung.

  • Wert

    ArrayBuffer

    Neuer Wert der Eigenschaft.

NotificationProperties

Attribute

  • nichtflüchtige

    boolean

    Flag, das angibt, ob die App Benachrichtigungen erhalten soll, wenn die Ereignisseite der Anwendung entladen wird (siehe App-Lebenszyklus verwalten). Der Standardwert ist false.

Request

Chrome 52 oder höher

Attribute

  • Gerät

    Gerät

    Gerät, das diese Anfrage gesendet hat.

  • requestId

    Zahl

    Eindeutige ID für diese Anfrage. Verwenden Sie diese ID, wenn Sie auf diese Anfrage antworten.

  • Wert

    ArrayBuffer optional

    Zu schreibender Wert (wenn es sich um eine Schreibanfrage handelt).

Response

Chrome 52 oder höher

Attribute

  • isError

    boolean

    Wenn es sich um eine Fehlerantwort handelt, sollte dies „true“ sein.

  • requestId

    Zahl

    ID der Anfrage, auf die sich diese Antwort bezieht.

  • Wert

    ArrayBuffer optional

    Response value (Antwortwert) Schreibanfragen und Fehlerantworten ignorieren diesen Parameter.

Service

Attribute

  • deviceAddress

    String optional

    Die Geräteadresse des Remote-Peripheriegeräts, zu dem der GATT-Dienst gehört. Vorhanden, wenn diese Instanz einen Remotedienst darstellt.

  • instanceId

    String optional

    Gibt die diesem Dienst zugewiesene Kennung zurück. Verwende die Instanz-ID, um zwischen Diensten eines Peripheriegeräts mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Dienstkennung erfordern. Vorhanden, wenn diese Instanz einen Remotedienst darstellt.

  • isPrimary

    boolean

    Gibt an, ob der Typ dieses Dienstes primär oder sekundär ist.

  • uuid

    String

    Die UUID des Dienstes, z.B. 0000180d-0000-1000-8000-00805f9b34fb.

ServiceData

Chrome 47 oder höher

Attribute

  • Daten

    number[]

  • uuid

    String

Methoden

connect()

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

Stellt eine Verbindung zwischen der Anwendung und dem Gerät mit der angegebenen Adresse her. Ein Gerät ist möglicherweise bereits verbunden und seine GATT-Dienste sind verfügbar, ohne dass connect aufgerufen werden muss. Eine App, die auf GATT-Dienste eines Geräts zugreifen möchte, sollte diese Funktion jedoch aufrufen, um sicherzustellen, dass eine Verbindung zum Gerät aufrechterhalten wird. Wenn das Gerät nicht verbunden ist, werden alle GATT-Dienste des Geräts nach einem erfolgreichen Aufruf von connect erkannt.

Parameter

  • deviceAddress

    String

    Die Bluetooth-Adresse des Remote-Geräts, zu dem eine GATT-Verbindung hergestellt werden soll.

  • Properties

    ConnectProperties optional

    Verbindungsattribute (optional).

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

createCharacteristic()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
): Promise<string>

Erstelle ein lokal gehostetes GATT-Merkmal. Dieses Merkmal muss unter einem gültigen Dienst gehostet werden. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • characteristic

    Merkmal

    Das zu erstellende Merkmal.

  • serviceId

    String

    ID des Dienstes, für den dieses Merkmal erstellt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (characteristicId: string) => void

    • characteristicId

      String

Ausgabe

  • Promise<string>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

createDescriptor()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
): Promise<string>

Erstellt einen lokal gehosteten GATT-Deskriptor. Dieser Deskriptor muss unter einem gültigen Merkmal gehostet werden. Wenn die ID des Merkmals ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • Schlagwort

    Deskriptor

    Der zu erstellende Deskriptor.

  • characteristicId

    String

    ID des Merkmals, für das dieser Deskriptor erstellt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (descriptorId: string) => void

    • descriptorId

      String

Ausgabe

  • Promise<string>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

createService()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
): Promise<string>

Erstellt einen lokal gehosteten GATT-Dienst. Dieser Dienst kann registriert werden, um auf einem lokalen GATT-Server verfügbar zu sein. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • Dienst

    Dienst

    Der zu erstellende Dienst.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (serviceId: string) => void

    • serviceId

      String

Ausgabe

  • Promise<string>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

disconnect()

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

Schließt die Verbindung der App zum Gerät mit der angegebenen Adresse. Beachten Sie, dass dadurch nicht immer die physische Verbindung selbst zerstört wird, da möglicherweise andere Apps mit offenen Verbindungen vorhanden sind.

Parameter

  • deviceAddress

    String

    Die Bluetooth-Adresse des Remote-Geräts.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getCharacteristic()

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

Ruft das GATT-Merkmal mit der angegebenen Instanz-ID ab, die zum angegebenen GATT-Dienst gehört, sofern das Merkmal vorhanden ist.

Parameter

  • characteristicId

    String

    Die Instanz-ID des angeforderten GATT-Merkmals.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic) => void

Ausgabe

  • Promise<Characteristic>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getCharacteristics()

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

Ruft eine Liste aller erkannten GATT-Eigenschaften ab, die zum angegebenen Dienst gehören.

Parameter

  • serviceId

    String

    Die Instanz-ID des GATT-Dienstes, dessen Merkmale zurückgegeben werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic[]) => void

Ausgabe

  • Promise<Characteristic[]>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDescriptor()

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

Ruft den GATT-Merkmalsdeskriptor mit der angegebenen Instanz-ID ab.

Parameter

  • descriptorId

    String

    Die Instanz-ID des angeforderten GATT-Merkmalsdeskriptors.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor) => void

Ausgabe

  • Promise<Descriptor>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getDescriptors()

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

Ruft eine Liste der GATT-Merkmalsdeskriptoren ab, die zum angegebenen Merkmal gehören.

Parameter

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, dessen Deskriptoren zurückgegeben werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor[]) => void

Ausgabe

  • Promise<Descriptor[]>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getIncludedServices()

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

Ruft eine Liste der GATT-Dienste ab, die im angegebenen Dienst enthalten sind.

Parameter

  • serviceId

    String

    Die Instanz-ID des GATT-Dienstes, dessen enthaltene Dienste zurückgegeben werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Service[]) => void

Ausgabe

  • Promise<Service[]>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getService()

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

Ruft den GATT-Dienst mit der angegebenen Instanz-ID ab.

Parameter

  • serviceId

    String

    Die Instanz-ID des angeforderten GATT-Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Service) => void

Ausgabe

  • Promise<Service>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

getServices()

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

Ruft alle GATT-Dienste ab, die auf dem Remote-Gerät mit der angegebenen Geräteadresse gefunden wurden.

Hinweis: Wenn die Service Discovery auf dem Gerät noch nicht abgeschlossen ist, gibt diese API eine (möglicherweise leere) Teilmenge von Diensten zurück. Eine Problemumgehung besteht darin, eine zeitbasierte Verzögerung hinzuzufügen und/oder wiederholt aufzurufen, bis die erwartete Anzahl von Diensten zurückgegeben wird.

Parameter

  • deviceAddress

    String

    Die Bluetooth-Adresse des Remote-Geräts, dessen GATT-Dienste zurückgegeben werden sollen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Service[]) => void

Ausgabe

  • Promise<Service[]>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

notifyCharacteristicValueChanged()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
): Promise<void>

Ein Remote-Gerät über einen neuen Wert für ein Merkmal benachrichtigen. Wenn das Flag „shouldIndicate“ im Benachrichtigungsobjekt „true“ ist, wird anstelle einer Benachrichtigung eine Anzeige gesendet. Hinweis: Damit dieser Aufruf erfolgreich ist, muss das Attribut „notify“ oder „indicate“ beim Erstellen des Merkmals korrekt festgelegt werden. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • characteristicId

    String

    Das Merkmal, für das die Benachrichtigung gesendet werden soll.

  • Benachrichtigung

    Benachrichtigung

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

readCharacteristicValue()

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

Den Wert eines angegebenen Merkmals von einem Remote-Peripheriegerät abrufen.

Parameter

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, dessen Wert vom Remote-Gerät gelesen werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic) => void

Ausgabe

  • Promise<Characteristic>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

readDescriptorValue()

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

Ruft den Wert eines angegebenen Merkmalsdeskriptors von einem Remote-Peripheriegerät ab.

Parameter

  • descriptorId

    String

    Die Instanz-ID des GATT-Merkmalsdeskriptors, dessen Wert vom Remote-Gerät gelesen werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor) => void

Ausgabe

  • Promise<Descriptor>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

registerAdvertisement()

Promise Chrome 47 und höher 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
): Promise<number>

Erstellen Sie eine Anzeige und registrieren Sie sie für die Werbung. Damit diese Funktion aufgerufen werden kann, müssen die Berechtigungen „bluetooth:low_energy“ und „bluetooth:peripheral“ der App auf „true“ gesetzt sein. Außerdem ist diese API nur für automatisch gestartete Apps im Kioskmodus oder durch Festlegen des Befehlszeilenschalters „--enable-ble-advertising-in-apps“ verfügbar. Weitere Informationen finden Sie unter https://developer.chrome.com/apps/manifest/bluetooth. Hinweis: Auf einigen Hardwaregeräten werden der zentrale und der periphere Modus gleichzeitig unterstützt. Auf Hardware, die dies nicht unterstützt, wird das Gerät durch diesen Aufruf in den peripheren Modus versetzt. Wenn die Hardware nicht sowohl den Zentral- als auch den Peripheriemodus unterstützt, führt der Versuch, das Gerät in beiden Modi zu verwenden, zu undefiniertem Verhalten oder verhindert, dass andere Anwendungen mit Zentralrolle korrekt funktionieren (einschließlich der Erkennung von Bluetooth Low Energy-Geräten).

Parameter

  • Anzeige

    Werbung

    Die Anzeige, für die geworben werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (advertisementId: number) => void

    • advertisementId

      Zahl

Ausgabe

  • Promise<number>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

registerService()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.registerService(
  serviceId: string,
  callback?: function,
): Promise<void>

Registriert den angegebenen Dienst beim lokalen GATT-Server. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Eindeutige ID eines erstellten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

removeService()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
): Promise<void>

Entfernt den angegebenen Dienst und hebt die Registrierung auf, falls er registriert war. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

resetAdvertising()

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

Setzt die Werbung auf dem aktuellen Gerät zurück. Dadurch werden alle vorhandenen Advertisements abgemeldet und beendet.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

sendRequestResponse()

Chrome 52 oder höher 
chrome.bluetoothLowEnergy.sendRequestResponse(
  response: Response,
): void

Sendet eine Antwort auf eine Lese-/Schreibanfrage für ein Merkmal oder einen Deskriptor. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • Antwort

    Antwort

    Die Antwort auf die Anfrage.

setAdvertisingInterval()

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

Legt das Intervall zwischen zwei aufeinanderfolgenden Advertisements fest. Hinweis: Dies ist ein Best-Effort-Ansatz. Das tatsächliche Intervall kann erheblich von den angeforderten Intervallen abweichen. Auf einigen Hardwaregeräten beträgt das Mindestintervall 100 ms. Die Mindest- und Höchstwerte dürfen den in der Bluetooth 4.2-Spezifikation zulässigen Bereich nicht überschreiten.

Parameter

  • minInterval

    Zahl

    Mindestintervall zwischen Anzeigen (in Millisekunden). Dieser Wert darf nicht unter 20 ms liegen (gemäß Spezifikation).

  • maxInterval

    Zahl

    Maximales Intervall zwischen Advertisements (in Millisekunden). Dieser Wert darf nicht mehr als 10.240 ms betragen (gemäß Spezifikation).

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

startCharacteristicNotifications()

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

Wertbenachrichtigungen/-anzeigen für das angegebene Merkmal aktivieren. Nach der Aktivierung kann eine Anwendung Benachrichtigungen über das Ereignis onCharacteristicValueChanged empfangen.

Parameter

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, für das Benachrichtigungen aktiviert werden sollen.

  • Properties

    NotificationProperties optional

    Eigenschaften der Benachrichtigungssitzung (optional).

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

stopCharacteristicNotifications()

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

Wertbenachrichtigungen/-anzeigen für das angegebene Merkmal deaktivieren. Nach einem erfolgreichen Aufruf empfängt die Anwendung keine Benachrichtigungen/Anzeigen mehr von diesem Merkmal.

Parameter

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, für das die Benachrichtigungssitzung dieser App beendet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

unregisterAdvertisement()

Promise Chrome 47 und höher 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
): Promise<void>

Meldet ein Advertisement ab und beendet das Advertising. Wenn die Abmeldung der Werbung fehlschlägt, kann es sein, dass die Werbung nur durch einen Neustart des Geräts beendet werden kann.

Parameter

  • advertisementId

    Zahl

    ID der Anzeige, die abgemeldet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

unregisterService()

Promise Chrome 52 und höher 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
): Promise<void>

Meldet den angegebenen Dienst vom lokalen GATT-Server ab. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

writeCharacteristicValue()

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

Schreibt den Wert eines angegebenen Merkmals von einem Remote-Peripheriegerät.

Parameter

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, dessen Wert geschrieben werden soll.

  • Wert

    ArrayBuffer

    Der Wert, der als Teil der Schreibanfrage an das Remote-Merkmal gesendet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

writeDescriptorValue()

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

Schreibt den Wert eines angegebenen Merkmalsdeskriptors von einem Remote-Peripheriegerät.

Parameter

  • descriptorId

    String

    Die Instanz-ID des GATT-Merkmalsdeskriptors, dessen Wert geschrieben werden soll.

  • Wert

    ArrayBuffer

    Der Wert, der als Teil der Schreibanfrage an den Remote-Deskriptor gesendet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Ausgabe

  • Promise<void>

    Chrome 91 oder höher

    Promises werden nur für Manifest V3 und höher unterstützt. Auf anderen Plattformen müssen Callbacks verwendet werden.

Ereignisse

onCharacteristicReadRequest

Chrome 52 oder höher 
chrome.bluetoothLowEnergy.onCharacteristicReadRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät den Wert eines Merkmals lesen möchte, das auf dem lokalen GATT-Server registriert ist. Wenn Sie längere Zeit nicht auf diese Anfrage reagieren, kann die Verbindung getrennt werden. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Anfrage

      Ersuchen

    • characteristicId

      String

onCharacteristicValueChanged

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

Wird ausgelöst, wenn sich der Wert eines Remote-GATT-Merkmals ändert, entweder als Ergebnis einer Leseanfrage oder einer Benachrichtigung/Anzeige über eine Wertänderung. Dieses Ereignis wird nur gesendet, wenn die App Benachrichtigungen durch Aufrufen von startCharacteristicNotifications aktiviert hat.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (characteristic: Characteristic) => void

onCharacteristicWriteRequest

Chrome 52 oder höher 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät anfordert, den Wert eines auf dem lokalen GATT-Server registrierten Merkmals zu schreiben. Wenn Sie längere Zeit nicht auf diese Anfrage reagieren, kann die Verbindung getrennt werden. Dieses Ereignis ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Anfrage

      Ersuchen

    • characteristicId

      String

onDescriptorReadRequest

Chrome 52 oder höher 
chrome.bluetoothLowEnergy.onDescriptorReadRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät den Wert eines Deskriptors lesen möchte, der auf dem lokalen GATT-Server registriert ist. Wenn Sie längere Zeit nicht auf diese Anfrage reagieren, kann die Verbindung getrennt werden. Dieses Ereignis ist nur verfügbar, wenn für die App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onDescriptorValueChanged

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

Wird ausgelöst, wenn sich der Wert eines Remote-GATT-Merkmalsdeskriptors ändert, normalerweise als Ergebnis einer Leseanfrage. Dieses Ereignis dient hauptsächlich der Bequemlichkeit und wird immer nach einem erfolgreichen Aufruf von readDescriptorValue gesendet.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (descriptor: Descriptor) => void

onDescriptorWriteRequest

Chrome 52 oder höher 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät anfordert, den Wert eines auf dem lokalen GATT-Server registrierten Deskriptors zu schreiben. Wenn Sie längere Zeit nicht auf diese Anfrage reagieren, kann die Verbindung getrennt werden. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigung „bluetooth:low_energy“ als auch die Berechtigung „bluetooth:peripheral“ auf „true“ gesetzt ist. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

onServiceAdded

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

Wird ausgelöst, wenn ein neuer GATT-Dienst auf einem Remote-Gerät erkannt wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (service: Service) => void

onServiceChanged

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

Wird ausgelöst, wenn sich der Status eines Remote-GATT-Dienstes ändert. Dazu gehören alle Merkmale und/oder Deskriptoren, die dem Dienst hinzugefügt oder daraus entfernt werden, sowie „ServiceChanged“-Benachrichtigungen vom Remote-Gerät.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (service: Service) => void

onServiceRemoved

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

Wird ausgelöst, wenn ein GATT-Dienst, der zuvor auf einem Remote-Gerät erkannt wurde, entfernt wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (service: Service) => void