タッチパッド
プレーヤーがノート PC のタッチパッドと同様に操作できるようにするアナログ コントロール。
プロパティ
type
- "touchpad"
axis
-
オブジェクト または 配列。 このタッチパッド コントロールのマッピングを記述する単一の軸または軸の配列を指定します。
action
-
オブジェクト、省略可能。 軸のマッピングに加えてタッチで呼び出すアクションを指定します。
renderAsButton
-
ブール値、省略可能。 既定値は false
です。 タッチパッドをボタンとして視覚的にレンダリングするには、 true
に設定します。
enabled
-
ブール値、省略可能。 既定値は true
です。 コントロールの表示状態を有効/無効に設定します。 無効なコントロールはプレイヤーからの入力を受け取りますが、入力に基づいてビジュアル スタイルが変更されることはありません。
visible
-
ブール値、省略可能。 既定値は true
です。 操作するコントロールをプレイヤーに表示するかどうかを決定します。 ゲーム プレイ中に変更するには 「ゲームの状態を使用してタッチ レイアウトを変更する」を参照してください。
styles
-
オブジェクト、省略可能。 コントロールの視覚的表現のカスタマイズ。 スタイルは、スタイルを設定できる状態ごとのオブジェクトとして表示されます。
ボタン コントロールでは、次の状態のスタイルを設定できます。
-
default
- 基本スタイル。 -
disabled
- コントロールが無効になっている場合のスタイル。 指定されていない場合は、コントロールが無効になると、既定のスタイルに変換が適用され、無効として表示されます。 -
idle
- プレイヤーがコントロールを使用していないときに適用されます。 -
moving
- プレイヤーがコントロールにタッチしていて、action
が定義されていない場合に適用されます。 -
activated
- プレイヤーがコントロールにタッチしていて、action
が定義されている場合に適用されます。
状態ごとのスタイル プロパティ
opacity
-
数値、省略可能。 コントロールに適用する不透明度。
disabled
を除くすべての状態の既定値は 1.0 です。
background
-
オブジェクト、省略可能。
色または画像資産を指定できます。
faceImage
-
オブジェクト、省略可能。
アイコンまたは画像資産を指定できます。
アセットの寸法
画像資産を受け入れるスタイル オブジェクトごとに、特定の資産が基本解像度で、またその基本解像度の 1.5x、2.0x、3.0x、4.0x のスケールで提供されます。 特定の画像の解像度は、次の最大解像度以下である必要があります。
Object | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x |
---|---|---|---|---|---|
faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
背景 (renderAsButton = true) | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
背景 (renderAsButton = false) | 120x120 | 90x90 | 240x240 | 360x360 | 480x480 |
解説
touchpad
は非固定型でデッドゾーンのない出力に適しています。典型的な例として、一人称視点ゲームや三人称視点ゲームの視点カメラがあります。
マウス入力をサポートするゲームでは、 touchpad
を相対マウスと共に使用して、より調整された外観のカメラ エクスペリエンスを提供できます。
スタイルに関するコメント
renderAsButton
がtrue
の場合:
-
activated
の状態の場合、faceImage
は 25% 小さく表示されます。 - カスタム資産を使用せず、
gamepadX
、gamepadY
、gamepadA
、またはgamepadB
のうちの 1 つのアクションを持つボタンの背景色には、ラベルと既定のスタイルがあります。
サンプル
例 1: 外観アイコンを持つタッチパッド
図 1。 タッチパッド コントロール
{
"type": "touchpad",
"axis": {
"input": "axisXY",
"output": "rightJoystick",
"sensitivity": 3
},
"styles": {
"default" : {
"faceImage" : {
"type": "icon",
"value": "look"
}
}
}
}
例 2: ボタンとしてレンダリングされる外観アイコンを持つタッチパッド
図 1。 ボタン タッチパッド コントロール
{
"type": "touchpad",
"renderAsButton": true,
"axis": {
"input": "axisXY",
"output": "rightJoystick",
"sensitivity": 3
},
"styles": {
"default" : {
"faceImage" : {
"type": "icon",
"value": "look"
}
}
}
}
要件
レイアウト バージョン: 1.0 以降 (レイアウト バージョン 3.0 以降から使用できるスタイル設定)