> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Touchpad

> Touchpad

# Touchpad

プレイヤーがラップトップのタッチパッドと同様に操作できるアナログ コントロール。

## プロパティ

`type` - "touchpad"

`axis` - *object* または *array*。このタッチパッド コントロールのマッピングを記述する単一の [axis](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-axis)、または [axes](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-axis) の配列。

`action` - *object*、*省略可*。軸マッピングに加えて、タッチ時に呼び出される [action](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-action)。

`renderAsButton` - *boolean*、*省略可*。既定値は `false` です。タッチパッドを視覚的にボタンとしてレンダリングするには `true` に設定します。

`enabled` - *boolean*、*省略可*。既定値は `true` です。コントロールの視覚的な状態を有効/無効に設定します。無効なコントロールは引き続きプレイヤーからの入力を受け取りますが、入力に基づいて視覚スタイルは変更されません。

`visible` - *boolean*、*省略可*。既定値は `true` です。プレイヤーが操作できるようにコントロールを表示するかどうかを決定します。ゲーム プレイ中に変更するには、[ゲーム状態を使用したタッチ レイアウトの変更](/ja-jp/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-touch-changing-layouts-game-state#change_state) を参照してください。

`styles` - *object*、*省略可*。コントロールの視覚的表現のカスタマイズ。スタイルは、スタイル設定可能な状態ごとのオブジェクトとして表されます。

button コントロールは次の状態のスタイルを設定できます:

* `default` - 基本スタイル。
* `disabled` - コントロールが無効な場合のスタイル。指定されていない場合、コントロールが無効になると、既定のスタイルに変換が適用されて無効に見えるようになります。
* `idle` - プレイヤーがコントロールを操作していないときに適用されます。
* `moving` - プレイヤーがコントロールに触れており、`action` が定義されていないときに適用されます。
* `activated` - プレイヤーがコントロールに触れており、`action` が定義されているときに適用されます。

**状態ごとのスタイル設定プロパティ**

`opacity` - *number*、*省略可*。コントロールに適用される不透明度。`disabled` を除くすべての状態で既定値は 1.0 です。

`background` - *object*、*省略可*。[color](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-color) または [image asset](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-asset) のいずれかを指定できます。

`faceImage` - *object*、*省略可*。[icon](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-icon) または [image asset](/ja-jp/reference/system/touchadaptationkit/types/game-streaming-touch-asset) のいずれかを指定できます。

**アセットの寸法**

画像アセットを受け入れる各スタイル オブジェクトについて、指定されたアセットはベース解像度と、そのベース解像度の 1.5x、2.0x、3.0x、4.0x のスケールで提供されます。指定された画像の解像度は、次の最大解像度以下である必要があります:

| オブジェクト | @1.0x | @1.5x | @2.0x | @3.0x | @4.0x |
| :- | :- | :- | :- | :- | :- |
| faceImage | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = true) | 60x60 | 90x90 | 120x120 | 180x180 | 240x240 |
| background (renderAsButton = false) | 120x120 | 90x90 | 240x240 | 360x360 | 480x480 |

## 補足

`touchpad` は、非スティッキーで deadzone のない出力に最適です。通常は、一人称/三人称視点のゲームにおける視点カメラに使用されます。

マウス入力をサポートするゲームでは、`touchpad` を相対マウスと共に使用して、より調整された視点カメラ体験を提供できます。

**スタイル設定に関する補足**

`renderAsButton` が `true` の場合:

* `activated` 状態のとき、`faceImage` は 25% 小さく表示されます。
* カスタム アセットを使用せず、`gamepadX`、`gamepadY`、`gamepadA`、または `gamepadB` の単一アクションを持つボタンには、ラベルおよび背景色の既定のスタイルがあります。

## サンプル

#### 例 1: 視点アイコンを持つタッチパッド

**図 1. タッチパッド コントロール**

![タッチパッドを操作するユーザー](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad.gif?s=964c6d216b29d4d0f46f3bf0c9ae96e2)

```JSON theme={null}
{
    "type": "touchpad",
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}
```

#### 例 2: ボタンとしてレンダリングされる視点アイコンを持つタッチパッド

**図 1. ボタン タッチパッド コントロール**

![ボタンとしてタッチパッドを操作するユーザー](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-touchpad-renderAsbutton.gif?s=e803a482b67fdb7ad2eaea7608d4b0c3)

```JSON theme={null}
{
    "type": "touchpad",
    "renderAsButton": true,
    "axis": {
        "input": "axisXY",
        "output": "rightJoystick",
        "sensitivity": 3
    },
    "styles": {
        "default" : {
            "faceImage" : {
                "type": "icon",
                "value": "look"
            }
        }
    }
}
```

## 要件

**レイアウト バージョン:** 1.0 以上 (スタイル設定はレイアウト バージョン 3.0 以上で利用可能)


## Related topics

- [Touch Adaptation Kit](/reference/system/touchadaptationkit/touchadaptationkit-reference.md)
- [Templates](/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Modelos](/pt-BR/build/core-features/common/game-streaming/tak-command-line-tool/game-streaming-tak-command-line-templates.md)
- [Touch Adaptation Kit (TAK) Reference](/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview.md)
- [触控适配布局的自定义资产](/zh-CN/build/core-features/common/game-streaming/building-touch-layouts/game-streaming-tak-custom-assets.md)