Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

HIDDevice: inputreport-Ereignis

Eingeschränkt verfügbar

Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.

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 der HIDDevice-Schnittstelle wird ausgelöst, wenn ein neuer Bericht vom HID-Gerät empfangen wird.

Syntax

Verwenden Sie den Ereignisnamen in addEventListener():

js
addEventListener("inputreport", (event) => { })

Alternativ können Sie ihn der Event-Handler-Eigenschaft der Schnittstelle zuweisen:

js
oninputreport = (event) => { }

Ereignistyp

Ein HIDInputReportEvent. Erbt von Event.

Event HIDInputReportEvent

Beispiel

Das folgende Beispiel zeigt, wie Sie auf ein inputreport-Ereignis reagieren, um zu erkennen, welche Taste auf einem Joy-Con Right-Gerät gedrückt wird. Weitere Beispiele und interaktive Demos finden Sie im Artikel Verbindung mit ungewöhnlichen HID-Geräten herstellen.

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

Spezifikation
WebHID
# dom-hiddevice-oninputreport

Browser-Kompatibilität