Ausgabeberichte für radiale Windows-Controller
In diesem Thema werden die HID-Ausgabeberichte beschrieben, die für die haptische Rückmeldung radialer Controllers in Windows 10, Version 1607 und späteren Betriebssystemen verwendet werden.
Sammlung haptischen Feedbacks (optional)
Wenn ein radialer Windows-Controller haptisches Feedback unterstützt, können System und Anwendungen dies nutzen, indem sie eine Sammlung haptischen Feedbacks (Seite 0x0E, Verwendung 0x01) in die TLC für radiale Windows-Controller einschließen. Weitere Informationen zur Unterstützung haptischen Feedbacks durch die HID-Spezifikation finden Sie auf der Haptikseite der Ratifizierung für die HID-Spezifikation.
Der Host verwendet in einem Ausgabebericht (über die Sammlung haptischen Feedbacks) Folgendes, um es dem Host zu ermöglichen, haptische Feedbackereignisse an den radialen Windows-Controller auszugeben. Wenn ein Gerät eine Sammlung haptischen Feedbacks bereitstellt, sind einige Verwendungen obligatorisch, damit vom Host initiiertes haptisches Feedback unterstützt wird.
| Member | BESCHREIBUNG | Seite | ID | Obligatorisch/Optional |
|---|---|---|---|---|
| Manueller Trigger | Wellenform zum hostseitigen Auslösen als expliziter Befehl | 0x0E | 0x21 | Obligatorisch. |
| Intensität | Ausgabe: Intensität der Wellenform des manuellen Triggers als Prozentsatz | 0x0E | 0x23 | Optional |
| Zahl der Wiederholungen | Ausgabe: Wiedergabehäufigkeit der Wellenform des manuellen Triggers nach der ersten Wiedergabe | 0x0E | 0x24 | Optional |
| Zeitraum bis zum erneuten Auslösen | Ausgabe: Wartezeit bis zum erneuten Auslösen des manuellen Triggers bei Wiederholungen | 0x0E | 0x25 | Optional |
Manueller Trigger
Die Verwendung des manuellen Triggers stellt eine unterstützte Wellenformverwendung aus der Wellenformliste dar, deren Wiedergabe vom Host angefordert wurde. Wenn ein Ausgabebericht, der einen anderen manuellen Trigger als „WAVEFORM_NONE“ enthält, an das Gerät gesendet wird, sollte sofort mit der Wiedergabe der angegebenen Wellenform mit den zusätzlichen Eigenschaften begonnen werden, die im Ausgabebericht enthalten sind (Intensität, Wiederholungsanzahl, Zeitraum bis zum erneuten Auslösen). Wenn ein Ausgabebericht einen manuellen Trigger vom Typ „WAVEFORM_STOP“ enthält, sollten alle aktiven Wellenformwiedergaben beendet werden.
Intensität
Die Intensitätsverwendung stellt den Prozentsatz der maximalen Intensität dar, die auf eine Wellenform angewendet werden soll. Dieser Wert kann zwischen 0 und 100 Prozent variieren. 100 Prozent gibt an, dass Wellenformen vom Gerät mit ihrer maximalen Stärke ausgelöst werden, und 0 Prozent gibt an, dass der haptische Wandler nicht aktiviert wird.
Wenn dieser Wert in einem Ausgabebericht festgelegt ist, überschreibt er die im gleichen Ausgabebericht definierte Standardintensität für die Wellenform des manuellen Triggers. Dadurch wird keine neue Standardintensität festgelegt.
Wiederholungen
Die Nutzung „Zahl der Wiederholungen“ gibt an, wie oft eine Wellenform wiederholt wird. Eine Zahl der Wiederholungen von Null gibt an, dass die manuelle Triggerwellenform nur ein mal wiedergegeben werden soll (keine Wiederholung). Wenn die Wellenform-Cutoff-Zeit überschritten wurde, wird erwartet, dass alle unvollständigen Wiederholungen ignoriert werden.
Wenn dieser Wert in einem Ausgabebericht festgelegt ist, überschreibt er die im gleichen Ausgabebericht definierte Standardwiederholungsanzahl für die Wellenform des manuellen Triggers. Dadurch wird keine neue Standardwiederholungsanzahl festgelegt.
Zeitraum bis zum erneuten Auslösen
Die Verwendung des Zeitraums bis zum erneuten Auslösen gibt an, wie lange das Gerät warten soll, bis es eine Wellenform für den manuellen Trigger in einem Ausgabebericht gemäß der angegebenen Wiederholungsanzahl wiederholt. Dieser Wert wird in Millisekunden angegeben. Ist der Zeitraum bis zum erneuten Auslösen kleiner als die Dauer der wiedergegebenen Wellenform, sollte die Wellenform beendet und nach dem Zeitraum bis zum erneuten Auslösen neu gestartet werden.
Wenn dieser Wert in einem Ausgabebericht festgelegt ist, überschreibt er den im gleichen Ausgabebericht definierten Standardzeitraum bis zum erneuten Auslösen für die Wellenform des manuellen Triggers. Dadurch wird kein neuer Standardzeitraum bis zum erneuten Auslösen festgelegt.