TV용으로 적응

게임이 TV 플랫폼에서 올바르게 작동하려면 다음 요구 사항을 충족해야 합니다.

• 게임이 화면의 전체 영역을 사용합니다. 게임에서 전체 화면 모드를 사용할 수 있습니다.
• 게임이 TV 리모컨 화살표를 사용하여 게임을 제어하고 대화형 게임 요소를 탐색하는 것을 지원합니다.
• 이 게임은 TV 리모컨의 뒤로 및 확인 버튼 사용을 지원합니다.
• 앱 내에서 인앱 구매가 없습니다.
• 게임 내에 다른 개발자의 앱으로의 링크가 없습니다.

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

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

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

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

리모컨 버튼 누르기 이벤트에 대한 설명은 키보드 이벤트 문서를 참조하세요. 리모콘 버튼은 특정 이벤트 값에 해당합니다.

• 화살표: ArrowLeft, ArrowUp, ArrowRight, ArrowDown.
• 확인: Enter.

게임패드와 호환되는 게임 엔진(Unity, Construct 또는 Defold)을 사용하는 경우 TV 리모컨이 해당 엔진의 게임패드로 등록됩니다. 이러한 게임의 경우 화살표 및 확인 버튼 이벤트는 게임패드 설명서에 따라 처리해야 합니다.

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

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

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

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

이벤트에 대한 자세한 설명은 이벤트를 참조하세요.

Yandex Games SDK와 상호 작용하기

Yandex Games SDK가 초기화된 후, deviceInfo 객체는 유형 필드에 사용자의 장치 type을 반환합니다.

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

deviceInfo 객체와 그 메서드에 대한 자세한 내용은 기타 SDK 객체 및 파라미터를 참고하세요.

게임 추가하기

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

게임이 검토를 통과하면 특별 TV 번들에 포함되어 TV 사용자가 사용할 수 있게 됩니다.

게임 테스트하기

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

1. Yandex Games 앱을 열고 시작 페이지가 로드될 때까지 기다립니다.

2. 리모컨에서 다음 키를 누릅니다. ← ↑ ← ↑ ← ↑ ← ↑. 입력 화면이 열립니다.

   참고

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

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