Informes de salida del controlador radial de Windows
En este tema se detallan los informes de salida 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 comentarios hápticos, puede permitir que el sistema y las aplicaciones aprovechen sus ventajas mediante la inclusión de una recopilación de comentarios hápticos (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 comentarios hápticos, consulte la ratificación de la página Haptics a la especificación HID.
El host usa los siguientes usos en un informe de salida (a través de la recopilación de comentarios hápticos) para permitir que el host emita eventos de comentarios hápticos en el dispositivo controlador radial de Windows. Si un dispositivo decide exponer una recopilación de realimentación háptica, algunos usos son obligatorios para permitir que se admita la información háptica iniciada por el host.
| Miembro | Descripción | Página | ID | Obligatorio/Opcional |
|---|---|---|---|---|
| Desencadenador manual | Forma de onda que se activará como comando explícito desde el host. | 0x0E | 0x21 | 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 |
Desencadenador manual
El uso del desencadenador manual representa un uso de forma de onda admitido de la lista de formas de onda que el host ha solicitado que lo reproduzca. Cuando se envía un informe de salida que contiene un desencadenador manual distinto a WAVEFORM_NONE al dispositivo, debería empezar a reproducir inmediatamente la forma de onda especificada con las propiedades adicionales incluidas en el informe de salida (intensidad, recuento de repeticiones y período de reintento de desencadenamiento). Cuando un informe de salida contiene un desencadenador manual de WAVEFORM_STOP, se debe detener cualquier reproducción de forma de onda en curso.
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 fuerza y el 0 % indica que el transductor háptico está deshabilitado.
Cuando se establece en un informe de salida, este valor invalidará la intensidad predeterminada para la forma de onda desencadenador manual definida en el mismo informe de salida. Esto no establece una intensidad predeterminada nueva.
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 la forma de onda, se espera que se omitan las repeticiones incompletas.
Cuando se establece en un informe de salida, este valor invalida el recuento de repeticiones predeterminado para la forma de onda desencadenador manual definida en el mismo informe de salida. Esto no establece un nuevo recuento de repeticiones predeterminado.
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.
Cuando se establece en un informe de salida, invalida el período de reintensión predeterminado para la forma de onda desencadenador manual definida en el mismo informe de salida. Esto no establece un nuevo período de retrigger predeterminado.