#if (UNITY_INPUT_SYSTEM_ENABLE_XR && ENABLE_VR) || PACKAGE_DOCS_GENERATION
using UnityEngine.InputSystem.Controls;
using UnityEngine.InputSystem.XR.Haptics;
using UnityEngine.InputSystem.Layouts;
using UnityEngine.Scripting;
using UnityEngine.XR;
namespace UnityEngine.InputSystem.XR
{
///
/// The base type of all XR head mounted displays. This can help organize shared behaviour across all HMDs.
///
[InputControlLayout(isGenericTypeOfDevice = true, displayName = "XR HMD")]
[Preserve]
public class XRHMD : TrackedDevice
{
[InputControl(noisy = true)]
[Preserve]
public Vector3Control leftEyePosition { get; private set; }
[InputControl(noisy = true)]
[Preserve]
public QuaternionControl leftEyeRotation { get; private set; }
[InputControl(noisy = true)]
[Preserve]
public Vector3Control rightEyePosition { get; private set; }
[InputControl(noisy = true)]
[Preserve]
public QuaternionControl rightEyeRotation { get; private set; }
[InputControl(noisy = true)]
[Preserve]
public Vector3Control centerEyePosition { get; private set; }
[InputControl(noisy = true)]
[Preserve]
public QuaternionControl centerEyeRotation { get; private set; }
protected override void FinishSetup()
{
base.FinishSetup();
centerEyePosition = GetChildControl("centerEyePosition");
centerEyeRotation = GetChildControl("centerEyeRotation");
leftEyePosition = GetChildControl("leftEyePosition");
leftEyeRotation = GetChildControl("leftEyeRotation");
rightEyePosition = GetChildControl("rightEyePosition");
rightEyeRotation = GetChildControl("rightEyeRotation");
}
}
///
/// The base type for all XR handed controllers.
///
[InputControlLayout(commonUsages = new[] { "LeftHand", "RightHand" }, isGenericTypeOfDevice = true, displayName = "XR Controller")]
[Preserve]
public class XRController : TrackedDevice
{
///
/// A quick accessor for the currently active left handed device.
///
/// If there is no left hand connected, this will be null. This also matches any currently tracked device that contains the 'LeftHand' device usage.
public static XRController leftHand => InputSystem.GetDevice(CommonUsages.LeftHand);
///
/// A quick accessor for the currently active right handed device. This is also tracked via usages on the device.
///
/// If there is no left hand connected, this will be null. This also matches any currently tracked device that contains the 'RightHand' device usage.
public static XRController rightHand => InputSystem.GetDevice(CommonUsages.RightHand);
protected override void FinishSetup()
{
base.FinishSetup();
var capabilities = description.capabilities;
var deviceDescriptor = XRDeviceDescriptor.FromJson(capabilities);
if (deviceDescriptor != null)
{
#if UNITY_2019_3_OR_NEWER
if ((deviceDescriptor.characteristics & InputDeviceCharacteristics.Left) != 0)
InputSystem.SetDeviceUsage(this, CommonUsages.LeftHand);
else if ((deviceDescriptor.characteristics & InputDeviceCharacteristics.Right) != 0)
InputSystem.SetDeviceUsage(this, CommonUsages.RightHand);
#else
if (deviceDescriptor.deviceRole == InputDeviceRole.LeftHanded)
InputSystem.SetDeviceUsage(this, CommonUsages.LeftHand);
else if (deviceDescriptor.deviceRole == InputDeviceRole.RightHanded)
InputSystem.SetDeviceUsage(this, CommonUsages.RightHand);
#endif //UNITY_2019_3_OR_NEWER
}
}
}
///
/// Identifies a controller that is capable of rumble or haptics.
///
[Preserve]
public class XRControllerWithRumble : XRController
{
public void SendImpulse(float amplitude, float duration)
{
var command = SendHapticImpulseCommand.Create(0, amplitude, duration);
ExecuteCommand(ref command);
}
}
}
#endif