---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://yandex.com/dev/games/doc/hi/concepts/develop-for-tv.md
  - https://yandex.com/dev/games/doc/ko/concepts/develop-for-tv.md
  - https://yandex.com/dev/games/doc/vi/concepts/develop-for-tv.md
  - href: ko/concepts/develop-for-tv.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 리모컨의 **뒤로** 및 **확인** 버튼 사용을 지원합니다.
- 앱 내에서 인앱 구매가 없습니다.
- 게임 내에 다른 개발자의 앱으로의 링크가 없습니다.


{% note info "참고" %}

시간이 지남에 따라 요구 사항 목록이 확장될 수 있습니다. 현재 기준을 확인하려면 [게임 요구 사항](https://yandex.com/dev/games/doc/ko/concepts/requirements.md)을 참조하세요.

{% endnote %}

## 화살표 및 확인 버튼 누르기 이벤트 처리

리모컨 버튼은 게임과 다음 섹션에서 모두 작동해야 합니다.

- 게임 시작 전에 표시되는 시작 메뉴(해당되는 경우). 예를 들어, 리모컨에서 **확인**을 눌러 게임을 시작하거나 화살표를 사용하여 레벨을 선택하는 기능이 지원되어야 합니다.
- **뒤로** 버튼을 사용하여 열리는 게임 내 메뉴.

리모컨은 한 번에 하나의 이벤트만 전송합니다. 게임에서 한 번에 여러 개의 버튼을 사용하는 경우 점프나 앞으로 이동과 같은 일부 동작을 자동으로 설정할 수 있습니다.

리모컨 버튼 누르기 이벤트에 대한 설명은 [키보드 이벤트 문서](https://developer.mozilla.org/en-US/docs/Web/API/KeyboardEvent/key)를 참조하세요. 리모콘 버튼은 특정 이벤트 값에 해당합니다.

- 화살표: `ArrowLeft`, `ArrowUp`, `ArrowRight`, `ArrowDown`.
- **확인**: `Enter`.

게임패드와 호환되는 게임 엔진([Unity](https://docs.unity3d.com/ScriptReference/KeyCode.html), [Construct](https://www.construct.net/en/make-games/manuals/construct-3/plugin-reference/gamepad) 또는 [Defold](https://defold.com/manuals/input-gamepads/))을 사용하는 경우 TV 리모컨이 해당 엔진의 게임패드로 등록됩니다. 이러한 게임의 경우 화살표 및 **확인** 버튼 이벤트는 게임패드 설명서에 따라 처리해야 합니다.

## 뒤로 버튼 누르기 이벤트 처리하기

모든 스마트 TV 리모컨에는 **뒤로** 버튼이 있습니다.

다음은 게임에서 **뒤로** 버튼과 관련된 주요 이벤트입니다.

- 게임 시작 메뉴에서 버튼을 누르면 사용자에게 게임 종료를 확인하는 창이 열립니다.
- 게임이 시작된 후 버튼을 누르면 게임이 일시 중지되고 게임 메뉴가 열립니다.
- 게임 중에 버튼을 두 번 누르면 게임 종료를 확인하는 창이 열립니다.

이벤트에 대한 자세한 설명은 [이벤트](https://yandex.com/dev/games/doc/ko/sdk/sdk-events.md)를 참조하세요.

## Yandex Games SDK와 상호 작용하기

[Yandex Games SDK가 초기화](https://yandex.com/dev/games/doc/ko/sdk/sdk-about.md)된 후, `deviceInfo` 객체는 유형 필드에 사용자의 장치 `type`을 반환합니다.

TV에서 게임을 시작하면 `type` 필드에 `tv` 값이 있는 문자열이 반환됩니다. 이후 리모컨으로 게임을 제어하는 해당 로직을 게임에 전달할 수 있습니다. 또한 게임 플레이에 필요한 텍스트, 교육 자료, 기타 콘텐츠를 전달할 수도 있습니다.

`deviceInfo` 객체와 그 메서드에 대한 자세한 내용은 [기타 SDK 객체 및 파라미터](https://yandex.com/dev/games/doc/ko/sdk/sdk-params.md)를 참고하세요.

## 게임 추가하기

TV 리모컨 버튼에 대한 지원을 구현한 후에는 Yandex Games 카탈로그에 게임을 추가할 수 있습니다. Yandex Games 대시보드에서 게임 초안을 작성할 때 지원되는 플랫폼 목록에서 `TV`를 선택합니다.

게임이 검토를 통과하면 특별 [TV 번들](https://yandex.com/games/?bundle=tv)에 포함되어 TV 사용자가 사용할 수 있게 됩니다.

## 게임 테스트하기

Yandex TV 스토어를 지원하는 TV에서 초안을 열어 게임을 테스트할 수 있습니다.

1. Yandex Games 앱을 열고 시작 페이지가 로드될 때까지 기다립니다.
2. 리모컨에서 다음 키를 누릅니다. ← ↑ ← ↑ ← ↑ ← ↑. 입력 화면이 열립니다.

   {% note info "참고" %}

   시작 페이지 인터페이스의 왼쪽 상단 타일을 선택하면 시퀀스가 작동합니다.

   {% endnote %}

3. 게임 ID를 입력합니다.