> ## 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.

# レイヤー

> Layer (実験的)

# Layer (実験的)

ベース タッチ レイアウトの上に重ねて表示できる子タッチ レイアウト。

> [!WARNING]
>
> レイヤーは現在、実験的な形式で利用可能であり、早期採用者のフィードバックに基づいて動作が変更される可能性があります。

## プロパティ

名前付きの layer オブジェクトには次のプロパティが含まれます。

`center` - *object*、*省略可*。画面中央に表示されるコントロールの [Wheel](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)。

`left` - *object*、*省略可*。既定でプレイヤーの左手/親指の下に表示されるコントロールの [Wheel](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)。

`lower` - *object*、*省略可*。コントロールの下段行の `leftCenter`、`center`、または `rightCenter` の 3 つのスロットのいずれかにコントロールを配置できるオブジェクト。

`right` - *object*、*省略可*。既定でプレイヤーの右手/親指の下に表示されるコントロールの [Wheel](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)。

`upper` - *object*、*省略可*。コントロールの上段行の `right` スロットにコントロールの配列を配置できるオブジェクト。

## 補足

`layer` を利用する場合、通常のレイアウトで `control` が利用されている各スロット (`center`、`left`、`lower`、`right`、`upper` の位置) で、以前に表示されていた内容を置き換えるコントロールを含めるか、または以前にそのスロットで表示されていた内容を非表示にするために [`blank`](/ja-jp/reference/system/touchadaptationkit/controls/game-streaming-touch-blank) コントロールを利用できます。

`layer` を表示するには、レイアウトを表示させる [layer action](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action) を持つ [`button`](/ja-jp/reference/system/touchadaptationkit/controls/game-streaming-touch-button) コントロールが必要です。

## サンプル

このサンプルは、シンプルなプラットフォーマー レイアウトで開始し、右上に高度な能力を持つレイヤーの表示を切り替えるボタンがあります。

![レイアウトを操作し、追加のコントロールを公開するためにレイヤーを使用するプレイヤー](https://mintcdn.com/microsoft-4404708b/gzrdvT5kpqAXKEQt/images/gdk/reference/game-streaming-touch-control-images-layer-special-ability.gif?s=75cb7f41bedfbe02eb6548681a548576)

```JSON theme={null}
{
    "$schema": "https://raw.githubusercontent.com/microsoft/xbox-game-streaming-tools/main/touch-adaptation-kit/schemas/layout/v3.1/layout.json",
    "content": {
        "left": {
            "inner": [
                {
                    "type": "directionalPad",
                    "scale": 1.5
                }
            ]
        },
        "right": {
            "inner": [
                {
                    "type": "button",
                    "action": "gamepadY",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "dash"
                            }
                        }
                    }
                },
                {
                    "type": "button",
                    "action": "gamepadA",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "jump"
                            }
                        }
                    }
                }
            ],
            "outer": [
                null,
                {
                    "type": "button",
                    "action": "gamepadB",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "specialAbility"
                            }
                        }
                    }
                },
                null,
                null,
                {
                    "type": "button",
                    "action": "gamepadX",
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "fire"
                            }
                        }
                    }
                }
            ]
        },
        "upper": {
            "right": [
                {
                    "type": "button",
                    "action": {
                        "type": "layer",
                        "target": "selectAbility"
                    },
                    "styles": {
                        "default": {
                            "faceImage": {
                                "type": "icon",
                                "value": "add"
                            }
                        }
                    },
                    "toggle" : true
                },
                {
                    "type": "button",
                    "action": "view"
                },
                {
                    "type": "button",
                    "action": "menu"
                }
            ]
        },
        "layers": {
            "selectAbility": {
                "right": {
                    "outer": [
                        null,
                        null,
                        null,
                        null,
                        null,
                        null,
                        {
                            "type": "button",
                            "action": "rightBumper",
                            "styles": {
                                "default": {
                                    "faceImage": {
                                        "type": "icon",
                                        "value": "ability2"
                                    }
                                }
                            }
                        },
                        {
                            "type": "button",
                            "action": "leftBumper",
                            "styles": {
                                "default": {
                                    "faceImage": {
                                        "type": "icon",
                                        "value": "ability"
                                    }
                                }
                            }
                        }
                    ]
                }
            }
        }
    }
}

```

## 関連項目

[Touch Adaptation Kit リファレンス](/ja-jp/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Blank control](/ja-jp/reference/system/touchadaptationkit/controls/game-streaming-touch-blank)\
[Layer action](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action)\
[Layout](/ja-jp/reference/system/touchadaptationkit/layout/game-streaming-touch-layout)


## Related topics

- [プレイヤー データ](/ja-jp/services/playfab/player-progression/player-data/index.md)
- [最近のプレイヤー](/ja-jp/services/xbox-services/multiplayer/mpa/concepts/live-mpa-recent-players.md)
- [マルチプレイヤー](/ja-jp/services/xbox-services/multiplayer/index.md)
- [プレイヤー ログイン](/ja-jp/services/playfab/identity/player-identity/login/index.md)