Touchpad
プレイヤーがラップトップのタッチパッドと同様に操作できるアナログ コントロール。プロパティ
type - “touchpad”
axis - object または array。このタッチパッド コントロールのマッピングを記述する単一の axis、または axes の配列。
action - object、省略可。軸マッピングに加えて、タッチ時に呼び出される action。
renderAsButton - boolean、省略可。既定値は false です。タッチパッドを視覚的にボタンとしてレンダリングするには true に設定します。
enabled - boolean、省略可。既定値は true です。コントロールの視覚的な状態を有効/無効に設定します。無効なコントロールは引き続きプレイヤーからの入力を受け取りますが、入力に基づいて視覚スタイルは変更されません。
visible - boolean、省略可。既定値は true です。プレイヤーが操作できるようにコントロールを表示するかどうかを決定します。ゲーム プレイ中に変更するには、ゲーム状態を使用したタッチ レイアウトの変更 を参照してください。
styles - object、省略可。コントロールの視覚的表現のカスタマイズ。スタイルは、スタイル設定可能な状態ごとのオブジェクトとして表されます。
button コントロールは次の状態のスタイルを設定できます:
default- 基本スタイル。disabled- コントロールが無効な場合のスタイル。指定されていない場合、コントロールが無効になると、既定のスタイルに変換が適用されて無効に見えるようになります。idle- プレイヤーがコントロールを操作していないときに適用されます。moving- プレイヤーがコントロールに触れており、actionが定義されていないときに適用されます。activated- プレイヤーがコントロールに触れており、actionが定義されているときに適用されます。
opacity - number、省略可。コントロールに適用される不透明度。disabled を除くすべての状態で既定値は 1.0 です。
background - object、省略可。color または image asset のいずれかを指定できます。
faceImage - object、省略可。icon または image asset のいずれかを指定できます。
アセットの寸法
画像アセットを受け入れる各スタイル オブジェクトについて、指定されたアセットはベース解像度と、そのベース解像度の 1.5x、2.0x、3.0x、4.0x のスケールで提供されます。指定された画像の解像度は、次の最大解像度以下である必要があります:
補足
touchpad は、非スティッキーで deadzone のない出力に最適です。通常は、一人称/三人称視点のゲームにおける視点カメラに使用されます。
マウス入力をサポートするゲームでは、touchpad を相対マウスと共に使用して、より調整された視点カメラ体験を提供できます。
スタイル設定に関する補足
renderAsButton が true の場合:
activated状態のとき、faceImageは 25% 小さく表示されます。- カスタム アセットを使用せず、
gamepadX、gamepadY、gamepadA、またはgamepadBの単一アクションを持つボタンには、ラベルおよび背景色の既定のスタイルがあります。
サンプル
例 1: 視点アイコンを持つタッチパッド
図 1. タッチパッド コントロール
例 2: ボタンとしてレンダリングされる視点アイコンを持つタッチパッド
図 1. ボタン タッチパッド コントロール