Controladores de HP Reverb G2 en Unity
Los controladores hp Motion son un nuevo tipo de controladores de Windows Mixed Reality: toda la misma tecnología de seguimiento con un conjunto ligeramente diferente de entradas disponibles:
- El panel táctil se ha reemplazado por dos botones: A y B para el controlador derecho, y X e Y para el controlador izquierdo.
- La comprensión es ahora un desencadenador que publica una secuencia de valores entre 0,0 y 1,0 en lugar de un botón con estados Presionado y Sin presionar.
Puesto que las nuevas entradas no son accesibles a través de las API de Windows y Unity existentes, necesita el paquete UPM dedicado Microsoft.MixedReality.Input .
Importante
Las clases de este paquete no reemplazan las API de Windows y Unity existentes, sino que las complementan. Las características disponibles habitualmente para los controladores de Windows Mixed Reality clásicos y los controladores de movimiento de HP son accesibles a través de la misma ruta de acceso de código mediante las API existentes. Solo las nuevas entradas requieren el uso del paquete Microsoft.MixedReality.Input adicional.
Introducción a HP Motion Controller
Microsoft.MixedReality.Input.MotionController representa un controlador de movimiento. Cada instancia de MotionController tiene una XR. WSA. Input.InteractionSource del mismo nivel, que se puede correlacionar mediante la entrega, el identificador del proveedor, el identificador de producto y la versión.
Puede obtener instancias de MotionController mediante la creación de un MotionControllerWatcher y la suscripción a sus eventos, de forma similar al uso de eventos InteractionManager para detectar nuevas instancias de InteractionSource . Los métodos y propiedades de MotionController describen las entradas admitidas por el controlador, incluidos sus botones, desencadenadores, eje 2D y stick analógico. La clase MotionController también expone métodos para acceder a los estados de entrada a través de la clase MotionControllerReading . La clase MotionControllerReading representa una instantánea del estado del controlador en un momento dado.
Instalación de Microsoft.MixedReality.Input con la herramienta de características de Mixed Reality
Instale el complemento Microsoft.MixedReality.Input con la nueva aplicación Mixed Reality Feature Tool. Siga las instrucciones de instalación y uso y seleccione el paquete de entrada Mixed Reality en la categoría Mixed Reality Toolkit:
Uso de Microsoft.MixedReality.Input
Valores de entrada
Un MotionController puede exponer dos tipos de entradas:
- Los botones y los estados del desencadenador se expresan mediante un valor flotante único entre 0,0 y 1,0 que indica cuánto se presionan.
- Un botón solo puede devolver 0,0 (cuando no se presiona) o 1,0 (cuando se presiona) mientras que un desencadenador puede devolver valores continuos entre 0,0 (totalmente liberado) a 1,0 (totalmente presionado).
- El estado del stick analógico se expresa mediante un vector2 cuyos componentes X e Y están comprendidos entre -1.0 y 1.0.
Puede usar MotionController.GetPressableInputs() para devolver una lista de entradas que devuelven un valor presionado (botones y desencadenadores) o el método MotionController.GetXYInputs() para devolver una lista de entradas que devuelven un valor de 2 ejes.
Una instancia de MotionControllerReading representa el estado del controlador en un momento dado:
- GetPressedValue() recupera el estado de un botón o un desencadenador.
- GetXYValue() recupera el estado de un stick digital.
Creación de una memoria caché para mantener una colección de instancias de MotionController y sus estados
Para empezar, cree una instancia de MotionControllerWatcher y registre controladores para sus eventos MotionControllerAdded y MotionControllerRemoved para mantener una memoria caché de las instancias disponibles de MotionController. Esta memoria caché debe ser un MonoBehavior asociado a un GameObject, como se muestra en el código siguiente:
public class MotionControllerStateCache : MonoBehaviour
{
/// <summary>
/// Internal helper class which associates a Motion Controller
/// and its known state
/// </summary>
private class MotionControllerState
{
/// <summary>
/// Construction
/// </summary>
/// <param name="mc">motion controller</param>`
public MotionControllerState(MotionController mc)
{
this.MotionController = mc;
}
/// <summary>
/// Motion Controller that the state represents
/// </summary>
public MotionController MotionController { get; private set; }
…
}
private MotionControllerWatcher _watcher;
private Dictionary<Handedness, MotionControllerState>
_controllers = new Dictionary<Handedness, MotionControllerState>();
/// <summary>
/// Starts monitoring controller's connections and disconnections
/// </summary>
public void Start()
{
_watcher = new MotionControllerWatcher();
_watcher.MotionControllerAdded += _watcher_MotionControllerAdded;
_watcher.MotionControllerRemoved += _watcher_MotionControllerRemoved;
var nowait = _watcher.StartAsync();
}
/// <summary>
/// Stops monitoring controller's connections and disconnections
/// </summary>
public void Stop()
{
if (_watcher != null)
{
_watcher.MotionControllerAdded -= _watcher_MotionControllerAdded;
_watcher.MotionControllerRemoved -= _watcher_MotionControllerRemoved;
_watcher.Stop();
}
}
/// <summary>
/// called when a motion controller has been removed from the system:
/// Remove a motion controller from the cache
/// </summary>
/// <param name="sender">motion controller watcher</param>
/// <param name="e">motion controller </param>
private void _watcher_MotionControllerRemoved(object sender, MotionController e)
{
lock (_controllers)
{
_controllers.Remove(e.Handedness);
}
}
/// <summary>
/// called when a motion controller has been added to the system:
/// Remove a motion controller from the cache
/// </summary>
/// <param name="sender">motion controller watcher</param>
/// <param name="e">motion controller </param>
private void _watcher_MotionControllerAdded(object sender, MotionController e)
{
lock (_controllers)
{
_controllers[e.Handedness] = new MotionControllerState(e);
}
}
}
Lectura de nuevas entradas mediante sondeo
Puede leer el estado actual de cada controlador conocido a través de MotionController.TryGetReadingAtTime durante el método Update de la clase MonoBehavior. Quiere pasar DateTime.Now como parámetro de marca de tiempo para asegurarse de que se lee el estado más reciente del controlador.
public class MotionControllerStateCache : MonoBehaviour
{
…
private class MotionControllerState
{
…
/// <summary>
/// Update the current state of the motion controller
/// </summary>
/// <param name="when">time of the reading</param>
public void Update(DateTime when)
{
this.CurrentReading = this.MotionController.TryGetReadingAtTime(when);
}
/// <summary>
/// Last reading from the controller
/// </summary>
public MotionControllerReading CurrentReading { get; private set; }
}
/// <summary>
/// Updates the input states of the known motion controllers
/// </summary>
public void Update()
{
var now = DateTime.Now;
lock (_controllers)
{
foreach (var controller in _controllers)
{
controller.Value.Update(now);
}
}
}
}
Puede obtener el valor de entrada actual de los controladores mediante el valor De entrega del controlador:
public class MotionControllerStateCache : MonoBehaviour
{
…
/// <summary>
/// Returns the current value of a controller input such as button or trigger
/// </summary>
/// <param name="handedness">Handedness of the controller</param>
/// <param name="input">Button or Trigger to query</param>
/// <returns>float value between 0.0 (not pressed) and 1.0
/// (fully pressed)</returns>
public float GetValue(Handedness handedness, ControllerInput input)
{
MotionControllerReading currentReading = null;
lock (_controllers)
{
if (_controllers.TryGetValue(handedness, out MotionControllerState mc))
{
currentReading = mc.CurrentReading;
}
}
return (currentReading == null) ? 0.0f : currentReading.GetPressedValue(input);
}
/// <summary>
/// Returns the current value of a controller input such as button or trigger
/// </summary>
/// <param name="handedness">Handedness of the controller</param>
/// <param name="input">Button or Trigger to query</param>
/// <returns>float value between 0.0 (not pressed) and 1.0
/// (fully pressed)</returns>
public float GetValue(UnityEngine.XR.WSA.Input.InteractionSourceHandedness handedness, ControllerInput input)
{
return GetValue(Convert(handedness), input);
}
/// <summary>
/// Returns a boolean indicating whether a controller input such as button or trigger is pressed
/// </summary>
/// <param name="handedness">Handedness of the controller</param>
/// <param name="input">Button or Trigger to query</param>
/// <returns>true if pressed, false if not pressed</returns>
public bool IsPressed(Handedness handedness, ControllerInput input)
{
return GetValue(handedness, input) >= PressedThreshold;
}
}
Por ejemplo, para leer el valor de comprensión analógica de interactionSource:
/// Read the analog grasp value of all connected interaction sources
void Update()
{
…
var stateCache = gameObject.GetComponent<MotionControllerStateCache>();
foreach (var sourceState in InteractionManager.GetCurrentReading())
{
float graspValue = stateCache.GetValue(sourceState.source.handedness,
Microsoft.MixedReality.Input.ControllerInput.Grasp);
…
}
}
Generación de eventos a partir de las nuevas entradas
En lugar de sondear el estado de un controlador una vez por fotograma, tiene la opción de controlar todos los cambios de estado como eventos, lo que permite controlar incluso las acciones más rápidas que duran menos que un fotograma. Para que este enfoque funcione, la memoria caché de los controladores de movimiento debe procesar todos los estados publicados por un controlador desde el último fotograma, que puede hacer almacenando la marca de tiempo del último MotionControllerReading recuperado de un MotionController y llamando a MotionController.TryGetReadingAfterTime():
private class MotionControllerState
{
…
/// <summary>
/// Returns an array representng buttons which are pressed
/// </summary>
/// <param name="reading">motion controller reading</param>
/// <returns>array of booleans</returns>
private bool[] GetPressed(MotionControllerReading reading)
{
if (reading == null)
{
return null;
}
else
{
bool[] ret = new bool[this.pressableInputs.Length];
for (int i = 0; i < pressableInputs.Length; ++i)
{
ret[i] = reading.GetPressedValue(pressableInputs[i]) >= PressedThreshold;
}
return ret;
}
}
/// <summary>
/// Get the next available state of the motion controller
/// </summary>
/// <param name="lastReading">previous reading</param>
/// <param name="newReading">new reading</param>
/// <returns>true is a new reading was available</returns>
private bool GetNextReading(MotionControllerReading lastReading, out MotionControllerReading newReading)
{
if (lastReading == null)
{
// Get the first state published by the controller
newReading = this.MotionController.TryGetReadingAfterSystemRelativeTime(TimeSpan.FromSeconds(0.0));
}
else
{
// Get the next state published by the controller
newReading = this.MotionController.TryGetReadingAfterTime(lastReading.InputTime);
}
return newReading != null;
}
/// <summary>
/// Processes all the new states published by the controller since the last call
/// </summary>
public IEnumerable<MotionControllerEventArgs> GetNextEvents()
{
MotionControllerReading lastReading = this.CurrentReading;
bool[] lastPressed = GetPressed(lastReading);
MotionControllerReading newReading;
bool[] newPressed;
while (GetNextReading(lastReading, out newReading))
{
newPressed = GetPressed(newReading);
// If we have two readings, compare and generate events
if (lastPressed != null)
{
for (int i = 0; i < pressableInputs.Length; ++i)
{
if (newPressed[i] != lastPressed[i])
{
yield return new MotionControllerEventArgs(this.MotionController.Handedness, newPressed[i], this.pressableInputs[i], newReading.InputTime);
}
}
}
lastPressed = newPressed;
lastReading = newReading;
}
// No more reading
this.CurrentReading = lastReading;
}
}
Ahora que ha actualizado las clases internas de caché, la clase MonoBehavior puede exponer dos eventos ( Presionado y Liberado) y generarlos desde su método Update():
/// <summary>
/// Event argument class for InputPressed and InputReleased events
/// </summary>
public class MotionControllerEventArgs : EventArgs
{
public MotionControllerEventArgs(Handedness handedness, bool isPressed, rollerInput input, DateTime inputTime)
{
this.Handedness = handedness;
this.Input = input;
this.InputTime = inputTime;
this.IsPressed = isPressed;
}
/// <summary>
/// Handedness of the controller raising the event
/// </summary>
public Handedness Handedness { get; private set; }
/// <summary>
/// Button pressed or released
/// </summary>
public ControllerInput Input { get; private set; }
/// <summary>
/// Time of the event
/// </summary>
public DateTime InputTime { get; private set; }
/// <summary>
/// true if button is pressed, false otherwise
/// </summary>
public bool IsPressed { get; private set; }
}
/// <summary>
/// Event raised when a button is pressed
/// </summary>
public event EventHandler<MotionControllerEventArgs> InputPressed;
/// <summary>
/// Event raised when a button is released
/// </summary>
public event EventHandler<MotionControllerEventArgs> InputReleased;
/// <summary>
/// Updates the input states of the known motion controllers
/// </summary>
public void Update()
{
// If some event handler has been registered, we need to process all states
// since the last update, to avoid missing a quick press / release
if ((InputPressed != null) || (InputReleased != null))
{
List<MotionControllerEventArgs> events = new <MotionControllerEventArgs>();
lock (_controllers)
{
foreach (var controller in _controllers)
{
events.AddRange(controller.Value.GetNextEvents());
}
}
// Sort the events by time
events.Sort((e1, e2) => DateTime.Compare(e1.InputTime, e2.InputTime));
foreach (MotionControllerEventArgs evt in events)
{
if (evt.IsPressed && (InputPressed != null))
{
InputPressed(this, evt);
}
else if (!evt.IsPressed && (InputReleased != null))
{
InputReleased(this, evt);
}
}
}
else
{
// As we do not predict button presses and the timestamp of the next e is in the future
// DateTime.Now is correct in this context as it will return the latest e of controllers
// which is the best we have at the moment for the frame.
var now = DateTime.Now;
lock (_controllers)
{
foreach (var controller in _controllers)
{
controller.Value.Update(now);
}
}
}
}
La estructura de los ejemplos de código anteriores hace que el registro de eventos sea mucho más legible:
public InteractionSourceHandedness handedness;
public Microsoft.MixedReality.Input.ControllerInput redButton;
// Start of the Mono Behavior: register handlers for events from cache
void Start()
{
var stateCache = gameObject.GetComponent<MotionControllerStateCache>();
stateCache.InputPressed += stateCache_InputPressed;
stateCache.InputReleased += stateCache_InputReleased;
…
}
// Called when a button is released
private void stateCache_InputReleased(object sender, MotionControllerStateCache.MotionControllerEventArgs e)
{
if ((e.SourceHandedness == handedness) && (e.Input == redButton))
{
…
}
}
// Called when a button is pressed
private void stateCache_InputPressed(object sender, MotionControllerStateCache.MotionControllerEventArgs e)
{
if ((e.SourceHandedness == handedness) && (e.Input == redButton))
{
…
}
}