BluetoothRemoteGATTCharacteristic

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.

Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.

Das BluetoothRemoteGattCharacteristic-Interface der Web Bluetooth API repräsentiert eine GATT-Charakteristik, die ein grundlegendes Datenelement ist und weitere Informationen über den Dienst eines Peripheriegeräts bereitstellt.

EventTarget BluetoothRemoteGATTCharacteristic

Instanzeigenschaften

BluetoothRemoteGATTCharacteristic.service Schreibgeschützt Experimentell

Gibt den BluetoothRemoteGATTService zurück, zu dem diese Charakteristik gehört.

BluetoothRemoteGATTCharacteristic.uuid Schreibgeschützt Experimentell

Gibt einen String zurück, der die UUID der Charakteristik enthält, zum Beispiel '00002a37-0000-1000-8000-00805f9b34fb' für die Herzfrequenzmessungs-Charakteristik.

BluetoothRemoteGATTCharacteristic.properties Schreibgeschützt Experimentell

Gibt die Eigenschaften dieser Charakteristik zurück.

BluetoothRemoteGATTCharacteristic.value Schreibgeschützt Experimentell

Der derzeit zwischengespeicherte Wert der Charakteristik. Dieser Wert wird aktualisiert, wenn der Wert der Charakteristik gelesen oder über eine Benachrichtigung oder eine Indikation aktualisiert wird.

Instanzmethoden

BluetoothRemoteGATTCharacteristic.getDescriptor() Experimentell

Gibt ein Promise zurück, das beim ersten BluetoothRemoteGATTDescriptor für eine gegebene Descriptor-UUID aufgelöst wird.

BluetoothRemoteGATTCharacteristic.getDescriptors() Experimentell

Gibt ein Promise zurück, das zu einem Array aller BluetoothRemoteGATTDescriptor-Objekte für eine gegebene Descriptor-UUID aufgelöst wird.

BluetoothRemoteGATTCharacteristic.readValue() Experimentell

Gibt ein Promise zurück, das zu einem DataView aufgelöst wird, das eine Kopie der value-Eigenschaft enthält, wenn diese verfügbar und unterstützt ist. Andernfalls wird ein Fehler ausgelöst.

BluetoothRemoteGATTCharacteristic.writeValue() Veraltet

Setzt die value-Eigenschaft auf die Bytes, die in einem gegebenen ArrayBuffer enthalten sind, schreibt den Charakteristikwert mit optionaler Antwort und gibt das resultierende Promise zurück.

BluetoothRemoteGATTCharacteristic.writeValueWithResponse() Experimentell

Setzt die value-Eigenschaft auf die Bytes, die in einem gegebenen ArrayBuffer enthalten sind, schreibt den Charakteristikwert mit erforderlicher Antwort und gibt das resultierende Promise zurück.

BluetoothRemoteGATTCharacteristic.writeValueWithoutResponse() Experimentell

Setzt die value-Eigenschaft auf die Bytes, die in einem gegebenen ArrayBuffer enthalten sind, schreibt den Charakteristikwert ohne Antwort und gibt das resultierende Promise zurück.

BluetoothRemoteGATTCharacteristic.startNotifications() Experimentell

Gibt ein Promise zurück, das aufgelöst wird, wenn navigator.bluetooth zum aktiven Benachrichtigungskontext hinzugefügt wird.

BluetoothRemoteGATTCharacteristic.stopNotifications() Experimentell

Gibt ein Promise zurück, das aufgelöst wird, wenn navigator.bluetooth aus dem aktiven Benachrichtigungskontext entfernt wird.

Ereignisse

characteristicvaluechanged Experimentell

Wird bei einer BluetoothRemoteGATTCharacteristic ausgelöst, wenn sich deren Wert ändert.

Spezifikationen

Specification
Web Bluetooth
# bluetoothgattcharacteristic-interface

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
BluetoothRemoteGATTCharacteristic
Experimental
characteristicvaluechanged event
Experimental
getDescriptor
Experimental
getDescriptors
Experimental
properties
Experimental
readValue
Experimental
service
Experimental
startNotifications
Experimental
stopNotifications
Experimental
uuid
Experimental
value
Experimental
writeValue
Deprecated
writeValueWithResponse
Experimental
writeValueWithoutResponse
Experimental

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Experimental. Expect behavior to change in the future.
Deprecated. Not for use in new websites.
See implementation notes.
Has more compatibility info.