Relatórios de recursos do controlador radial do Windows
Este tópico detalha os relatórios de recursos HID usados 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 (Página 0x0E, uso 0x01) no TLC do controlador radial do Windows. Para obter mais informações sobre como a especificação HID dá suporte a comentários táteis, confira a ratificação da página Táteis para a especificação de HID.
O host usa os seguintes usos (por meio da coleção de comentários hápticos) para comunicar o suporte de forma de onda de comentários hápticos e permitir que o host configure os comentários hápticos no dispositivo do controlador radial do Windows. Se um dispositivo optar por expor uma coleção de comentários hápticos, alguns usos serão obrigatórios para permitir que a configuração automática de comentários hápticos tenha suporte.
| Membro | Descrição | ? | ID | Obrigatório/opcional |
|---|---|---|---|---|
| Lista de formas de onda | Lista ordenada de formas de onda táteis com suporte do dispositivo | 0x0E | 0x10 | Obrigatório |
| Lista de durações | Lista ordenada de durações para formas de onda na Lista de formas de onda | 0x0E | 0x11 | Obrigatório |
| Disparador automático | Forma de onda a ser disparada automaticamente a critério do dispositivo | 0x0E | 0x20 | Obrigatório |
| Controle associado ao Disparador automático | Uso de HID do controle associado a comentários táteis | 0x0E | 0x22 | 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 |
| Tempo de corte de formas de onda | Tempo máximo em que uma forma de onda do Disparador manual pode ser reproduzida antes de ser cortada | 0x0E | 0x28 | Opcional |
Lista de formas de onda
O uso da Lista de formas de onda representa uma coleção dos usos de HID de formas de onda com suporte, ordenadas usando ordinais. As formas de onda hápticas predefinidas são definidas na especificação de HID. O Windows dá suporte à implementação das seguintes formas de onda para um dispositivo habilitado para comentários hápticos:
| Forma de onda | Description | ? | ID | Obrigatório/opcional |
|---|---|---|---|---|
| WAVEFORM_NONE | No-op. Não deve afetar o estado da execução das formas de onda em andamento. | 0x0E | 0x1001 | Obrigatório |
| WAVEFORM_STOP | Interrompe a reprodução das formas de onda em andamento. | 0x0E | 0x1002 | Obrigatório |
| WAVEFORM_CLICK | Cria um breve comentário de "clique" | 0x0E | 0x1003 | Obrigatório |
| WAVEFORM_BUZZ_CONTINUOUS | Toca o dispositivo por um longo período de tempo | 0x0E | 0x1004 | Opcional |
Tanto WAVEFORM_NONE quanto WAVEFORM_STOP são necessários para todos os dispositivos hápticos compatíveis com HID. Os Ordinais 1 e 2 são definidos implicitamente como WAVEFORM_NONE e WAVEFORM_STOP. Eles não precisam estar declarados na Lista de formas de onda ou na Lista de durações. A Lista de formas de onda declara formas de onda com suporte pelos físicos mínimo e máximo de cada ordinal na lista.
Lista de durações
O uso da Lista de durações representa uma coleção das durações para as formas de onda com suporte na Lista de formas de onda, ordenada usando ordinais. A unidade para a duração de formas de onda é de milissegundos, sendo que a duração deve ser um valor positivo diferente de zero para qualquer forma de onda não contínua. Se uma forma de onda for contínua (será reproduzida até ser interrompida pelo host ou o Tempo de corte de formas de onda ser excedido), sua duração será definida como zero.
O WAVEFORM_NONE e o WAVEFORM_STOP têm uma duração igual a zero. Eles não precisam ser declarados na Lista de duração.
Disparador automático
O uso do Disparador automático representa um uso de forma de onda com suporte da Lista de formas de onda que será disparada automaticamente pelo dispositivo conforme necessário com base nas interações do usuário. Isso permite uma resposta de menor latência a interações comuns do usuário, como rotação e clique. Isso pode precisar ser modificado ou desabilitado pelo host e pode ser definido por meio de um relatório de recursos. A forma de onda do Disparador automático pode ser desabilitada sendo definida como zero pelo host.
Controle associado ao Disparador automático
O Controle associado ao Disparador automático especifica o uso estendido de HID do controle físico associado a comentários hápticos automáticos no dispositivo. Para um dispositivo de controlador radial, esse controle deve ser definido como o uso de Discagem especificado na mesma coleção de nível superior.
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 háptico não está habilitado.
Se definido em um relatório de recursos, ele define a intensidade padrão para todas as formas de onda do Disparador automático e do Disparador manual para o dispositivo.
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 de Formas de Onda tiver sido excedido, espera-se que todas as repetições incompletas sejam ignoradas.
Se definido em um relatório de recursos, ele define a contagem de repetições padrão para todas as formas de onda do Disparador automático e do Disparador manual para o dispositivo.
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.
Se definido em um relatório de recursos, ele define a tempo até novo disparo padrão para todas as formas de onda do Disparador automático e do Disparador manual para o dispositivo.
Tempo de Corte de Formas de Onda
O uso do Tempo de corte de formas de onda representa a quantidade máxima de tempo que o dispositivo permitirá que uma forma de onda do Disparador manual seja repetida antes de encerrar a reprodução. Esse é um valor constante para o dispositivo e inclui formas de onda contínuas sem durações definidas e formas de onda com durações discretas que são definidas para serem repetidas muitas vezes. As unidades para esse valor são milissegundos.