chrome.bluetoothLowEnergy

Beschreibung

Die chrome.bluetoothLowEnergy API wird verwendet, um über das Generic Attribute Profile (GATT) mit Bluetooth Smart (Low Energy)-Geräten zu kommunizieren.

Manifest

Die folgenden Schlüssel müssen im Manifest deklariert werden, damit diese API verwendet werden kann.

"bluetooth"

Typen

Advertisement

Chrome 47 und höher

Attribute

  • manufacturerData

    ManufacturerData[] optional

    Liste der herstellerspezifischen Daten, die in den Feldern „Herstellerspezifische Daten“ der Werbedaten enthalten sein müssen.

  • serviceData

    ServiceData[] optional

    Liste der Dienstdaten, die in den Feldern „Dienstdaten“ der Werbedaten enthalten sein sollen.

  • serviceUuids

    string[] optional

    Liste der UUIDs, die im Feld „Dienst-UUIDs“ der Anzeigendaten enthalten sein sollen. Diese UUIDs können im 16-, 32- oder 128-Bit-Format vorliegen.

  • solicitUuids

    string[] optional

    Liste der UUIDs, die im Feld „UUIDs anfordern“ der Anzeigendaten enthalten sein sollen. Diese UUIDs können im 16-, 32- oder 128-Bit-Format vorliegen.

  • Art der Werbung.

AdvertisementType

Chrome 47 und höher

Art der Werbung. Wenn „broadcast“ ausgewählt ist, ist der gesendete Werbetyp ADV_NONCONN_IND und das Gerät sendet mit einer zufälligen MAC-Adresse. Wenn „peripheral“ festgelegt ist, ist der Werbetyp ADV_IND oder ADV_SCAN_IND und das Gerät sendet mit der MAC-Adresse des Bluetooth-Adapters.

Enum

„broadcast“

„peripheral“

Characteristic

Attribute

  • instanceId

    String optional

    Gibt die Kennung zurück, die dieser Eigenschaft zugewiesen ist. Verwenden Sie die Instanz-ID, um zwischen Merkmalen eines Peripheriegeräts mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Merkmalskennung annehmen. „Present“, wenn diese Instanz eine Remote-Eigenschaft darstellt.

  • Properties

    CharacteristicProperty[]

    Die Eigenschaften dieses Merkmals.

  • Dienst

    Dienst optional

    Der GATT-Dienst, zu dem diese Eigenschaft gehört.

  • uuid

    String

    Die UUID der Eigenschaft, z.B. 00002a37-0000-1000-8000-00805f9b34fb.

  • Wert

    ArrayBuffer optional

    Der derzeit im Cache gespeicherte Merkmalswert. Dieser Wert wird aktualisiert, wenn der Wert des Attributs über eine Benachrichtigung oder einen Hinweis gelesen oder aktualisiert wird.

CharacteristicProperty

Werte, die die möglichen Eigenschaften einer Eigenschaft darstellen. Die Berechtigungen für Merkmale werden aus diesen Properties abgeleitet. Die Bedeutung der einzelnen Properties 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

    Gibt an, ob eine Verbindung zum Gerät offen bleibt, wenn die Ereignisseite der Anwendung entladen wird (siehe App-Lebenszyklus verwalten). Der Standardwert ist false..

Descriptor

Attribute

  • Merkmal

    Eigenschaft optional

    Die GATT-Eigenschaft, zu der dieser Deskriptor gehört.

  • instanceId

    String optional

    Gibt die diesem Deskriptor zugewiesene Kennung zurück. Verwenden Sie die Instanz-ID, um zwischen Descriptors von einem Peripheriegerät mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Descriptor-ID annehmen. „Present“, wenn diese Instanz eine Remote-Eigenschaft darstellt.

  • Berechtigungen

    DescriptorPermission[]

    Chrome 52 und höher

    Die Berechtigungen dieses Deskriptors.

  • uuid

    String

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

  • Wert

    ArrayBuffer optional

    Der derzeit im Cache gespeicherte Deskriptorwert. Dieser Wert wird aktualisiert, wenn der Wert des Descriptors gelesen wird.

DescriptorPermission

Chrome 52 und 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 und 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 für Menschen lesbare Name des Geräts.

ManufacturerData

Chrome 47 und höher

Attribute

  • Daten

    number[]

  • id

    Zahl

Notification

Chrome 52 und höher

Attribute

  • shouldIndicate

    boolescher Wert optional

    Optionales Flag zum Senden einer Anzeige anstelle einer Benachrichtigung.

  • Wert

    ArrayBuffer

    Neuer Wert der Eigenschaft.

NotificationProperties

Attribute

  • nichtflüchtige

    boolean

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

Request

Chrome 52 und höher

Attribute

  • Gerät

    Gerät

    Gerät, von dem diese Anfrage gesendet wurde.

  • requestId

    Zahl

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

  • Wert

    ArrayBuffer optional

    Zu schreibender Wert (falls dies eine Schreibanfrage ist).

Response

Chrome 52 und höher

Attribute

  • isError

    boolean

    Wenn es sich um eine Fehlerantwort handelt, sollte dies der Fall sein.

  • requestId

    Zahl

    Die ID der Anfrage, auf die diese Antwort sich bezieht.

  • Wert

    ArrayBuffer optional

    Antwortwert Bei Schreibanfragen und Fehlerantworten wird dieser Parameter ignoriert.

Service

Attribute

  • deviceAddress

    String optional

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

  • instanceId

    String optional

    Gibt die Kennung zurück, die diesem Dienst zugewiesen ist. Verwenden Sie die Instanz-ID, um zwischen Diensten von einem Peripheriegerät mit derselben UUID zu unterscheiden und Funktionsaufrufe auszuführen, die eine Dienst-ID annehmen. Ist vorhanden, wenn diese Instanz einen Remote-Dienst 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 und höher

Attribute

  • Daten

    number[]

  • uuid

    String

Methoden

connect()

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

Stellt eine Verbindung zwischen der Anwendung und dem Gerät mit der angegebenen Adresse her. Ein Gerät kann bereits verbunden sein und seine GATT-Dienste sind verfügbar, ohne dass connect aufgerufen wird. Eine App, die auf die 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 Remotegeräts, zu dem eine GATT-Verbindung geöffnet werden soll.

  • Properties

    ConnectProperties optional

    Verbindungsattribute (optional)

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Erstellen Sie eine lokal gehostete GATT-Eigenschaft. Diese Eigenschaft muss von 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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • Merkmal

    Attribut

    Das zu erstellende Merkmal.

  • serviceId

    String

    ID des Dienstes, für den diese Eigenschaft erstellt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (characteristicId: string) => void

    • characteristicId

      String

Gibt Folgendes zurück:

  • Promise<string>

    Chrome 91 und höher

    Versprechen 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,
)

Erstellen Sie einen lokal gehosteten GATT-Descriptor. Dieser Descriptor muss unter einer gültigen Eigenschaft gehostet werden. Wenn die Attribut-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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • Schlagwort

    Beschreibung

    Der zu erstellende Descriptor.

  • characteristicId

    String

    ID der Eigenschaft, für die dieser Descriptor erstellt werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (descriptorId: string) => void

    • descriptorId

      String

Gibt Folgendes zurück:

  • Promise<string>

    Chrome 91 und höher

    Versprechen 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,
)

Erstellen Sie einen lokal gehosteten GATT-Dienst. Dieser Dienst kann so registriert werden, dass er auf einem lokalen GATT-Server verfügbar ist. 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 sind. 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

Gibt Folgendes zurück:

  • Promise<string>

    Chrome 91 und höher

    Versprechen 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,
)

Schließt die Verbindung der App zum Gerät mit der angegebenen Adresse. Hinweis: Dadurch wird nicht immer die physische Verbindung selbst getrennt, da es möglicherweise andere Apps mit offenen Verbindungen gibt.

Parameter

  • deviceAddress

    String

    Die Bluetooth-Adresse des Remote-Geräts.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

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

Parameter

  • characteristicId

    String

    Die Instanz-ID der angeforderten GATT-Eigenschaft.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic) => void

Gibt Folgendes zurück:

  • Promise<Characteristic>

    Chrome 91 und höher

    Versprechen 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,
)

Liste aller erkannten GATT-Attribute abrufen, die zum angegebenen Dienst gehören

Parameter

  • serviceId

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic[]) => void

Gibt Folgendes zurück:

  • Promise<Characteristic[]>

    Chrome 91 und höher

    Versprechen 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,
)

Ruft den GATT-Attribut-Deskriptor mit der angegebenen Instanz-ID ab.

Parameter

  • descriptorId

    String

    Die Instanz-ID des angeforderten GATT-Attribut-Descriptors.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor) => void

Gibt Folgendes zurück:

  • Promise<Descriptor>

    Chrome 91 und höher

    Versprechen 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,
)

Liste der GATT-Attributdeskriptoren abrufen, die zur angegebenen Eigenschaft gehören

Parameter

  • characteristicId

    String

    Die Instanz-ID der GATT-Eigenschaft, deren Descriptor zurückgegeben werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor[]) => void

Gibt Folgendes zurück:

  • Promise<Descriptor[]>

    Chrome 91 und höher

    Versprechen 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,
)

Liste der GATT-Dienste abrufen, die vom 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

Gibt Folgendes zurück:

  • Promise<Service[]>

    Chrome 91 und höher

    Versprechen 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,
)

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

Gibt Folgendes zurück:

  • Promise<Service>

    Chrome 91 und höher

    Versprechen 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,
)

Alle GATT-Dienste abrufen, die auf dem Remotegerät mit der angegebenen Geräteadresse gefunden wurden.

Hinweis:Wenn die Diensterkennung auf dem Gerät noch nicht abgeschlossen ist, gibt diese API einen Teil der Dienste zurück (möglicherweise leer). Eine Möglichkeit besteht darin, eine zeitbasierte Verzögerung hinzuzufügen und/oder den Dienst wiederholt aufzurufen, bis die erwartete Anzahl von Diensten zurückgegeben wird.

Parameter

  • deviceAddress

    String

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

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Service[]) => void

Gibt Folgendes zurück:

  • Promise<Service[]>

    Chrome 91 und höher

    Versprechen 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,
)

Ein Remotegerät über einen neuen Wert für ein Merkmal benachrichtigen. Wenn das Flag „shouldIndicate“ im Benachrichtigungsobjekt auf „true“ gesetzt ist, wird anstelle einer Benachrichtigung eine Anzeige gesendet. Hinweis: Die Eigenschaft muss beim Erstellen die Property „notify“ oder „indicate“ korrekt festlegen, damit dieser Aufruf erfolgreich ist. 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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • characteristicId

    String

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

  • Benachrichtigung

    Benachrichtigung

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Ruft den Wert einer bestimmten Eigenschaft von einem Remote-Peripheriegerät ab.

Parameter

  • characteristicId

    String

    Die Instanz-ID der GATT-Eigenschaft, deren Wert vom Remotegerät gelesen werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic) => void

Gibt Folgendes zurück:

  • Promise<Characteristic>

    Chrome 91 und höher

    Versprechen 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,
)

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

Parameter

  • descriptorId

    String

    Die Instanz-ID des GATT-Attributdeskriptors, dessen Wert vom Remotegerät gelesen werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor) => void

Gibt Folgendes zurück:

  • Promise<Descriptor>

    Chrome 91 und höher

    Versprechen 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,
)

Erstellen Sie eine Anzeige und registrieren Sie sie für Werbung. Damit diese Funktion aufgerufen werden kann, müssen die Berechtigungen „bluetooth:low_energy“ und „bluetooth:peripheral“ 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 Hardwaregeräten, die dies nicht unterstützen, wird das Gerät durch diesen Aufruf in den peripheren Modus versetzt. Bei Hardware, die weder den zentralen noch den peripheren Modus unterstützt, führt der Versuch, das Gerät in beiden Modi zu verwenden, zu undefiniertem Verhalten oder verhindert, dass andere Anwendungen mit zentraler Rolle richtig 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

Gibt Folgendes zurück:

  • Promise<number>

    Chrome 91 und höher

    Versprechen 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,
)

Registrieren Sie 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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Die eindeutige ID eines erstellten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Entfernen Sie den angegebenen Dienst und melden Sie ihn ab, 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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Die eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

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

resetAdvertising()

Versprechen Chrome 61 und höher 
chrome.bluetoothLowEnergy.resetAdvertising(
  callback?: function,
)

Setzt die Werbung auf dem aktuellen Gerät zurück. Alle vorhandenen Anzeigen werden abgemeldet und beendet.

Parameter

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

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

sendRequestResponse()

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

Sendet eine Antwort auf eine Lese-/Schreibanfrage für ein Merkmal oder einen Descriptor. 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 sind. 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()

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

Hiermit wird das Intervall zwischen zwei aufeinanderfolgenden Anzeigen festgelegt. Hinweis: Wir bemühen uns, die Anfrage so schnell wie möglich zu bearbeiten. Das tatsächliche Intervall kann erheblich von den angeforderten Intervallen abweichen. Bei 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 gemäß der Spezifikation nicht unter 20 ms liegen.

  • maxInterval

    Zahl

    Maximal zulässiges Intervall zwischen Anzeigen (in Millisekunden). Dieser Wert darf gemäß der Spezifikation maximal 10.240 ms betragen.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Aktivieren Sie Benachrichtigungen/Anzeige von Werten für die angegebene Eigenschaft. Nach der Aktivierung kann eine Anwendung mit dem Ereignis onCharacteristicValueChanged auf Benachrichtigungen warten.

Parameter

  • characteristicId

    String

    Die Instanz-ID der GATT-Eigenschaft, für die Benachrichtigungen aktiviert werden sollen.

  • Properties

    NotificationProperties optional

    Benachrichtigungssitzungseigenschaften (optional).

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Deaktivieren Sie Benachrichtigungen/Anzeige von Werten für die angegebene Eigenschaft. Nach einem erfolgreichen Aufruf erhält die Anwendung keine Benachrichtigungen/Anzeige mehr von dieser Eigenschaft.

Parameter

  • characteristicId

    String

    Die Instanz-ID der GATT-Eigenschaft, für die die Benachrichtigungssitzung dieser App beendet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Eine Anzeige wird abgemeldet und die Werbung wird beendet. Wenn die Werbung nicht abgemeldet werden kann, ist das Zurücksetzen des Geräts möglicherweise die einzige Möglichkeit, sie zu beenden.

Parameter

  • advertisementId

    Zahl

    Die ID der Anzeige, deren Registrierung aufgehoben werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Den angegebenen Dienst beim lokalen GATT-Server abmelden. 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 sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameter

  • serviceId

    String

    Die eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

Schreibt den Wert einer bestimmten Eigenschaft von einem Remote-Peripheriegerät.

Parameter

  • characteristicId

    String

    Die Instanz-ID der GATT-Eigenschaft, in die der Wert geschrieben werden soll.

  • Wert

    ArrayBuffer

    Der Wert, der im Rahmen der Schreibanfrage an die Remote-Eigenschaft gesendet werden soll.

  • callback

    function optional

    Der Parameter callback sieht so aus: 

    () => void

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

    Versprechen 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,
)

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

Parameter

  • descriptorId

    String

    Die Instanz-ID des GATT-Attribut-Descriptors, in den der 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

Gibt Folgendes zurück:

  • Promise<void>

    Chrome 91 und höher

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

Ereignisse

onCharacteristicReadRequest

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

Wird ausgelöst, wenn ein verbundenes zentrales Gerät den Wert eines auf dem lokalen GATT-Server registrierten Attributs lesen möchte. Wenn Sie auf diese Anfrage nicht innerhalb einer angemessenen Zeit 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 sind. 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

      Anfrage

    • characteristicId

      String

onCharacteristicValueChanged

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

Wird ausgelöst, wenn sich der Wert einer Remote-GATT-Eigenschaft ändert, entweder aufgrund einer Leseanfrage oder einer Benachrichtigung/Anweisung zur 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 und höher 
chrome.bluetoothLowEnergy.onCharacteristicWriteRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät den Wert einer Eigenschaft schreibt, die auf dem lokalen GATT-Server registriert ist. Wenn Sie auf diese Anfrage nicht innerhalb einer angemessenen Zeit 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 sind. 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

      Anfrage

    • characteristicId

      String

onDescriptorReadRequest

Chrome 52 und 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 auf diese Anfrage nicht innerhalb einer angemessenen Zeit 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 sind. 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

    • Anfrage

      Anfrage

    • descriptorId

      String

onDescriptorValueChanged

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

Wird ausgelöst, wenn sich der Wert eines Remote-GATT-Attribut-Descriptors ändert, in der Regel als Folge 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 und höher 
chrome.bluetoothLowEnergy.onDescriptorWriteRequest.addListener(
  callback: function,
)

Wird ausgelöst, wenn ein verbundenes zentrales Gerät das Schreiben des Werts eines Deskriptors anfordert, der auf dem lokalen GATT-Server registriert ist. Wenn Sie auf diese Anfrage nicht innerhalb einer angemessenen Zeit 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 sind. 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

    • Anfrage

      Anfrage

    • descriptorId

      String

onServiceAdded

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

Wird ausgelöst, wenn ein neuer GATT-Dienst auf einem Remotegerä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 Beschreibungen, die dem Dienst hinzugefügt oder daraus entfernt werden, sowie „ServiceChanged“-Benachrichtigungen vom Remotegerä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 Remotegerät erkannt wurde, entfernt wurde.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (service: Service) => void