HIDDevice: sendFeatureReport()-Methode
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.
Hinweis: Dieses Feature ist verfügbar in Web Workers, außer in Shared Web Workers.
Die sendFeatureReport()
-Methode des HIDDevice
-Interfaces sendet einen Feature-Report an das HID-Gerät. Feature-Reports sind eine Möglichkeit für HID-Geräte und Anwendungen, nicht standardisierte HID-Daten auszutauschen.
Die reportId
für jedes der von diesem Gerät unterstützten Berichtformate kann von HIDDevice.collections
abgerufen werden.
Syntax
sendFeatureReport(reportId, data)
Parameter
reportId
-
Eine 8-Bit-Report-ID. Wenn das HID-Gerät keine Report-IDs verwendet, senden Sie
0
. data
-
Bytes als ein
ArrayBuffer
, einTypedArray
, oder einDataView
.
Rückgabewert
Ein Promise
, das mit undefined
gelöst wird, sobald der Report gesendet wurde.
Ausnahmen
NotAllowedError
DOMException
-
Wird ausgelöst, wenn das Senden des Reports aus irgendeinem Grund fehlschlägt.
Beispiele
Im folgenden Beispiel lässt sendFeatureReport()
ein Gerät blinken. Weitere Beispiele und Live-Demos finden Sie im Artikel Connecting to uncommon HID devices.
const reportId = 1;
for (let i = 0; i < 10; i++) {
// Turn off
await device.sendFeatureReport(reportId, Uint32Array.from([0, 0]));
await new Promise((resolve) => setTimeout(resolve, 100));
// Turn on
await device.sendFeatureReport(reportId, Uint32Array.from([512, 0]));
await new Promise((resolve) => setTimeout(resolve, 100));
}
Spezifikationen
Specification |
---|
WebHID API # dom-hiddevice-sendfeaturereport |
Browser-Kompatibilität
BCD tables only load in the browser