Featureberichte für Windows Radial Controller
Dieses Thema behandelt die HID-Featureberichte, die für die Unterstützung von haptischem Feedback für Radial Controller in Windows 10, Version 1607 und höher verwendet werden.
Sammlung haptischen Feedbacks (optional)
Wenn ein Windows Radial Controller-Gerät haptisches Feedback unterstützt, können System und Anwendungen dies nutzen, indem sie innerhalb des Windows Radial Controller-TLC eine Sammlung haptischen Feedbacks einschließen (Seite 0x0E, Nutzung 0x01). 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 die folgenden Nutzungen (über die Sammlung haptischen Feedbacks), um die Wellenformunterstützung für haptisches Feedback zu kommunizieren und dem Host die Konfiguration des haptischen Feedbacks auf dem Windows-Radialcontroller-Gerät zu ermöglichen. Wenn ein Gerät die Sammlung haptischen Feedbacks verfügbar macht, sind einige Nutzungen für die automatische Konfiguration des haptischen Feedbacks obligatorisch.
| Member | BESCHREIBUNG | Seite | ID | Obligatorisch/Optional |
|---|---|---|---|---|
| Wellenformliste | Sortierte Liste der haptischen Wellenformen, die vom Gerät unterstützt werden | 0x0E | 0x10 | Obligatorisch. |
| Dauerliste | Sortierte Liste der Dauern der Wellenformen in der Waveform-Liste | 0x0E | 0x11 | Obligatorisch. |
| Automatischer Trigger | Wellenform, die automatisch nach Ermessen des Geräts ausgelöst werden soll | 0x0E | 0x20 | Obligatorisch. |
| Zugeordnetes Steuerelement des automatischen Triggers | HID-Nutzung des Steuerelements, das haptischem Feedback zugeordnet ist | 0x0E | 0x22 | 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 |
| Wellenform-Cutoff-Zeit | Max. Zeit, für die eine manuelle Triggerwellenform wiedergegeben werden kann, bevor sie beendet wird | 0x0E | 0x28 | Optional |
Wellenformliste
Die Verwendung der Wellenformliste stellt eine mithilfe von Ordnungszeichen sortierte Auflistung der HID-Nutzungen von unterstützten Wellenformen dar. Die vordefinierten Haptik-Wellenformen sind in der HID-Spezifikation angegeben. Windows unterstützt die Implementierung der folgenden Wellenformen für ein Gerät, das haptisches Feedback unterstützt:
| Wellenform | BESCHREIBUNG | Seite | ID | Obligatorisch/Optional |
|---|---|---|---|---|
| WAVEFORM_NONE | No-op. Sollte sich nicht auf den Wiedergabezustand der laufenden Wellenformen auswirken. | 0x0E | 0x1001 | Obligatorisch. |
| WAVEFORM_STOP | Hält die Wiedergabe der laufenden Wellenform an. | 0x0E | 0x1002 | Obligatorisch. |
| WAVEFORM_CLICK | Erzeugt ein kurzes „Klick“-Feedback | 0x0E | 0x1003 | Obligatorisch. |
| WAVEFORM_BUZZ_CONTINUOUS | Lässt das Gerät für längere Zeit vibrieren | 0x0E | 0x1004 | Optional |
Sowohl WAVEFORM_NONE als auch WAVEFORM_STOP sind für alle HID-kompatiblen Haptikgeräte erforderlich. Ordnungszeichen 1 und 2 werden implizit auf WAVEFORM_NONE und WAVEFORM_STOP festgelegt. Sie müssen nicht in der Wellenformliste oder Dauerliste deklariert werden. In der Wellenformliste werden unterstützte Wellenformen mit dem physischem Minimum und Maximum der einzelnen Ordinale in der Liste angegeben.
Dauerliste
Die Nutzung der Dauerliste ist eine Sammlung der Dauer der unterstützten Wellenformen der Wellenformliste, sortiert mithilfe von Ordnungszeichen. Die Einheit für die Wellenformdauer ist Millisekunden, die Dauer muss für eine nicht fortlaufende Wellenform ein positiver Nicht-Null-Wert sein. Wenn eine Wellenform kontinuierlich ist (wiedergegeben wird, bis der Host sie anhält oder die Wellenform-Cutoff-Zeit überschritten wird), ist die Dauer mit Null angegeben.
Für WAVEFORM_NONE und WAVEFORM_STOP wird angenommen, dass die Dauer Null beträgt. Sie müssen nicht in der Dauerliste deklariert werden.
Automatischer Trigger
Die Nutzung des automatischen Triggers entspricht der Nutzung einer unterstützten Wellenform aus der Wellenformliste, die anhand der Benutzerinteraktionen automatisch vom Gerät ausgelöst wird. Dies ermöglicht eine schnellere Reaktion auf häufige Benutzerinteraktionen wie Drehen und Klicken. Dies muss möglicherweise vom Host geändert oder deaktiviert werden und kann über einen Featurebericht festgelegt werden. Die Wellenform des automatischen Triggers kann deaktiviert werden, indem Sie vom Host auf Null festgelegt wird.
Zugeordnetes Steuerelement des automatischen Triggers
Das zugeordnete Steuerelement für den automatischen Trigger gibt die erweiterte HID-Nutzung des physischen Steuerelements an, das dem automatischen haptischen Feedback des Geräts zugeordnet ist. Für ein Radial Controller-Gerät sollte dieses Steuerelement als die in derselben Sammlung der obersten Ebene angegebene Dial-Nutzung definiert 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 Messwandler nicht aktiviert wird.
Wenn in einem Featurebericht definiert, legt dies die Standardintensität für alle automatischen Trigger- und manuellen Triggerwellenformen des Geräts fest.
Zahl der 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). Wird die Wellenform-Cutoff-Zeit überschritten, sollten unvollendete Wiederholungen ignoriert werden.
Wenn dies in einem Featurebericht definiert wurde, legt dies die Standardzahl der Wiederholungen für alle automatischen Trigger- und manuellen Triggerwellenformen des Geräts fest.
Wiederholungszeitraum
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. Wenn der Wiederholungszeitraum kleiner als die Dauer der wiedergegebenen Wellenform ist, sollte die Wellenform beendet und nach dem Wiederholungszeitraum neu gestartet werden.
Wenn dies in einem Featurebericht definiert wurde, legt dies den Standard-Wiederholungszeitraum für alle automatischen Trigger- und manuellen Triggerwellenformen des Geräts fest.
Wellenform-Cutoff-Zeit
Die Wellenform-Cutoff-Zeit-Nutzung gibt maximale Dauer an, für die eine manuelle Triggerwellenform wiederholt werden kann, bevor die Wiedergabe beendet wird. Dies ist ein konstanter Wert für das Gerät und enthält sowohl fortlaufende Wellenformen ohne festgelegte Dauer als auch Wellenformen mit diskreter Dauer, die mehrmals wiederholt werden. Dieser Wert wird in Millisekunden angegeben.