HIDInputReportEvent
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 HIDInputReportEvent
-Interface der WebHID API wird an das inputreport
-Ereignis von HIDDevice
übergeben, wenn ein Eingabereport von einem zugehörigen HID-Gerät empfangen wird.
Instanzeigenschaften
Dieses Interface erbt auch Eigenschaften von Event
.
HIDInputReportEvent.data
Schreibgeschützt Experimentell-
Ein
DataView
, das die Daten des Eingabereports enthält, ohne diereportId
, falls die HID-Schnittstelle Berichts-IDs verwendet. HIDInputReportEvent.device
Schreibgeschützt Experimentell-
Die
HIDDevice
-Instanz, die die HID-Schnittstelle repräsentiert, die den Eingabereport gesendet hat. HIDInputReportEvent.reportId
Schreibgeschützt Experimentell-
Das Ein-Byte-Identifikationspräfix für diesen Report oder 0, wenn die HID-Schnittstelle keine Berichts-IDs verwendet.
Instanzmethoden
Dieses Interface erbt Methoden von seinem Eltern-Interface, Event
.
Beispiele
Das folgende Beispiel zeigt das Lauschen auf ein inputReport
, das es der Anwendung ermöglicht, zu erkennen, welcher Knopf auf einem Joy-Con Right-Gerät gedrückt wird. Weitere Beispiele und Live-Demos finden Sie im Artikel Connecting to uncommon HID devices.
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-hidinputreportevent |
Browser-Kompatibilität
BCD tables only load in the browser