Report di output del controller radiale windows

In questo argomento vengono descritti in dettaglio i report di output 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, Usage 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 gli utilizzi seguenti in un report di output (tramite la raccolta di feedback aptico) per consentire all'host di inviare eventi di feedback aptico al dispositivo controller radiale Windows. Se un dispositivo sceglie di esporre una raccolta di feedback aptici, alcuni utilizzi sono obbligatori per consentire il supporto del feedback aptico avviato dall'host.

Membro	Descrizione	Pagina	ID	Obbligatorio/Facoltativo
Trigger manuale	Waveform da attivare come comando esplicito dall'host.	0x0E	0x21	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

Attivazione manuale

L'utilizzo del trigger manuale rappresenta un utilizzo della forma d'onda supportato dall'elenco di forme d'onda che è stato richiesto di essere riprodotto dall'host. Quando un report di output contenente un trigger manuale diverso da WAVEFORM_NONE viene inviato al dispositivo, deve iniziare immediatamente a riprodurre la forma d'onda specificata con le proprietà aggiuntive incluse nel report di output (Intensità, Conteggio ripetizioni, Periodo di ripetizione). Quando un report di output contiene un trigger manuale di WAVEFORM_STOP, è necessario arrestare qualsiasi riproduzione della forma d'onda in corso.

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 impostato in un report di output, questo valore sostituirà l'intensità predefinita per la forma d'onda trigger manuale definita nello stesso report di output. Non viene impostata una nuova intensità predefinita.

Numero ripetizioni

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 il tempo di cutoff della forma d'onda è stato superato, è previsto che tutte le ripetizioni incomplete verranno ignorate.

Se impostato in un report di output, questo valore sostituisce il numero di ripetizioni predefinito per la forma d'onda trigger manuale definita nello stesso report di output. Non viene impostato un nuovo conteggio ripetizioni predefinito.

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 impostato in un report di output, esegue l'override del periodo di ripetizione predefinito per la forma d'onda trigger manuale definita nello stesso report di output. Non viene impostato un nuovo periodo di ripetizione predefinito.