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)
    }

자바

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패드 탐색 버튼을 사용하여 이 요소에 액세스할 수 있어야 합니다. 홈 버튼을 사용하여 종료하는 것은 여러 컨트롤러에서 일관되지 않고 신뢰할 수 없으므로 대신 D패드 탐색 버튼을 사용하세요.

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

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

네트워킹

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