Version: 2023.2
言語: 日本語

Touch

struct in UnityEngine

マニュアルに切り替える

説明

スクリーンに指をタッチしたときの状態を扱う構造体

Devices can track a number of different pieces of data about a touch on a touchscreen, including its phase of the touch lifecycle, its position and whether the touch was a single contact or several taps. Furthermore, the continuity of a touch between frame updates can be detected by the device, so a consistent ID number can be reported across frames and used to determine how a particular finger is moving.

The touch lifecycle describes the state of a touch in any given frame: Began - A user has touched their finger to the screen this frame Stationary - A finger is on the screen but the user has not moved it this frame Moved - A user moved their finger this frame Ended - A user lifted their finger from the screen this frame Cancelled - The touch was interrupted this frame Touch 構造体は Unity によって 1 つのタッチ情報として保存され Input.GetTouch 関数によって取得することができます。新たに GetTouch を呼び出すと毎フレームでデバイスから最新のタッチ情報を取得することができます。また、fingerId プロパティーはフレーム間で同じ指かどうかを判断することに使用できます。

Note: On iOS devices, any Touch information that is being held in memory (for example, when you are part way through the touch lifecycle) will be lost if the application is minimized. This happens because iOS calls ResetTouch() and wipes all touch data from memory. The lifecycle of that touch ends there and any functionality that relies on later phases of the touch lifecycle is not executed. If you experience this problem, you should move the functionality that is not being executed into MonoBehaviour.OnApplicationFocus or MonoBehaviour.OnApplicationPause.

関連項目: Input.GetTouchTouchPhase 構造体

変数

altitudeAngle0 ラジアンはスタイラスが表面に対して並行であることを示し、PI/2 は垂直であることを示します。
azimuthAngle0 ラジアンは、スタイラスがデバイスの x 軸 に沿って方向を指していることを示します。
deltaPositionThe position delta since last change in pixel coordinates.
deltaTimeタッチ情報が最後に記録された時から経過した時間
fingerIdタッチのユニークなインデックス
maximumPossiblePressureプラットフォームで可能な圧力の最大値。Input.touchPressureSupported が false を返す場合、このプロパティーの値は常に 1.0f となります。
phaseタッチのフェーズを設定する
positionThe position of the touch in screen space pixel coordinates.
pressure現在、タッチに適用されている圧力。1.0f は平均的なタッチの圧力と考えられています。Input.touchPressureSupported が false を返す場合は、このプロパティーの値は常に 1.0f となります。
radiusタッチの半径の推定値。最大タッチサイズはこれに radiusVariance を加え、最小タッチサイズはこれから radiusVariance を差し引いて求めます。
radiusVarianceThis value determines the accuracy of the touch radius. Add this value to the radius to get the maximum touch size, subtract it to get the minimum touch size.
rawPositionThe first position of the touch contact in screen space pixel coordinates.
tapCountタップした数を返す
typeタッチが Direct、Indirect (または Remote)、Stylus 型のいずれであるかを示します。