Relatórios de saída do controlador radial do Windows
Esse tópico detalha o relatório de saída de HID usado para dar suporte a comentários hápticos do controlador radial no Windows 10, versão 1607 e sistemas operacionais posteriores.
Coleção de comentários hápticos (opcional)
Se um dispositivo controlador radial do Windows der suporte a comentários hápticos, ele poderá permitir que o sistema e os aplicativos aproveitem isso incluindo uma coleção de comentários hápticos ( 0x0E de página, 0x01 de uso) dentro do TLC do controlador radial do Windows. Para obter mais informações sobre como a especificação HID dá suporte a comentários hápticos, consulte a ratificação da página Haptics para a especificação HID.
O host usa os seguintes usos em um relatório de saída (por meio da coleção de comentários hápticos) para permitir que o host emita eventos de comentários hápticos para o dispositivo do controlador radial do Windows. Se um dispositivo optar por expor uma coleção de comentários táteis, alguns usos serão obrigatórios para permitir o suporte a comentários táteis iniciados por host.
| Membro | Descrição | ? | ID | Obrigatório/opcional |
|---|---|---|---|---|
| Gatilho manual | Forma de onda a ser acionada como comando explícito do host. | 0x0E | 0x21 | Obrigatório |
| Intensidade | Saída – intensidade da forma de onda do Disparador manual como porcentagem | 0x0E | 0x23 | Opcional |
| Contagem repetida | Saída – número de vezes para reproduzir a forma de onda do Disparador manual após a reprodução inicial | 0x0E | 0x24 | Opcional |
| Tempo até novo disparo | Saída – tempo a aguardar antes de disparar novamente o Disparador manual ao repetir | 0x0E | 0x25 | Opcional |
Gatilho manual
O uso do Gatilho Manual representa um uso de forma de onda com suporte da lista de forma de onda que foi solicitada para ser reproduzida pelo host. Quando um relatório de saída que contém um Gatilho manual diferente de WAVEFORM_NONE é enviado para o dispositivo, ele deve começar a reproduzir imediatamente a forma de onda especificada com as propriedades adicionais incluídas no relatório de saída (Intensidade, Contagem de Repetição, Período de repetição). Quando um relatório de saída contém um Gatilho manual de WAVEFORM_STOP, qualquer reprodução de forma de onda contínua deve ser interrompida.
Intensidade
O uso de Intensidade representa a porcentagem de intensidade máxima a ser aplicada a uma forma de onda. Esse valor deve variar entre 0 e 100%. Cem por cento (100%) indica que as formas de onda serão disparadas pelo dispositivo em sua força máxima, e zero por cento (0%) indica que o transdutor tátil não está habilitado.
Quando definido em um relatório de saída, esse valor substituirá a intensidade padrão para a forma de onda gatilho manual definida no mesmo relatório de saída. Isso não define uma nova Intensidade padrão.
Contagem repetida
O uso de Contagem de repetição representa o número de vezes a repetir uma forma de onda. Uma Contagem de repetição de zero indica que a forma de onda do Disparador manual deve ser executada uma única vez (sem repetição). Se o tempo de corte da forma de onda tiver sido excedido, espera-se que qualquer repetição incompleta seja ignorada.
Quando definido em um relatório de saída, esse valor substitui a contagem de repetição padrão para a forma de onda gatilho manual definida no mesmo relatório de saída. Isso não define uma nova Contagem de Repetição padrão.
Tempo até novo disparo
O uso do Tempo até novo disparo representa a quantidade de tempo que o dispositivo deve aguardar antes de repetir uma forma de onda do Disparador manual em um relatório de saída, de acordo com o valor especificado pela Contagem de repetições. As unidades para esse valor são milissegundos. Se o Tempo até novo disparo for menor que a duração da forma de onda que está sendo reproduzida, a forma de onda deverá ser interrompida e reiniciada no período de tempo indicado pelo tempo até novo disparo.
Quando definido em um relatório de saída, ele substitui o período de repetição padrão para a forma de onda gatilho manual definida no mesmo relatório de saída. Isso não define um novo Período de Repetição padrão.