VRTK控制器事件(VRTK_ControllerEvents)

OVERVIEW

控制器脚本是处理游戏控制器发出的事件的。
控制器脚本是附在[camerarig]预制件上并为控制器上的每个按钮添加了事件侦听器(不包括menu按钮，这个按钮事件不能被重写，只用于steam平台)。
当一个控制器按钮被按下的时候，脚本会发出事件来表示按钮已被按下，这就允许其他任何脚本不需要实现任何关于控制器的逻辑就可以监听这个事件。当按钮被松开的时候，同样也会发出事件来表示按钮已经被松开。

INSPECTOR PARAMETERS

Point Toggle Button:将激光指针打开/关闭的按钮
Point Set Button:从指针的光标位置设置目标标记的操作的按钮
Grab Toggle Button:抓取物体的按钮
Use Toggle Button:使用物体的按钮
UI Click Button:触发UI元素点击事件的按钮
Menu Toggle Button:显示游戏菜单界面的按钮
Axis Fidelity:在轴变化量敏感度,默认值1，任何高于2的值都会导致过于敏感的结果
Triggle Click Threshold:扳机键按下前需要按下的距离水平

CLASS VARIABLES

public enum ButtonAlias - 按钮类型
- Trigger_Hairline - Trigger按钮按下的幅度超过阀值
- Trigger_Touch - Trigger按钮按下一点点
- Trigger_Press - Trigger按钮按下一半多
- Trigger_Click - Trigger按钮点击按下
- Grip - grip按钮被按下
- TouchPad_Touch - 触摸板被触摸
- TouchPad_Press - 触摸板被按下
- Application_Menu - 应用菜单按钮被按下
- undefined
public bool triggerPressed - 如果trigger按钮被按下超过一半则会返回true,默认是false
public bool triggerTouched
public bool triggerHairlinePressed
public bool triggerClicked
public bool triggerAxisChanged
public bool applicationMenuPressed
public bool touchpadPressed
public bool touchpadTouched
public bool touchpadAxisChanged
public bool gripPressed
public bool pointerPressed
public bool grabPressed
public bool usePressed
public bool uiClickPressed
public bool menuPressed

CLASS EVENTS

TriggerPressed
TriggerReleased
TriggerTouchStart
TriggerTouchEnd
TriggerHairlineStart
TriggerHairlineEnd
TriggerClicked
TriggerUnclicked
TriggerAxisChanged
ApplicationMenuPressed
ApplicationMenuReleased
GripPressed
GripReleased
TouchpadPressed
TouchpadReleased
TouchpadTouchStart
TouchpadTouchEnd
TouchpadAxisChanged
AliasPointerOn
AliasPointerOff
AliasPointerSet
AliasGrabOn
AliasGrabOff
AliasUseOn
AliasUseOff
AliasMenuOn
AliasMenuOff
AliasUIClickOn
AliasUIClickOff
ControllerEnabled
ControllerDisabled

UNITY EVENT

给VRTK_ControllerEventsObject添加VRTK_ControllerEvents_UnityEvents组件来允许访问unityevents。

OnTriggerPressed
OnTriggerReleased
OnTriggerTouchStart
OnTriggerTouchEnd
OnTriggerHairlineStart
OnTriggerHairlineEnd
OnTriggerClicked
OnTriggerUnclicked
OnTriggerAxisChanged
OnApplicationMenuPressed
OnApplicationMenuReleased
OnGripPressed
OnGripReleased
OnTouchpadPressed
OnTouchpadReleased
OnTouchpadTouchStart
OnTouchpadTouchEnd
OnTouchpadAxisChanged
OnAliasPointerOn
OnAliasPointerOff
OnAliasPointerSet
OnAliasGrabOn
OnAliasGrabOff
OnAliasUseOn
OnAliasUseOff
OnAliasMenuOn
OnAliasMenuOff
OnAliasUIClickOn
OnAliasUIClickOff
OnControllerEnabled
OnControllerDisabled

EVENT PAYLOAD

uint controllerIndex - 被使用的控制器索引
float buttonPressure - 被施加到按钮上的压力的量。0f到1F。
Vector2 touchpadAxis - 触摸板被触摸的位置，(0,0)到(1,1)。
float touchpadAngle - 触摸板的触摸位置的角度，顶上是0°，地下是180°，以此类推，0°到360°。

CLASS METHODS

GetVelocity()

public Vector3 GetVelocity()

Parameters
- none
Returns
- Vector3 - 一个包含当前现实世界物理控制器速度的3维向量。

这个方法可以获取控制器的在当前现实世界的速度。可以用来确定控制器被晃动的速度和方向。

GetTouchpadAxis()

public Vector2 GetTouchpadAxis()

Parameters
- none
Returns
- Vector2 - 触摸板被触摸的位置信息，从(0,0)到(1,1)。X表示触摸板水平方向，Y表示触摸板垂直方向。

GetTouchpadAxisAngle()

public float GetTouchpadAxisAngle()

Parameters
- none
Returns
- float - 触摸板被触摸角度信息,顶上0°，底下180°，取值0°-360°。

GetTriggerAxis()

public float GetTriggerAxis()

Parameters
none
Returns
float - trigger按钮被按下的程度，取值0f到1f。

GetHairTriggerDelta()

public float GetHairTriggerDelta()

Parameters
none
Returns
float - trigger按钮从初始位置到当前位置的力度变化值

AnyButtonPressed()

public bool AnyButtonPressed()

Parameters
none
Returns
bool - 当有任何按钮被按下的时候返回值为true

IsButtonPressed()

public bool IsButtonPressed(ButtonAlias button)

Parameters
ButtonAlias button - 检查按钮是否被按下
Returns
bool - 如果该按钮被按下的话返回值为true

EXAMPLE

例子: VRTK/Examples/002_Controller_Events ，VRTK/Examples/Resources/Scripts/VRTK_ControllerEvents_ListenerExample.cs