---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/games/doc/en/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/hi/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/ko/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/ru/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/tr/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/vi/sdk/construct-3/tv-support.md
  - https://yandex.com/dev/games/doc/zh/sdk/construct-3/tv-support.md
  - href: ko/sdk/construct-3/tv-support.md
    type: text/markdown
    title: Markdown version
  - href: ../../llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.com/dev/games/doc/ko/llms.txt

# TV 지원

게임이 TV 플랫폼에서 제대로 작동하려면 다음 요구 사항을 충족해야 합니다:

- 게임은 화면의 전체 영역을 차지하며, 전체 화면 모드를 지원합니다.
- 게임은 TV 리모컨의 화살표 버튼을 사용하여 상호 작용 요소의 관리 및 탐색을 지원합니다.
- 게임은 TV 리모컨의 **Back** 및 **OK** 버튼의 눌림을 지원합니다.

## 리모컨 관리

플러그인에서는 리모컨의 버튼과 상호 작용하기 위해 다음을 제공합니다:

- 조건 **TV Remote button pressed**: 선택한 버튼이 현재 눌려 있을 때 참입니다.
- 트리거 **On TV Remote button press**: 플레이어가 지정된 버튼을 누를 때 작동합니다.
- 트리거 **On TV Remote button release**: 플레이어가 지정된 버튼을 놓을 때 작동합니다.

각각의 시각적 블록에 대해 **Up**, **Down**, **Left**, **Right**, **OK** 버튼을 설정할 수 있습니다.

이를 통해 플랫폼의 특성을 염려하지 않고도 TV 관리 지원을 구현할 수 있습니다.

![](../../_images/construct-3/tv-support/tv-example.png)

## `HISTORY_BACK` 및 `EXIT` 이벤트

`HISTORY_BACK` 이벤트는 **Back** 버튼을 TV 리모컨에서 누르거나, 음성 명령이나 제스처 등 다양한 방법으로 호출될 수 있습니다.

게임의 컨텍스트에서 **Back** 버튼의 주요 이벤트:

- 게임 시작 메뉴에서의 누름 — 게임 종료 확인 창 호출.
- 게임 플레이 중에 누름 — 게임 일시 중지 및 메뉴 호출.
- 게임 플레이 중에 두 번 누름 — 게임 종료 확인 창 호출.

`HISTORY_BACK` 이벤트를 처리하기 위해 플러그인에서는 조건 **On History Back event**를 제공합니다.

게임에서 나가려면 `EXIT` 매개변수를 사용하여 **Dispatch event**를 호출할 수 있습니다.

![](../../_images/construct-3/tv-support/history-back-example.png)

## TV 리모컨 에뮬레이터

게임 테스트를 용이하게 하기 위해, 플러그인에는 **F6** 버튼을 눌러 활성화할 수 있는 TV 리모컨 에뮬레이터가 내장되어 있습니다.

{% note info "참고" %}

리모컨 에뮬레이터는 미리보기 모드에서만 사용할 수 있습니다. 게임의 릴리스 버전에서는 에뮬레이터가 작동하지 않습니다.

{% endnote %}

![](../../_images/construct-3/tv-support/tv-emulator.gif)

---


<!-- source: ko/_includes/button-git-construct.md -->
<a href="https://github.com/yandex-games-plugins/construct3">
  <span class="button">저장소</span>
</a>
<!-- endsource: ko/_includes/button-git-construct.md -->