chrome.bluetoothLowEnergy

Beschreibung

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

Manifest

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

"bluetooth"

Typen

Advertisement

Chrome 47 und höher

Attribute

  • manufacturerData

    ManufacturerData[] optional

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

  • serviceData

    ServiceData[] optional

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

  • serviceUuids

    string[] optional

    Liste der UUIDs, die in das Feld „Dienst-UUIDs“ der Werbedaten aufgenommen werden sollen. Diese UUIDs können im 16-Bit-, 32-Bit- oder 128-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-Format vorliegen.

  • Art der Werbung

AdvertisementType

Chrome 47 und höher

Art der Werbung Wenn Sie „broadcast“ auswählen, lautet der gesendete Anzeigentyp ADV_NONCONN_IND und das Gerät sendet eine zufällige MAC-Adresse. Bei der Einstellung „Peripheriegerät“ ist der Werbetyp ADV_IND oder ADV_SCAN_IND und das Gerät sendet die MAC-Adresse des echten Bluetooth-Adapters.

Enum

Characteristic

Attribute

  • instanceId

    String optional

    Gibt die diesem Merkmal zugewiesene Kennung zurück. Verwenden Sie die Instanz-ID, um zwischen den Merkmalen eines Peripheriegeräts mit derselben UUID zu unterscheiden und Funktionsaufrufe zu senden, die eine charakteristische Kennung annehmen. Vorhanden, wenn diese Instanz ein Remote-Merkmal darstellt.

  • Properties

    CharacteristicProperty[]

    Die Eigenschaften dieses Merkmals.

  • Dienst

    Dienstleistung optional

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

  • uuid

    String

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

  • value

    ArrayBuffer optional

    Der aktuell im Cache gespeicherte Merkmalswert. 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. Aus diesen Properties werden Berechtigungen für charakteristische Eigenschaften abgeleitet. In der Bluetooth 4.x-Spezifikation finden Sie Informationen zur Bedeutung der einzelnen Eigenschaften.

Enum

"writeWithoutResponse"

"extendedProperties"

"reliableWrite"

"writableAuxiliaries"

"encryptRead"

"encryptWrite"

"encryptAuthenticatedRead"

"encryptAuthenticatedWrite"

ConnectProperties

Attribute

  • nichtflüchtige

    boolean

    Angabe, ob eine Verbindung zum Gerät geöffnet bleibt, wenn die Ereignisseite der App entfernt wird (siehe App-Lebenszyklus verwalten). Der Standardwert ist false..

Descriptor

Attribute

  • charakteristisch

    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 zu erstellen, die eine Deskriptor-ID annehmen. Vorhanden, wenn diese Instanz ein Remote-Merkmal darstellt.

  • Berechtigungen

    DescriptorPermission[]

    Chrome 52 und höher

    Die Berechtigungen dieses Deskriptors.

  • uuid

    String

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

  • value

    ArrayBuffer optional

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

DescriptorPermission

Chrome 52 und höher

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

Enum

"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

    Nummer optional

    Die Klasse des Geräts, ein durch http://www.bluetooth.org/en-us/specification/assigned-numbers/baseband definiertes Bitfeld.

  • name

    String optional

    Der visuell lesbare Name des Geräts.

ManufacturerData

Chrome 47 und höher

Attribute

  • Daten

    Nummer[]

  • id

    Zahl

Notification

Chrome 52 und höher

Attribute

  • shouldIndicate

    Boolescher Wert optional

    Optionales Flag zum Senden einer Anzeige anstelle einer Benachrichtigung.

  • value

    ArrayBuffer

    Neuer Wert des Merkmals.

NotificationProperties

Attribute

  • nichtflüchtige

    boolean

    Angabe, ob die App Benachrichtigungen erhalten soll, wenn die Ereignisseite der App 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 wird.

  • requestId

    Zahl

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

  • value

    ArrayBuffer optional

    Zu schreibender Wert (falls es eine Schreibanfrage ist).

Response

Chrome 52 und höher

Attribute

  • isError

    boolean

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

  • requestId

    Zahl

    ID der Anfrage, auf die diese Antwort gesendet wird.

  • value

    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. Vorhanden, wenn diese Instanz einen Remote-Dienst darstellt.

  • instanceId

    String optional

    Gibt die diesem Dienst zugewiesene ID zurück Verwenden Sie die Instanz-ID, um zwischen Diensten von einem Peripheriegerät mit derselben UUID zu unterscheiden und Funktionsaufrufe zu senden, die eine Dienst-ID annehmen. Vorhanden, wenn diese Instanz einen Remote-Dienst darstellt.

  • isPrimary

    boolean

    Gibt an, ob es sich bei diesem Diensttyp um einen primären oder sekundären Dienst handelt.

  • uuid

    String

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

ServiceData

Chrome 47 und höher

Attribute

  • Daten

    Nummer[]

  • uuid

    String

Methoden

connect()

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

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

Parameters

  • deviceAddress

    String

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

  • Properties

    ConnectProperties optional

    Verbindungseigenschaften (optional).

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

createCharacteristic()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

Erstellen Sie ein lokal gehostetes GATT-Merkmal. 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 in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • charakteristisch

    Merkmal

    Die zu erstellende Eigenschaft.

  • serviceId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (characteristicId: string)=>void

    • characteristicId

      String

Rückgaben

  • Versprechen<string>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

createDescriptor()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.createDescriptor(
  descriptor: Descriptor,
  characteristicId: string,
  callback?: function,
)

Erstellen Sie einen lokal gehosteten GATT-Deskriptor. Diese Beschreibung muss unter einem gültigen Merkmal gehostet werden. Wenn die Merkmals-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • Schlagwort

    Schlagwort

    Die zu erstellende Beschreibung.

  • characteristicId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (descriptorId: string)=>void

    • descriptorId

      String

Rückgaben

  • Versprechen<string>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

createService()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Einen lokal gehosteten GATT-Dienst erstellen Dieser Dienst kann registriert werden, um auf einem lokalen GATT-Server verfügbar zu sein. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • Dienst

    Dienst

    Der zu erstellende Dienst.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (serviceId: string)=>void

    • serviceId

      String

Rückgaben

  • Versprechen<string>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

disconnect()

Versprechen 
chrome.bluetoothLowEnergy.disconnect(
  deviceAddress: string,
  callback?: function,
)

Schließt die Verbindung der App mit dem Gerät mit der angegebenen Adresse. Dadurch wird nicht immer der physische Link selbst gelöscht, da es möglicherweise andere Apps mit offenen Verbindungen gibt.

Parameters

  • deviceAddress

    String

    Die Bluetooth-Adresse des Remote-Geräts.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getCharacteristic()

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

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

Parameters

  • characteristicId

    String

    Die Instanz-ID des angeforderten GATT-Merkmals.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic)=>void

Rückgaben

  • Promise<Characteristic>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getCharacteristics()

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

Rufen Sie eine Liste aller erkannten GATT-Eigenschaften ab, die zum jeweiligen Dienst gehören.

Parameters

  • serviceId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic[])=>void

Rückgaben

  • Promise<Characteristic[]>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getDescriptor()

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

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

Parameters

  • descriptorId

    String

    Die Instanz-ID des angeforderten GATT-Merkmalsdeskriptors.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor)=>void

Rückgaben

  • Promise<Descriptor>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getDescriptors()

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

Eine Liste der GATT-Merkmalsdeskriptoren abrufen, die zum jeweiligen Merkmal gehören.

Parameters

  • characteristicId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor[])=>void

Rückgaben

  • Promise<Descriptor[]>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getIncludedServices()

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

Eine Liste der GATT-Dienste abrufen, die im jeweiligen Dienst enthalten sind

Parameters

  • serviceId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Service[])=>void

Rückgaben

  • Promise<Dienst[]>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getService()

Versprechen 
chrome.bluetoothLowEnergy.getService(
  serviceId: string,
  callback?: function,
)

Rufen Sie den GATT-Dienst mit der angegebenen Instanz-ID ab.

Parameters

  • serviceId

    String

    Die Instanz-ID des angeforderten GATT-Dienstes.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Service)=>void

Rückgaben

  • Promise<Dienst>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

getServices()

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

Alle GATT-Dienste abrufen, die auf dem Remote-Gerä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 (möglicherweise leer) zurück. Sie können das Problem umgehen, indem Sie eine zeitbasierte Verzögerung hinzufügen und/oder wiederholt aufrufen, bis die erwartete Anzahl von Diensten zurückgegeben wird.

Parameters

  • deviceAddress

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Service[])=>void

Rückgaben

  • Promise<Dienst[]>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

notifyCharacteristicValueChanged()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Remote-Gerät über einen neuen Wert für ein Merkmal benachrichtigen. Wenn das Flag „ shouldSpecific“ im Benachrichtigungsobjekt auf „true“ gesetzt ist, wird anstelle einer Benachrichtigung ein Hinweis gesendet. Beachten Sie, dass für das Merkmal die Eigenschaft „notify“ oder „specific“ während der Erstellung korrekt festgelegt werden muss, damit dieser Aufruf erfolgreich ist. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • characteristicId

    String

    Die Eigenschaft, für die die Benachrichtigung gesendet werden soll.

  • Benachrichtigung

    Benachrichtigung

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

readCharacteristicValue()

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

Wert einer bestimmten Eigenschaft von einem Remote-Peripheriegerät abrufen

Parameters

  • characteristicId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Characteristic)=>void

Rückgaben

  • Promise<Characteristic>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

readDescriptorValue()

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

Wert eines angegebenen charakteristischen Deskriptors von einem Remote-Peripheriegerät abrufen.

Parameters

  • descriptorId

    String

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (result: Descriptor)=>void

Rückgaben

  • Promise<Descriptor>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

registerAdvertisement()

Versprechen Chrome 47 oder höher 
chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Erstellen Sie eine Anzeige und registrieren Sie sie für Werbezwecke. Um diese Funktion aufzurufen, müssen für die App 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 findest du unter https://developer.chrome.com/apps/manifest/bluetooth Hinweis: Auf einigen Hardware-Geräten wird gleichzeitig der zentrale und der Peripheriemodus unterstützt. Bei Hardware, die dies nicht unterstützt, wird über diesen Aufruf in den Peripheriemodus gewechselt. Bei Hardware, die sowohl den zentralen als auch den Peripheriemodus nicht unterstützt, führt der Versuch, das Gerät in beiden Modi zu verwenden, zu undefiniertem Verhalten oder dazu, dass andere Anwendungen der zentralen Rolle nicht richtig funktionieren (einschließlich der Erkennung von Bluetooth Low Energy-Geräten).

Parameters

  • Anzeige

    Anzeige

    Die Anzeige, die beworben werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    (advertisementId: number)=>void

    • advertisementId

      Zahl

Rückgaben

  • Versprechen<Zahl>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

registerService()

Versprechen Chrome 52 oder 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 in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • serviceId

    String

    Eindeutige ID eines erstellten Dienstes.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

removeService()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.removeService(
  serviceId: string,
  callback?: function,
)

Der angegebene Dienst wird entfernt und seine Registrierung wird aufgehoben, falls er registriert wurde. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • serviceId

    String

    Eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

resetAdvertising()

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

Setzt die Werbung auf dem aktuellen Gerät zurück. Dadurch wird die Registrierung aufgehoben und alle vorhandenen Anzeigen werden gestoppt.

Parameters

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

sendRequestResponse()

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

Sendet eine Antwort auf eine Lese-/Schreibanfrage für eine Eigenschaft oder einen Deskriptor. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • Antwort

    Antwort

    Die Antwort auf die Anfrage.

setAdvertisingInterval()

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

Legt das Intervall zwischen zwei aufeinanderfolgenden Anzeigen fest. Hinweis: Dies ist ein maximaler Aufwand. Das tatsächliche Intervall kann minimal von den angeforderten Intervallen abweichen. Auf manchen Hardwaregeräten gilt ein Mindestintervall von 100 ms. Die Mindest- und Höchstwerte dürfen den von der Bluetooth 4.2-Spezifikation zulässigen Bereich nicht überschreiten.

Parameters

  • minInterval

    Zahl

    Minimales Intervall zwischen Werbeanzeigen (in Millisekunden). Dieser darf nicht niedriger als 20 ms sein (gemäß Spezifikation).

  • maxInterval

    Zahl

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

startCharacteristicNotifications()

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

Benachrichtigungen/Angaben zu Werten aus dem angegebenen Merkmal aktivieren. Nach der Aktivierung kann eine App mithilfe des Ereignisses onCharacteristicValueChanged auf Benachrichtigungen warten.

Parameters

  • characteristicId

    String

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

  • Properties

    NotificationProperties optional

    Eigenschaften der Benachrichtigungssitzung (optional).

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

stopCharacteristicNotifications()

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

Benachrichtigungen/Angaben zu Werten für das angegebene Merkmal deaktivieren. Nach einem erfolgreichen Aufruf erhält die Anwendung keine Benachrichtigungen/Anzeigen mehr für dieses Merkmal.

Parameters

  • characteristicId

    String

    Die Instanz-ID des GATT-Merkmals, bei dem die Benachrichtigungssitzung dieser App beendet werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

unregisterAdvertisement()

Versprechen Chrome 47 oder höher 
chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Hebt die Registrierung einer Anzeige auf und stellt ihre Werbung ein Wenn sich die Registrierung der Anzeige nicht aufheben lässt, können Sie die Werbung nur beenden, indem Sie das Gerät neu starten.

Parameters

  • advertisementId

    Zahl

    ID der Anzeige, deren Registrierung aufgehoben werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

unregisterService()

Versprechen Chrome 52 oder höher 
chrome.bluetoothLowEnergy.unregisterService(
  serviceId: string,
  callback?: function,
)

Die Registrierung des jeweiligen Dienstes beim lokalen GATT-Server aufheben Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Low_Energy“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • serviceId

    String

    Eindeutige ID eines aktuell registrierten Dienstes.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

writeCharacteristicValue()

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

Den Wert eines bestimmten Merkmals von einem Remote-Peripheriegerät schreiben.

Parameters

  • characteristicId

    String

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

  • value

    ArrayBuffer

    Der Wert, der als Teil der Schreibanfrage an die Remote-Eigenschaft gesendet werden soll.

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

writeDescriptorValue()

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

Den Wert eines bestimmten charakteristischen Deskriptors von einem Remote-Peripheriegerät schreiben.

Parameters

  • descriptorId

    String

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

  • value

    ArrayBuffer

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

  • callback

    Funktion optional

    Der Parameter callback sieht so aus: 

    ()=>void

Rückgaben

  • Promise<void>

    Chrome 91 und höher

    Promise-Objekte werden nur für Manifest V3 und höher unterstützt. Andere Plattformen müssen Callbacks verwenden.

Veranstaltungen

onCharacteristicReadRequest

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

Wird ausgelöst, wenn ein verbundenes zentrales Gerät den Wert einer Eigenschaft lesen möchte, die auf dem lokalen GATT-Server registriert ist Wenn Sie lange nicht auf diese Anfrage reagieren, wird die Verbindung möglicherweise getrennt. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Niedrige_Energie“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Request

      Anfrage

    • characteristicId

      String

onCharacteristicValueChanged

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

Wird ausgelöst, wenn sich der Wert eines Remote-GATT-Merkmals ändert, entweder aufgrund einer Leseanfrage oder einer Benachrichtigung/Anzeige zu einer Wertänderung. Dieses Ereignis wird nur gesendet, wenn in der App Benachrichtigungen durch den Aufruf von startCharacteristicNotifications aktiviert wurden.

Parameters

  • 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 anfordert, den Wert einer Eigenschaft zu schreiben, die auf dem lokalen GATT-Server registriert ist Wenn Sie lange nicht auf diese Anfrage reagieren, wird die Verbindung möglicherweise getrennt. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Niedrige_Energie“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Request

      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 einer Beschreibung lesen möchte, die auf dem lokalen GATT-Server registriert ist Wenn Sie lange nicht auf diese Anfrage reagieren, wird die Verbindung möglicherweise getrennt. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Niedrige_Energie“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Request

      Anfrage

    • descriptorId

      String

onDescriptorValueChanged

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

Wird ausgelöst, wenn sich der Wert eines Remote-GATT-Merkmalsdeskriptors ändert, in der Regel infolge einer Leseanfrage. Dieses Ereignis dient hauptsächlich der Übersichtlichkeit und wird immer nach einem erfolgreichen Aufruf von readDescriptorValue gesendet.

Parameters

  • 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 anfordert, den Wert eines Deskriptors zu schreiben, der auf dem lokalen GATT-Server registriert ist. Wenn Sie lange nicht auf diese Anfrage reagieren, wird die Verbindung möglicherweise getrennt. Dieses Ereignis ist nur verfügbar, wenn in der App sowohl die Berechtigungen „Bluetooth:Niedrige_Energie“ als auch „Bluetooth:Peripheriegeräte“ auf „true“ gesetzt sind. Die Berechtigung für Peripheriegeräte ist möglicherweise nicht für alle Apps verfügbar.

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

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

    • Request

      Anfrage

    • descriptorId

      String

onServiceAdded

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

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

Parameters

  • 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 vom Dienst entfernt werden, sowie „ServiceChanged“-Benachrichtigungen vom Remote-Gerät.

Parameters

  • 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 entfernt wurde, der zuvor auf einem Remote-Gerät erkannt wurde

Parameters

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    (service: Service)=>void