Entrada para controladores OpenVR

Para que el Editor de Unity admita controladores con seguimiento OpenVR, el subsistema Unity VR presenta las entradas del controlador VR como joysticks independientes. Utilice la clase UnityEngine.Input para acceder a los valores de los ejes y botones.

La integración de Unity de OpenVR no se refiere a ningún hardware específico cuando se presentan los estados de los ejes y botones. Esta página proporciona las asignaciones de ejes y botones para los tres tipos de controladores compatibles con OpenVR: HTC Vive, Oculus Touch y Valve Knuckles Controllers.

Denominación de convención y detección

Cuando se configuran y conectan correctamente, todos los controladores compatibles con OpenVR se denominan internamente como OpenVR Controller - Left o OpenVR Controller - Right. Acceda a este nombre a través de la lista devuelta por UnityEngine.Input.GetJoystickNames(). Cuando están disponibles, estos controladores aparecen resaltados en verde en el menú de estado de SteamVR cuando se prueban con Steam. Para acceder a este menú, debe tener Steam y SteamVR instalados y ejecutándose en su máquina.

Puede probar la disponibilidad de estos controladores comprobando periódicamente su presencia en la lista de nombres de joystick mediante script. Cuando los controladores se apagan o cuando se quitan las baterías, un string vacío reemplaza su nombre en la lista devuelta porUnityEngine.Input.GetJoystickNames(). Cuando los controladores se vuelven a encender, su nombre vuelve a aparecer en la lista de joysticks devueltos.

Mapeos del sistema de entrada de Unity

Esta sección proporciona diagramas para cada tipo de controlador admitido por dispositivos OpenVR, junto con información sobre la asignación de entrada de Unity interna para cada botón del controlador.

Controladores HTC Vive

El siguiente diagrama muestra las diferentes entradas disponibles en los controladores HTC Vive para su uso en aplicaciones de realidad virtual.

Controladores táctiles Oculus

El siguiente diagrama muestra las diferentes entradas disponibles en los controladores Oculus Touch para su uso en aplicaciones de realidad virtual.

Controladores de knuckles (nudillos)

El siguiente diagrama muestra las diferentes entradas disponibles cuando se usan controladores Knuckles en aplicaciones de realidad virtual.

La siguiente tabla enumera las entradas del controlador para cada controlador compatible con OpenVR, sus tipos de interacción, el eje de Unity y los ID de los botones, junto con el rango de valores para cada eje.

Nota: Las funciones de hardware que no se enumeran en la tabla anterior no se exponen a través de la API de OpenVR y, por lo tanto, no se exponen a través del sistema de entrada de Unity.

Diferencias del controlador importantes

Al desarrollar aplicaciones para admitir dispositivos OpenVR, es importante tener en cuenta ciertas diferencias en los desencadenantes de eventos de entrada y las tasas de respuesta para los botones en los tres controladores.

Los eventos de entrada Unity Touch difieren para cada controlador de plataforma:

• El Event System genera eventos Input Touch para los gatillos en los controladores HTC Vive cuando el usuario comienza a apretar el gatillo.
• The Event System generates Input Touch events for the triggers on Oculus Touch and Valve Knuckles controllers when Unity Input detects a touch - no trigger squeeze is necessary.

El gatillo de agarre difiere entre las plataformas:

• Los controladores HTC Vive tienen dos botones de agarre, pero ambos se asignan al mismo eje. El valor de estos botones es 0.0 cuando no se presiona y 1.0 cuando se presiona (los valores intermedios entre 0.0 y 1.0 no son posibles).

• El agarre en el Controlador Touch de Oculus es un disparador analógico con un rango de 0.0 a 1.0 (valores intermedios son posibles).

• El agarre en el controlador Valve Knuckles es un promedio ponderado de los valores de entrada para cada uno de los sensores táctiles individuales.