TV 게임 빌드

텔레비전 화면에는 모바일 게임 개발자가 처음 접할 수 있는 여러 가지 고려사항이 있습니다. 이러한 영역에는 앱의 큰 크기, 컨트롤 체계, 모든 플레이어가 동시에 시청하고 있다는 사실이 포함됩니다.

디스플레이

TV 화면용 게임을 개발할 때 유의해야 할 두 가지 주요 사항은 게임을 가로 방향으로 설계하고 짧은 지연 시간을 지원한다는 것입니다.

가로 디스플레이 지원

TV는 항상 가로로 되었습니다. 회전할 수 없으므로 세로 방향이 없습니다. TV 게임이 항상 가로 모드로 표시되도록 설계하세요.

자동 짧은 지연 시간 모드

특정 디스플레이는 그래픽 후처리를 수행할 수 있습니다. 이러한 후처리는 그래픽 품질을 개선하지만 지연 시간을 늘릴 수 있습니다. HDMI 2.1을 지원하는 최신 디스플레이에는 자동 짧은 지연 시간 모드 (ALLM)가 있어 후처리를 사용 중지하여 지연 시간을 최소화합니다. ALLM에 관한 자세한 내용은 HDMI 2.1 사양을 참조하세요. 다른 디스플레이도 유사한 동작의 게임 모드를 지원할 수 있습니다.

Android 11 이상에서는 가능한 경우 최소 후처리를 요청하여 자동 짧은 지연 시간 모드 또는 게임 모드를 사용하도록 창에서 요청할 수 있습니다. 이는 최상의 그래픽을 제공하는 것보다 짧은 지연 시간이 더 중요한 게임 및 화상 회의 애플리케이션에 특히 유용합니다.

최소 후처리를 사용 설정하거나 중지하려면 Window.setPreferMinimalPostProcessing()를 호출하거나 창의 preferMinimalPostProcessing 속성을 true로 설정합니다. 일부 디스플레이는 최소 후처리를 지원하지 않습니다. 특정 디스플레이의 지원 여부를 확인하려면 Display.isMinimalPostProcessingSupported() 메서드를 호출하세요.

입력 기기

TV에는 터치 인터페이스가 없으므로 컨트롤을 올바르게 설정하고 플레이어가 컨트롤을 직관적이고 재미있게 사용할 수 있도록 하는 것이 훨씬 더 중요합니다. 컨트롤러를 처리할 때는 여러 컨트롤러 추적 및 원활한 연결 해제 처리와 같이 주의해야 할 다른 문제도 발생합니다. 게임을 포함한 모든 TV 앱은 컨트롤러를 일관되게 처리해야 합니다. TV 컨트롤러 사용에 관한 자세한 내용은 TV 컨트롤러 관리를, 게임에 TV 컨트롤러를 사용하는 방법에 관한 자세한 내용은 게임 컨트롤러 처리를 참고하세요.

키보드 레이아웃

Android 13 (API 수준 33) 이상에서는 getKeyCodeForKeyLocation()를 사용하여 키보드 레이아웃을 결정할 수 있습니다. 예를 들어 게임이 WASD 키를 사용한 이동을 지원하지만 A와 W 키가 서로 다른 위치에 있는 AZERTY 키보드에서는 제대로 작동하지 않을 수 있습니다. 특정 위치에 있을 것으로 예상되는 키의 키 코드를 가져올 수 있습니다.

Kotlin

val inputManager: InputManager? = requireActivity().getSystemService()

inputManager?.inputDeviceIds?.map { inputManager.getInputDevice(it) }
    ?.firstOrNull { it.keyboardType == InputDevice.KEYBOARD_TYPE_ALPHABETIC }
    ?.let { inputDevice ->
        keyUp = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_W)
        keyLeft = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_A)
        keyDown = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_S)
        keyRight = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_D)
    }

Java

InputManager inputManager = requireActivity().getSystemService(InputManager.class);
InputDevice inputDevice = Arrays.stream(inputManager.getInputDeviceIds())
        .mapToObj(inputManager::getInputDevice)
        .filter( device -> device.getKeyboardType() == InputDevice.KEYBOARD_TYPE_ALPHABETIC)
        .filter(Objects::nonNull)
        .findFirst()
        .orElse(null);
if (inputDevice != null) {
    keyUp = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_W);
    keyLeft = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_A);
    keyDown = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_S);
    keyRight = inputDevice.getKeyCodeForKeyLocation(KeyEvent.KEYCODE_D);
}

이 예에서 AZERTY 키보드에서 keyUpKeyEvent.KEYCODE_Z로, keyLeftKeyEvent.KEYCODE_Q로 설정되며, keyDownkeyRight는 각각 KeyEvent.KEYCODE_SKeyEvent.KEYCODE_D로 설정됩니다. 이제 이러한 키 코드의 키 이벤트 핸들러를 만들고 예상되는 동작을 구현할 수 있습니다.

매니페스트

게임이 Android manifest에 포함해야 하는 몇 가지 특수 항목이 있습니다.

홈 화면에 게임 표시

Android TV 홈 화면에는 게임이 일반 앱과 별도의 행에 표시됩니다. 게임을 게임 목록에 표시하려면 앱 매니페스트의 <application> 태그에서 android:isGame 속성을 "true"로 설정합니다. 예:

<application
    ...
    android:isGame="true"
    ...
>

게임 컨트롤러 지원 선언

TV 기기 사용자를 위해 게임 컨트롤러를 사용 가능하게 하거나 활성화하지 못할 수 있습니다. 게임이 게임 컨트롤러를 지원한다는 것을 사용자에게 올바르게 알리려면 앱 매니페스트에 다음 항목을 포함해야 합니다.

  <uses-feature android:name="android.hardware.gamepad" android:required="false"/>

참고: android:hardware:gamepad 지원을 지정할 때 android:required 속성을 "true"로 설정하지 마세요. 이렇게 하면 사용자가 TV 기기에 앱을 설치할 수 없습니다.

매니페스트 항목에 관한 자세한 내용은 앱 매니페스트를 참고하세요.

Google Play 게임 서비스

게임이 Google Play 게임 서비스를 통합한 경우 업적, 로그인, 게임 저장과 관련된 여러 고려사항에 유의해야 합니다.

업적

게임에는 5개 이상의 획득 가능한 업적이 포함되어야 합니다. 지원되는 입력 기기에서 게임플레이를 제어하는 사용자만 업적을 달성할 수 있어야 합니다. 업적과 업적을 구현하는 방법에 관한 자세한 내용은 Android에서의 업적을 참고하세요.

로그인

게임은 시작 시 사용자를 로그인하려고 시도해야 합니다. 플레이어가 연속해서 여러 번 로그인을 거부하면 게임에서 요청을 중지해야 합니다. Android에서 로그인 구현하기에서 로그인에 관해 자세히 알아보세요.

저장

Google Play 서비스의 저장된 게임을 사용하여 게임 저장 기능을 저장합니다. 게임은 여러 기기에서 고유하게 식별할 수 있도록 게임 저장을 특정 Google 계정에 결합해야 합니다. 플레이어가 핸드셋을 사용하든 TV를 사용하든 상관없이 게임은 동일한 사용자 계정에서 게임 저장 정보를 가져올 수 있어야 합니다.

또한 플레이어가 로컬 및 클라우드에 저장된 데이터를 삭제할 수 있는 옵션을 게임 UI에 제공해야 합니다. 게임의 Settings 화면에 이 옵션을 배치할 수 있습니다. Play 서비스를 사용하여 저장된 게임을 구현하는 방법에 관한 자세한 내용은 Android의 저장된 게임을 참조하세요.

종료

사용자가 게임을 정상적으로 종료할 수 있도록 하는 일관되고 명확한 UI 요소를 제공하세요. 이 요소는 D패드 탐색 버튼으로 액세스할 수 있어야 합니다. 이탈을 제공하는 홈 버튼에 의존하는 대신 이 방법을 사용하세요. 홈 버튼은 여러 컨트롤러에서 일관되지도 않고 안정적이지 않기 때문입니다.

Android TV용 게임에서 웹 탐색을 사용 설정하지 마세요. Android TV는 웹브라우저를 지원하지 않습니다.

참고: 소셜 미디어 서비스 로그인을 위해 WebView 클래스를 사용할 수 있습니다.

네트워킹

최적의 성능을 제공하기 위해서는 게임에 더 큰 대역폭이 필요한 경우가 많으며, 많은 사용자가 이러한 성능을 제공하기 위해 Wi-Fi보다 이더넷을 선호합니다. 앱에서 Wi-Fi 및 이더넷 연결을 모두 확인해야 합니다. 앱이 TV 전용인 경우 모바일 앱에서와 같이 3G/LTE 서비스를 확인할 필요가 없습니다.