informes de características del controlador radial de Windows
En este tema se detallan los informes de características de HID que se usan en la compatibilidad con la retroalimentación háptica del controlador radial en Windows 10, versión 1607 y sistemas operativos posteriores.
Recopilación de respuestas hápticas (opcional)
Si un dispositivo de controlador radial de Windows admite respuesta háptica, puede permitir que el sistema y las aplicaciones lo aprovechen incluyendo una recopilación de respuestas hápticas (página 0x0E, uso 0x01) dentro del TLC del controlador radial de Windows. Para obtener más información sobre cómo la especificación HID admite realimentación háptica, consulte la página Háptica ratificación de la especificación hid.
El host emplea los siguientes usos (a través de la recopilación de respuestas hápticas) para comunicar la compatibilidad con la forma de onda de la respuesta háptica y permitir que el host configure la respuesta háptica en el dispositivo de controlador radial de Windows. Si un dispositivo decide exponer una recopilación de respuestas hápticas, algunos usos son obligatorios para permitir que se admita la configuración automática de respuesta háptica.
| Miembro | Descripción | Página | ID | Obligatorio/Opcional |
|---|---|---|---|---|
| Lista de formas de onda | Lista ordenada de formas de onda hápticas admitidas por el dispositivo | 0x0E | 0x10 | Mandatory |
| Lista de duración | Lista ordenada de duraciones para las formas de onda en la lista de formas de onda | 0x0E | 0x11 | Mandatory |
| Desencadenador automático | Forma de onda que se activa automáticamente a discreción del dispositivo | 0x0E | 0x20 | Mandatory |
| Control asociado del desencadenador automático | Uso de HID del control asociado a realimentación háptica | 0x0E | 0x22 | Mandatory |
| Intensidad | Salida: intensidad de la forma de onda del desencadenador manual en porcentaje | 0x0E | 0x23 | Opcionales |
| Número de repeticiones | Salida: número de veces que se reproduce la forma de onda del desencadenador manual después de la reproducción inicial | 0x0E | 0x24 | Opcionales |
| Período de reintentos de desencadenamiento | Salida: duración del tiempo de espera antes de volver a desencadenar el desencadenador manual al repetir | 0x0E | 0x25 | Opcionales |
| Tiempo de corte de forma de onda | Tiempo máximo que una forma de onda de desencadenador manual puede reproducirse antes de cortarse | 0x0E | 0x28 | Opcionales |
Lista de formas de onda
El uso de la lista de formas de onda muestra una colección de los usos HID de las formas de onda admitidas, ordenadas con ordinales. Las formas de onda de hápticas predefinidas se definen en la especificación HID. Windows admite la implementación de las siguientes formas de onda para un dispositivo habilitado para respuesta háptica:
| Forma de onda | Descripción | Página | ID | Obligatorio/Opcional |
|---|---|---|---|---|
| WAVEFORM_NONE | No operativo. No debería afectar al estado de reproducción de las formas de onda en curso. | 0x0E | 0x1001 | Mandatory |
| WAVEFORM_STOP | Detiene la reproducción de formas de onda en curso. | 0x0E | 0x1002 | Mandatory |
| WAVEFORM_CLICK | Crea una breve respuesta de "clic" | 0x0E | 0x1003 | Mandatory |
| WAVEFORM_BUZZ_CONTINUOUS | Hace que el dispositivo zumbe durante un largo período de tiempo | 0x0E | 0x1004 | Opcionales |
Tanto WAVEFORM_NONE como WAVEFORM_STOP son necesarias para todos los dispositivos hápticos compatibles con HID. Los ordinales 1 y 2 se establecen implícitamente en WAVEFORM_NONE y WAVEFORM_STOP. No es necesario declararlos en la lista de formas de onda o en la lista de duración. La lista de formas de onda declara las formas de onda admitidas por el mínimo y el máximo físico de cada ordinal de la lista.
Lista de duración
El uso de la lista de duración muestra una recopilación de las duraciones de las formas de onda admitidas en la lista de forma de onda, ordenadas con ordinales. El milisegundo es la unidad para la duración de la forma de onda y esta debe ser un valor positivo distinto de cero para cualquier forma de onda no continua. Si una forma de onda es continua (se reproducirá hasta que el host la detenga o se supere el tiempo límite de forma de onda), su duración se define como cero.
Se presupone que WAVEFORM_NONE y WAVEFORM_STOP tienen una duración de cero. No es necesario declararlos en la lista de duración.
Desencadenador automático
El uso del desencadenador automático representa un uso de una forma de onda admitido de la lista de formas de onda que el dispositivo desencadenará automáticamente según sea necesario, en función de las interacciones del usuario. Esto permite una respuesta de menor latencia a interacciones comunes del usuario, como la rotación y el clic. Es posible que el host tenga que modificarlo o deshabilitarlo y se puede establecer a través de un informe de características. La forma de onda del desencadenador automático se puede deshabilitar si el host la establece en cero.
Control asociado del desencadenador automático
El control asociado del desencadenador automático especifica el uso extendido de HID del control físico asociado a la respuesta háptica automática en el dispositivo. En el caso de un dispositivo de controlador radial, este control debe definirse como el uso de dial especificado en la misma colección de nivel superior.
Intensidad
El uso de intensidad representa el porcentaje de intensidad máxima que se aplicará a una forma de onda. Este valor debe estar entre 0 y 100 %. El 100 % indica que el dispositivo desencadenará las formas de onda con su máxima potencia, y el 0 % indica que el transductor háptico está deshabilitado.
Si se define en un informe de características, establece la intensidad predeterminada para todas las formas de onda desencadenador automático y desencadenador manual para el dispositivo.
Número de repeticiones
El uso de recuento de repeticiones muestra el número de veces que una forma de onda se repite. Un recuento de repeticiones con valor cero indica que la forma de onda del desencadenador manual solo debe reproducirse una vez (sin repetición). Si se ha superado el tiempo límite de forma de onda, se espera que se omitan las repeticiones incompletas.
Si se define en un informe de características, establece el recuento de repeticiones predeterminado para todas las formas de onda de desencadenador automático y desencadenador manual para el dispositivo.
Período de reintentos de desencadenamiento
El uso del período de reintentos de desencadenamiento muestra la cantidad de tiempo que el dispositivo debe esperar antes de repetir una forma de onda del desencadenador manual en un informe de salida, según el valor especificado por el recuento de repeticiones. El milisegundo es la unidad de este valor. Si el período de reintentos de desencadenamiento es menor que la duración de la forma de onda que se reproduce, la forma de onda debe detenerse y reiniciarse en el período de tiempo indicado por el período de reintento de desencadenamiento.
Si se define en un informe de características, establece el período de reintentos predeterminado para todas las formas de onda de desencadenador automático y desencadenador manual para el dispositivo.
Tiempo de corte de forma de onda
El uso del tiempo de corte de forma de onda muestra el tiempo máximo que el dispositivo permitirá repetir una forma de onda de desencadenador manual antes de finalizar la reproducción. Es un valor constante para el dispositivo e incluye las formas de onda continuas sin duraciones establecidas y las formas de onda con duraciones discretas que se establecen para repetirse muchas veces. El milisegundo es la unidad de este valor.