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.

Event HIDInputReportEvent

Instanzeigenschaften

Dieses Interface erbt auch Eigenschaften von Event.

HIDInputReportEvent.data Schreibgeschützt Experimentell

Ein DataView, das die Daten des Eingabereports enthält, ohne die reportId, 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.

js
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