Report sulle funzionalità del controller radiale di Windows

In questo argomento vengono descritti in dettaglio i report sulle funzionalità HID usati per il supporto del feedback aptico del controller radiale in Windows 10, versione 1607 e versioni successive.

Raccolta feedback aptico (facoltativo)

Se un dispositivo controller radiale Windows supporta il feedback aptico, può consentire al sistema e alle applicazioni di sfruttarlo includendo una raccolta di feedback aptico (Page 0x0E, utilizzo 0x01) all'interno del TLC del controller radiale Windows. Per ulteriori informazioni sul modo in cui la specifica HID supporta il feedback aptico, consultare la pagina Haptics ratificare la specifica HID.

L'host usa i seguenti utilizzi (tramite la raccolta di feedback aptico) per comunicare il supporto della forma d'onda del feedback aptico e consentire all'host di configurare il feedback aptico nel dispositivo controller radiale Windows. Se un dispositivo sceglie di esporre una raccolta di feedback aptici, alcuni utilizzi sono obbligatori per consentire il supporto della configurazione automatica del feedback aptico.

Membro	Descrizione	Pagina	ID	Obbligatorio/Facoltativo
Elenco waveform	Elenco ordinato di forme d'onda aptice supportate dal dispositivo	0x0E	0x10	Obbligatorio
Elenco durata	Elenco ordinato di durate per le forme d'onda nell'elenco waveform	0x0E	0x11	Obbligatorio
Trigger automatico	Waveform to fire automatically at device's discretion	0x0E	0x20	Obbligatorio
Controllo associato al trigger automatico	Utilizzo HID del controllo associato al feedback aptico	0x0E	0x22	Obbligatorio
Intensità	Output: intensità della forma d'onda trigger manuale come percentuale	0x0E	0x23	Facoltativo
Ripeti conteggio	Output: numero di volte in cui riprodurre la forma d'onda trigger manuale dopo la riproduzione iniziale	0x0E	0x24	Facoltativo
Periodo di ripetizione	Output: durata dell'attesa prima della ripetizione del trigger manuale durante la ripetizione	0x0E	0x25	Facoltativo
Waveform Cutoff Time	Max time a Manual Trigger waveform can play before being cut off	0x0E	0x28	Facoltativo

Elenco waveform

L'utilizzo dell'elenco waveform rappresenta una raccolta di utilizzi HID delle forme d'onda supportate, ordinate usando ordinali. Le forme d'onda aptice predefinite sono definite nella specifica HID. Windows supporta l'implementazione delle forme d'onda seguenti per un dispositivo abilitato per il feedback aptico:

Forma d' onda	Descrizione	Pagina	ID	Obbligatorio/Facoltativo
WAVEFORM_NONE	No-op. Non deve influire sullo stato di gioco delle forme d'onda in corso.	0x0E	0x1001	Obbligatorio
WAVEFORM_STOP	Arresta la riproduzione delle forme d'onda in corso.	0x0E	0x1002	Obbligatorio
WAVEFORM_CLICK	Crea un breve feedback "click"	0x0E	0x1003	Obbligatorio
WAVEFORM_BUZZ_CONTINUOUS	Ronzio il dispositivo per un lungo periodo di tempo	0x0E	0x1004	Facoltativo

Sia WAVEFORM_NONE che WAVEFORM_STOP sono necessari per tutti i dispositivi aptici conformi a HID. Gli ordinali 1 e 2 vengono impostati in modo implicito su WAVEFORM_NONE e WAVEFORM_STOP. Non devono essere dichiarati nell'elenco waveform o nell'elenco di durata. L'elenco Waveform dichiara le forme d'onda supportate dal valore minimo fisico e massimo di ogni ordinale nell'elenco.

Elenco durata

L'utilizzo dell'elenco di durata rappresenta una raccolta delle durate per le forme d'onda supportate nell'elenco Waveform, ordinate usando ordinali. L'unità per la durata della forma d'onda è di millisecondi e la durata deve essere un valore diverso da zero positivo per qualsiasi forma d'onda non continua. Se una forma d'onda è continua (verrà riprodotta fino a quando non viene interrotta dall'host o viene superato il time cutoff Waveform), la sua durata viene definita come zero.

si presuppone che WAVEFORM_NONE e WAVEFORM_STOP abbiano una durata pari a zero. Non è necessario dichiarare nell'elenco di durata.

Trigger automatico

L'utilizzo del trigger automatico rappresenta un utilizzo della forma d'onda supportato dall'elenco waveform che verrà attivato automaticamente dal dispositivo in base alle interazioni dell'utente. Ciò consente una risposta a bassa latenza alle interazioni utente comuni, ad esempio la rotazione e il clic. Potrebbe essere necessario modificare o disabilitare l'host e può essere impostato tramite un report delle funzionalità. La forma d'onda del trigger automatico può essere disabilitata impostando su zero dall'host.

Controllo associato al trigger automatico

Il controllo associato al trigger automatico specifica l'utilizzo esteso di HID del controllo fisico associato al feedback aptico automatico nel dispositivo. Per un dispositivo controller radiale, questo controllo deve essere definito come utilizzo dial specificato all'interno della stessa raccolta di livello superiore.

Intensità

L'utilizzo dell'intensità rappresenta la percentuale di intensità massima da applicare a una forma d'onda. Questo valore deve variare tra 0 e 100%. Il 100% indica che le forme d'onda verranno attivate dal dispositivo al massimo livello di forza e il 0% indica che il trasducente aptico non è abilitato.

Se definito in un report delle funzionalità, imposta l'intensità predefinita per tutti i trigger automatici e le forme d'onda trigger manuali per il dispositivo.

Ripeti conteggio

L'utilizzo del conteggio ripetizioni rappresenta il numero di volte in cui ripetere una forma d'onda. Un conteggio ripetizione pari a zero indica che la forma d'onda trigger manuale deve essere riprodotta una sola volta (nessuna ripetizione). Se è stato superato il time cutoff waveform, è previsto che tutte le ripetizioni incomplete vengano ignorate.

Se definito in un report delle funzionalità, imposta il numero di ripetizioni predefinito per tutti i trigger automatici e le forme d'onda trigger manuali per il dispositivo.

Periodo di ripetizione

L'utilizzo del periodo di ripetizione rappresenta la quantità di tempo di attesa del dispositivo prima di ripetere una forma d'onda trigger manuale in un report di output, in base al valore specificato da Ripeti conteggio. Le unità per questo valore sono millisecondi. Se il periodo retrigger è inferiore alla durata della forma d'onda riprodotta, la forma d'onda deve essere arrestata e riavviata nel periodo di tempo indicato dal periodo di ripetizione.

Se definito in un report delle funzionalità, imposta il periodo di ripetizione predefinito per tutti i trigger automatici e le forme d'onda trigger manuali per il dispositivo.

Waveform Cutoff Time

L'utilizzo di Waveform Cutoff Time rappresenta la quantità massima di tempo che il dispositivo consentirà di ripetere una forma d'onda trigger manuale prima di terminare la riproduzione. Si tratta di un valore costante per il dispositivo e include sia forme d'onda continue senza durate impostate, sia forme d'onda con durate discrete che vengono impostate per ripetere molte volte. Le unità per questo valore sono millisecondi.