次の方法で共有


タッチパッド

プレーヤーがノート 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 を相対マウスと共に使用して、より調整された外観のカメラ エクスペリエンスを提供できます。

スタイルに関するコメント

renderAsButtontrueの場合:

  • activated の状態の場合、faceImage は 25% 小さく表示されます。
  • カスタム資産を使用せず、gamepadXgamepadYgamepadA、または 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 以降から使用できるスタイル設定)