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.

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 der herstellerspezifischen Daten, die in „Herstellerspezifische Daten“ aufgenommen werden sollen Felder der Werbedaten.

• serviceData

  ServiceData[] optional

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

• serviceUuids

  string[] optional

  Liste der UUIDs, die in die Dienst-UUIDs aufgenommen werden sollen der Werbedaten. Diese UUIDs können in den Formaten 16 Bit, 32 Bit oder 128 Bit vorliegen.

• solicitUuids

  string[] optional

  Liste der UUIDs, die in die Anforderungs-UUIDs aufgenommen werden sollen der Werbedaten. Diese UUIDs können in den Formaten 16 Bit, 32 Bit oder 128 Bit vorliegen.

• Typ

  AdvertisementType

  Art der Werbung

AdvertisementType

Chrome 47 und höher

Art der Werbung Bei "broadcast" ausgewählt wurde, lautet der gesendete Anzeigentyp ADV_NONCONN_IND und das Gerät sendet eine zufällige MAC-Adresse. Bei der Einstellung „Peripheriegerät“ lautet der Anzeigentyp „ADV_IND“ oder „ADV_SCAN_IND“ und das Gerät sendet die Nachricht an die MAC-Adresse des realen Bluetooth-Adapters.

Enum

"broadcast"

"Peripheriegerät"

Characteristic

Attribute

• instanceId

  String optional

  Gibt die Kennung zurück, die diesem Merkmal zugewiesen ist. Anhand der Instanz-ID können Sie zwischen Merkmalen eines Peripheriegeräts mit derselben UUID unterscheiden und Funktionsaufrufe ausführen, die eine charakteristische Kennung annehmen. Ist vorhanden, wenn diese Instanz ein Remote-Merkmal darstellt.

• Properties

  CharacteristicProperty[]

  Die Eigenschaften dieses Merkmals.

• Dienst

  Dienst 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 charakteristische Wert. Dieser Wert wird aktualisiert, wenn der Wert des Merkmals über eine Benachrichtigung oder einen Hinweis gelesen oder aktualisiert wird.

CharacteristicProperty

Werte, die die möglichen Eigenschaften eines Merkmals darstellen. Charakteristische Berechtigungen werden aus diesen Properties abgeleitet. Die Bedeutung der einzelnen Eigenschaften finden Sie in den Bluetooth 4.x-Spezifikationen.

Enum

"broadcast"

"lesen"

"writeWithoutResponse"

"write"

"benachrichtigen"

„angeben“

"authSignedWrites" (in englischer Sprache)

"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 entladen 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 eines Peripheriegeräts mit derselben UUID zu unterscheiden und Funktionsaufrufe durchzuführen, die eine Deskriptor-ID aufnehmen. Ist 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.

• Wert

  ArrayBuffer optional

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

DescriptorPermission

Chrome 52 und höher

Werte, die mögliche Berechtigungen für eine Beschreibung darstellen. Informationen zur Bedeutung der einzelnen Berechtigungen findest du in den Bluetooth 4.x-Spezifikationen.

Enum

"lesen"

"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

  Zahl optional

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

• Name

  String optional

  Der visuell lesbare Name des Geräts.

ManufacturerData

Chrome 47 und höher

Attribute

• Daten

  Zahl[]

• id

  Zahl

Notification

Chrome 52 und höher

Attribute

• shouldIndicate

  Boolescher Wert optional

  Optionales Flag zum Senden einer Benachrichtigung anstelle einer Benachrichtigung.

• Wert

  ArrayBuffer

  Neuer Wert des Merkmals.

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

• Wert

  ArrayBuffer optional

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

Response

Chrome 52 und höher

Attribute

• isError

  boolean

  Wenn dies eine Fehlerantwort ist, sollte dies „true“ sein.

• requestId

  Zahl

  ID der Anfrage, auf die geantwortet wird.

• Wert

  ArrayBuffer optional

  Response value (Antwortwert). Dieser Parameter wird bei Schreibanfragen und Fehlerantworten 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 diesem Dienst zugewiesene Kennung zurück. Anhand der Instanz-ID können Sie zwischen Diensten eines Peripheriegeräts mit derselben UUID unterscheiden und Funktionsaufrufe ausführen, die eine Dienst-ID annehmen. Ist vorhanden, wenn diese Instanz einen Remote-Dienst darstellt.

• istprimär

  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

  Zahl[]

• uuid

  String

Methoden

connect()

<ph type="x-smartling-placeholder"></ph> 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. Möglicherweise ist bereits ein Gerät verbunden und die GATT-Dienste sind ohne Aufruf von connect verfügbar. Eine App, die jedoch auf die GATT-Dienste eines Geräts zugreifen möchte, sollte diese Funktion aufrufen, damit eine 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.

Parameter

• 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: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

createCharacteristic()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

chrome.bluetoothLowEnergy.createCharacteristic(
  characteristic: Characteristic,
  serviceId: string,
  callback?: function,
)

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

Parameter

• charakteristisch

  Merkmal

  Das zu erstellende Merkmal.

• serviceId

  String

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (characteristicId: string) => void

  • characteristicId

    String

Gibt Folgendes zurück:

• Promise&lt;string&gt;

  Chrome 91 und höher

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

createDescriptor()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und 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 nicht gültig ist, wird lastError festgelegt. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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 Deskriptor.

• characteristicId

  String

  ID des Merkmals, für das diese Beschreibung erstellt werden soll.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (descriptorId: string) => void

  • descriptorId

    String

Gibt Folgendes zurück:

• Promise&lt;string&gt;

  Chrome 91 und höher

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

createService()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

chrome.bluetoothLowEnergy.createService(
  service: Service,
  callback?: function,
)

Lokal gehosteten GATT-Dienst erstellen Dieser Dienst kann registriert werden, damit er auf einem lokalen GATT-Server verfügbar ist. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (serviceId: string) => void

  • serviceId

    String

Gibt Folgendes zurück:

• Promise&lt;string&gt;

  Chrome 91 und höher

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

disconnect()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• deviceAddress

  String

  Die Bluetooth-Adresse des Remote-Geräts.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

getCharacteristic()

<ph type="x-smartling-placeholder"></ph> 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 das Merkmal vorhanden ist.

Parameter

• characteristicId

  String

  Die Instanz-ID des angeforderten GATT-Merkmals.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Characteristic) => void

  • Ergebnis

    Merkmal

Gibt Folgendes zurück:

• Promise<Charakteristik>

  Chrome 91 und höher

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

getCharacteristics()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• serviceId

  String

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Characteristic[]) => void

  • Ergebnis

    Merkmal[]

Gibt Folgendes zurück:

• Promise<Merkmal[]>

  Chrome 91 und höher

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

getDescriptor()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• descriptorId

  String

  Die Instanz-ID des angeforderten GATT-Merkmalsdeskriptors.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Descriptor) => void

  • Ergebnis

    Beschreibung

Gibt Folgendes zurück:

• Promise&lt;Descriptor&gt;

  Chrome 91 und höher

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

getDescriptors()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Ruft eine Liste der GATT-Merkmalsdeskriptoren ab, die zu dem jeweiligen Merkmal gehören.

Parameter

• characteristicId

  String

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Descriptor[]) => void

  • Ergebnis

    Beschreibung[]

Gibt Folgendes zurück:

• Promise&lt;Descriptor[]&gt;

  Chrome 91 und höher

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

getIncludedServices()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Eine Liste der GATT-Dienste abrufen, die zum jeweiligen Dienst gehören

Parameter

• serviceId

  String

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Service[]) => void

  • Ergebnis

    Dienst[]

Gibt Folgendes zurück:

• Promise<Dienst[]>

  Chrome 91 und höher

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

getService()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

GATT-Dienst mit der angegebenen Instanz-ID abrufen

Parameter

• serviceId

  String

  Die Instanz-ID des angeforderten GATT-Dienstes.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Service) => void

  • Ergebnis

    Dienst

Gibt Folgendes zurück:

• Promise&lt;Service&gt;

  Chrome 91 und höher

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

getServices()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Alle GATT-Dienste abrufen, die auf dem Remote-Gerät mit der angegebenen Geräteadresse erkannt 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. Eine Behelfslösung besteht darin, eine zeitbasierte Verzögerung hinzuzufügen und/oder wiederholt anzurufen, 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

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Service[]) => void

  • Ergebnis

    Dienst[]

Gibt Folgendes zurück:

• Promise<Dienst[]>

  Chrome 91 und höher

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

notifyCharacteristicValueChanged()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

chrome.bluetoothLowEnergy.notifyCharacteristicValueChanged(
  characteristicId: string,
  notification: Notification,
  callback?: function,
)

Benachrichtigt ein Remote-Gerät über einen neuen Wert für ein Merkmal. Wenn das sollteInclude-Flag im Benachrichtigungsobjekt auf „true“ gesetzt ist, wird eine Benachrichtigung anstelle einer Benachrichtigung gesendet. Beachten Sie, dass das Merkmal das Attribut 'notify' korrekt festlegen muss. oder „angeben“ während der Erstellung, damit dieser Aufruf erfolgreich ist. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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 Merkmal, für das die Benachrichtigung gesendet werden soll.

• Benachrichtigung

  Benachrichtigung

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

readCharacteristicValue()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• 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: <ph type="x-smartling-placeholder"></ph>

  (result: Characteristic) => void

  • Ergebnis

    Merkmal

Gibt Folgendes zurück:

• Promise<Charakteristik>

  Chrome 91 und höher

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

readDescriptorValue()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Rufen Sie den Wert eines angegebenen charakteristischen Deskriptors 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

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (result: Descriptor) => void

  • Ergebnis

    Beschreibung

Gibt Folgendes zurück:

• Promise&lt;Descriptor&gt;

  Chrome 91 und höher

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

registerAdvertisement()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 47 und höher

chrome.bluetoothLowEnergy.registerAdvertisement(
  advertisement: Advertisement,
  callback?: function,
)

Erstellen Sie eine Anzeige und registrieren Sie sie für Werbung. Um diese Funktion aufzurufen, müssen in der 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 von "--enable-ble-advertising-in-apps" . Weitere Informationen findest du unter https://developer.chrome.com/apps/manifest/bluetooth Hinweis: Auf einigen Hardwaremodi werden zentrale und Peripheriegeräte gleichzeitig unterstützt, aber auf Hardware, die dies nicht unterstützt, wird durch diesen Aufruf das Gerät in den Peripheriemodus versetzt. Bei Hardware, die nicht sowohl den zentralen 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 zentraler Rolle richtig funktionieren (einschließlich der Erkennung von Bluetooth Low Energy-Geräten).

Parameter

• Anzeige

  Anzeige

  Die zu bewerbende Anzeige.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (advertisementId: number) => void

  • advertisementId

    Zahl

Gibt Folgendes zurück:

• Promise&lt;number&gt;

  Chrome 91 und höher

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

registerService()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

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

Registrieren Sie den angegebenen Dienst auf dem lokalen GATT-Server. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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

  Eindeutige ID eines erstellten Dienstes.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

removeService()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

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

Der angegebene Dienst wird entfernt und seine Registrierung wird aufgehoben. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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

  Eindeutige ID eines aktuell registrierten Dienstes.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

resetAdvertising()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 61 und 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 gestoppt.

Parameter

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

  Promise-Objekte 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 für eine Merkmals- oder Deskriptor-Lese-/Schreibanfrage. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 55 und höher

chrome.bluetoothLowEnergy.setAdvertisingInterval(
  minInterval: number,
  maxInterval: number,
  callback?: function,
)

Legt das Intervall zwischen zwei aufeinanderfolgenden Anzeigen fest. Hinweis: Dies wird nach bestem Wissen und Gewissen versucht. Das tatsächliche Intervall kann nicht sehr stark von den angeforderten Intervallen abweichen. Auf manchen Geräten gilt ein Mindestintervall von 100 ms. Die Mindest- und Höchstwerte dürfen den Bereich, der gemäß Bluetooth 4.2-Spezifikation zulässig ist, nicht überschreiten.

Parameter

• minInterval

  Zahl

  Mindestintervall zwischen Anzeigen (in Millisekunden). Dieser Wert darf nicht niedriger als 20 ms sein (gemäß Spezifikation).

• maxInterval

  Zahl

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

startCharacteristicNotifications()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Aktiviert Wertbenachrichtigungen/-anzeigen des angegebenen Merkmals. Nach der Aktivierung kann eine App das onCharacteristicValueChanged-Ereignis zum Anhören von Benachrichtigungen verwenden.

Parameter

• characteristicId

  String

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

• Properties

  NotificationProperties optional

  Eigenschaften der Benachrichtigungssitzung (optional).

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

stopCharacteristicNotifications()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Wertbenachrichtigungen/-anzeigen des angegebenen Merkmals deaktivieren. Nach einem erfolgreichen Aufruf erhält die Anwendung keine Benachrichtigungen/Angaben zu diesem Merkmal mehr.

Parameter

• characteristicId

  String

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

unregisterAdvertisement()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 47 und höher

chrome.bluetoothLowEnergy.unregisterAdvertisement(
  advertisementId: number,
  callback?: function,
)

Hebt die Registrierung einer Anzeige auf und beendet die Registrierung. Wenn die Registrierung nicht aufgehoben wird, können Sie die Werbung nur beenden, indem Sie das Gerät neu starten.

Parameter

• advertisementId

  Zahl

  ID der Anzeige, deren Registrierung aufgehoben werden soll.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

unregisterService()

<ph type="x-smartling-placeholder"></ph> Versprechen Chrome 52 und höher

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

Hebt die Registrierung des angegebenen Dienstes auf dem lokalen GATT-Server auf. Wenn die Dienst-ID ungültig ist, wird „lastError“ festgelegt. Diese Funktion ist nur verfügbar, wenn in der App die Berechtigungen „bluetooth:low_energy“ und „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

  Eindeutige ID eines aktuell registrierten Dienstes.

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

writeCharacteristicValue()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

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

Parameter

• characteristicId

  String

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

• Wert

  ArrayBuffer

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

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

writeDescriptorValue()

<ph type="x-smartling-placeholder"></ph> Versprechen

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

Schreiben Sie den Wert eines angegebenen charakteristischen Deskriptors aus einem Remote-Peripheriegerät.

Parameter

• descriptorId

  String

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

• Wert

  ArrayBuffer

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

• callback

  Funktion optional

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  () => void

Gibt Folgendes zurück:

• Versprechen<void>

  Chrome 91 und höher

  Promise-Objekte 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 anfordert, den Wert eines Merkmals zu lesen, das auf dem lokalen GATT-Server registriert ist. Wenn Sie auf diese Anfrage längere Zeit nicht reagieren, kann dies zu einer Unterbrechung der Verbindung führen. Dieses Ereignis ist nur verfügbar, wenn für die App sowohl die Berechtigungen „bluetooth:low_energy“ als auch die Berechtigungen „bluetooth:peripheral“ auf „true“ festgelegt 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: <ph type="x-smartling-placeholder"></ph>

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

  • Anfrage

    Anfrage

  • 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 zu einer Wertänderung. Dieses Ereignis wird nur gesendet, wenn die App durch Aufrufen von startCharacteristicNotifications Benachrichtigungen aktiviert hat.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (characteristic: Characteristic) => void

  • charakteristisch

    Merkmal

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 Zeit nicht auf diese Anfrage reagieren, kann dies zu einer Unterbrechung der Verbindung führen. Dieses Ereignis ist nur verfügbar, wenn für die App sowohl die Berechtigungen „bluetooth:low_energy“ als auch die Berechtigungen „bluetooth:peripheral“ auf „true“ festgelegt 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: <ph type="x-smartling-placeholder"></ph>

  (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 anfordert, den Wert eines Deskriptors zu lesen, der auf dem lokalen GATT-Server registriert ist. Wenn Sie auf diese Anfrage längere Zeit nicht reagieren, kann dies zu einer Unterbrechung der Verbindung führen. Dieses Ereignis ist nur verfügbar, wenn für die App sowohl die Berechtigungen „bluetooth:low_energy“ als auch die Berechtigungen „bluetooth:peripheral“ auf „true“ festgelegt 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: <ph type="x-smartling-placeholder"></ph>

  (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-Merkmalsdeskriptors ändert, normalerweise als Ergebnis einer Leseanfrage Dieser Termin dient hauptsächlich dem besseren Verständnis und wird nach einem erfolgreichen Aufruf an readDescriptorValue immer gesendet.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (descriptor: Descriptor) => void

  • Schlagwort

    Beschreibung

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 auf diese Anfrage längere Zeit nicht reagieren, kann dies zu einer Unterbrechung der Verbindung führen. Dieses Ereignis ist nur verfügbar, wenn für die App die Berechtigungen „bluetooth:low_energy“ und „bluetooth:peripheral“ auf „true“ festgelegt 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: <ph type="x-smartling-placeholder"></ph>

  (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 Remote-Gerät gefunden wurde.

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (service: Service) => void

  • Dienst

    Dienst

onServiceChanged

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

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

Parameter

• callback

  Funktion

  Der Parameter callback sieht so aus: <ph type="x-smartling-placeholder"></ph>

  (service: Service) => void

  • Dienst

    Dienst

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: <ph type="x-smartling-placeholder"></ph>

  (service: Service) => void

  • Dienst

    Dienst