HIDDevice: inputreport Ereignis
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.
Das inputreport Ereignis des HIDDevice-Interfaces wird ausgelöst, wenn ein neuer Bericht vom HID-Gerät empfangen wird.
Syntax
Verwenden Sie den Ereignisnamen in Methoden wie addEventListener(), oder setzen Sie eine Ereignis-Handler-Eigenschaft.
addEventListener("inputreport", (event) => { })
oninputreport = (event) => { }
Ereignistyp
Ein HIDInputReportEvent. Erbt von Event.
Ereigniseigenschaften
Dieses Interface erbt auch Eigenschaften von Event.
HIDInputReportEvent.dataSchreibgeschützt-
Ein
DataView, das die Daten des Eingabebereichs enthält, ohne diereportId, wenn das HID-Interface Bericht-IDs verwendet. HIDInputReportEvent.deviceSchreibgeschützt-
Die
HIDDevice-Instanz, die das HID-Interface darstellt, das den Eingabebereich gesendet hat. HIDInputReportEvent.reportIdSchreibgeschützt-
Das ein Byte lange Identifikationspräfix für diesen Bericht, oder 0, wenn das HID-Interface keine Bericht-IDs verwendet.
Beispiel
Das folgende Beispiel demonstriert, wie man auf ein inputreport Ereignis hört, das es der Anwendung ermöglicht, zu erkennen, welche Taste auf einem Joy-Con Right Gerät gedrückt wird. Weitere Beispiele und Live-Demos finden Sie im Artikel Verbindung zu ungewöhnlichen HID-Geräten.
device.addEventListener("inputreport", (event) => {
const { data, device, reportId } = event;
// Handle only the Joy-Con Right device and a specific report ID.
if (device.productId !== 0x2007 && reportId !== 0x3f) return;
const value = data.getUint8(0);
if (value === 0) return;
const someButtons = { 1: "A", 2: "X", 4: "B", 8: "Y" };
console.log(`User pressed button ${someButtons[value]}.`);
});
Spezifikationen
| Specification |
|---|
| WebHID API # dom-hiddevice-oninputreport |
Browser-Kompatibilität
Loading…