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 vor der Verwendung auf produktiven Webseiten.
Hinweis: This feature is available in Web Workers, except for 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
NotAllowedErrorDOMException-
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
Loading…