Touch
简介
用于描述触摸屏幕的手指状态的数据结构。
设备可以跟踪很多关于触摸屏上的触摸操作的不同数据段,包括(触摸是刚开始、已结束还是移动)、其位置以及触摸是一次接触还是多次点击。此外,设备还可以检查帧更新之间的触摸的连续性,因此可以跨帧报告一致的 触摸ID 号并用它来确定特定手指的移动方式。
系统使用 Touch 数据结构存储与单次接触相关的数据,此数据结构由 UserInputService
的GetTouch
函数返回。每次帧更新都需要刷新 GetTouch调用,以便从设备获取最新触摸信息,但可以使用 fingerId属性标识帧之间的相同触摸操作。
属性
触摸的高度角 float altitudeAngle
0 弧度值指示触笔平行于表面,pi/2 指示垂直。
触摸的方向角 float azimuthAngle
0 弧度值指示触笔指向沿着设备 X 轴方向。
位置变化量 Vector2 deltaPosition
自上次更改以来的位置增量。
时间变化量 float deltaTime
自记录的 Touch 值上次更改以来经过的时间。
触摸点ID int fingerId
触摸的唯一索引。
最大检测压力 float maximumPossiblePressure
平台的最大可能压力值。如果 Input.touchPressureSupported 返回 false,此属性的值将始终为 1.0f。
触摸状态 Enum.TouhchPhase phase
描述触摸阶段。
触摸点坐标 Vector2 position
触摸的位置(像素坐标)。
触摸压力 float pressure
当前应用于触摸的压力大小。1.0f 被视为平均触摸压力。如果 Input.touchPressureSupported 返回 false,此属性的值将始终为 1.0f。
触摸点半径 float radius
触摸半径的估计值。加上 radiusVariance 可获得最大触摸大小,减去它可获得最小触摸大小。
触摸点浮动量 float radiusVariance
此值确定触摸半径的精度。半径加上此值可获得最大触摸大小,减去它可获得最小触摸大小。
原触摸点位置 Vector2 rawPosition
用于触摸的原始位置。
轻击次数 int tapCount
点击次数。
触摸类型 Enum.TouchType type
用于指示触摸是 Direct、Indirect(或远程)还是 Stylus 类型的值。