> ## 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 (Experimental)

# Layer (Experimental)

기본 터치 레이아웃 위에 오버레이될 수 있는 자식 터치 레이아웃입니다.

> [!WARNING]
>
> 레이어는 현재 실험적 형태로 사용할 수 있으며, 얼리 어답터 피드백에 따라 동작이 변경될 수 있습니다.

## 속성

명명된 layer 객체는 다음 속성을 포함합니다.

`center` - *object*, *optional*. 화면 중앙에 표시되는 컨트롤 [Wheel](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)입니다.

`left` - *object*, *optional*. 기본적으로 플레이어의 왼손/왼쪽 엄지 아래에 표시되는 컨트롤 [Wheel](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)입니다.

`lower` - *object*, *optional*. 컨트롤의 아래쪽 행에 있는 `leftCenter`, `center`, `rightCenter` 슬롯 중 어디에나 컨트롤을 배치할 수 있는 객체입니다.

`right` - *object*, *optional*. 기본적으로 플레이어의 오른손/오른쪽 엄지 아래에 표시되는 컨트롤 [Wheel](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-wheel)입니다.

`upper` - *object*, *optional*. 컨트롤의 위쪽 행에 있는 `right` 슬롯에 컨트롤 배열을 배치할 수 있는 객체입니다.

## 설명

`layer`가 사용되면, 일반 레이아웃에서 `control`이 사용되는 각 슬롯(`center`, `left`, `lower`, `right`, `upper` 위치)에서 이전에 표시되던 것을 대체할 컨트롤을 포함하거나, [`blank`](/ko/reference/system/touchadaptationkit/controls/game-streaming-touch-blank) 컨트롤을 사용하여 해당 슬롯에 이전에 표시되던 것을 숨길 수 있습니다.

`layer`가 표시되려면, 레이아웃을 표시하도록 하는 [layer action](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action)이 있는 [`button`](/ko/reference/system/touchadaptationkit/controls/game-streaming-touch-button) 컨트롤이 있어야 합니다.

## 예제

이 예제는 오른쪽 상단의 버튼을 눌러 고급 능력이 포함된 레이어의 표시를 전환할 수 있는 간단한 플랫포머 레이아웃으로 시작합니다.

![Player interacting with layout and using a layer to expose additional controls](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 참조](/ko/build/core-features/common/game-streaming/game-streaming-touch-touch-adaptation-kit-overview)\
[Blank control](/ko/reference/system/touchadaptationkit/controls/game-streaming-touch-blank)\
[Layer action](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-layer-action)\
[Layout](/ko/reference/system/touchadaptationkit/layout/game-streaming-touch-layout)


## Related topics

- [ClearUnorderedAccessViewFloat](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewfloat_public.md)
- [ClearUnorderedAccessViewUint](/reference/graphics/d3d12/interfaces/id3d12graphicscommandlist/methods/id3d12graphicscommandlist_clearunorderedaccessviewuint_public.md)
- [WinHTTP overview](/build/console-features/networking/web-requests/intro-winhttp.md)
- [WinHTTP 概述](/zh-CN/build/console-features/networking/web-requests/intro-winhttp.md)
- [Visão geral do WinHTTP](/pt-BR/build/console-features/networking/web-requests/intro-winhttp.md)