このページは Cloud Translation API によって翻訳されました。

TV ゲームを作成する

テレビ画面には、モバイルゲームデベロッパーにとって初めての考慮事項がいくつか提示されています。画面が大きいこと、操作方法、全プレーヤーが同時に見ているといった点です。

ディスプレイ

テレビ画面向けのゲーム開発で主に気を付けるべき点は、横向きの画面用にゲームを設計する必要がある点と、低レイテンシをサポートする必要がある点の 2 つです。

横向き表示のサポート

テレビは常に横向きで、回転させることはできず、縦向きにはなりません。TV ゲームは常に横向きで表示されるように設計してください。

自動低遅延モード

一部のディスプレイでは、グラフィックの後処理を実行できます。この後処理はグラフィックの品質を向上させますが、レイテンシが増大することがあります。HDMI 2.1 をサポートする新しいディスプレイには、自動低レイテンシモード（ALLM）があり、この後処理をオフに切り替えることでレイテンシを最小限に抑えることができます。ALLM について詳しくは、HDMI 2.1 仕様をご覧ください。他のディスプレイでは、同様の動作をするゲームモードがサポートされている場合があります。

Android 11 以降では、ウィンドウは最小限の後処理をリクエストすることで、自動低レイテンシモードまたはゲームモード（利用可能な場合）を使用するようにリクエストできます。これは、可能な限り最高のグラフィックを提供するよりも、低レイテンシのほうが重要なゲームやビデオ会議のアプリで特に有効です。

後処理の最小化を有効または無効にするには、Window.setPreferMinimalPostProcessing() を呼び出すか、ウィンドウの preferMinimalPostProcessing 属性を true に設定します。すべてのディスプレイが後処理の最小化に対応しているわけではありません。特定のディスプレイが対応しているかどうかを調べるには、Display.isMinimalPostProcessingSupported() メソッドを呼び出します。

入力デバイス

テレビにはタッチインターフェースがないため、適切な操作方法で、直観的に心地よく使用できるようにすることが重要となります。また、コントローラの処理により、複数のコントローラの追跡や切断の適切な処理など、注意が必要な他の問題も発生します。ゲームを含むすべての 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 キーボードで keyUp は KeyEvent.KEYCODE_Z に、keyLeft は KeyEvent.KEYCODE_Q に、keyDown と keyRight はそれぞれ KeyEvent.KEYCODE_S と KeyEvent.KEYCODE_D に設定されています。これで、これらのキーコードのキーイベントハンドラを作成して、想定される動作を実装できます。

マニフェスト

ゲームでは、Android マニフェストに必ず含めるべきものがあります。

ゲームをホーム画面に表示する

Android TV のホーム画面では、通常のアプリとは別の行にゲームが表示されます。ゲームをゲームのリストに表示するには、アプリマニフェストの <application> タグ内で android:isGame 属性を "true" に設定します。次に例を示します。

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

ゲームコントローラのサポートを宣言する

テレビデバイスのユーザーがゲームコントローラを利用できない場合、あるいはアクティブでない場合があります。ゲームがゲームコントローラに対応していることをユーザーに正しく通知するには、アプリマニフェストに次のエントリを追加する必要があります。

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

注: android:hardware:gamepad のサポートを指定する場合、android:required 属性を "true" に設定しないでください。そのように設定すると、ユーザーがそのアプリをテレビデバイスにインストールできなくなります。

マニフェストエントリの詳細については、アプリマニフェストをご覧ください。

Google Play ゲームサービス

ゲームを Google Play ゲームサービスに統合する場合は、実績、ログイン、ゲームの保存に関連して、いくつかの点を考慮する必要があります。

実績

ゲームには、少なくとも 5 つの（獲得可能な）実績がなければなりません。実績を獲得できるのは、サポートされている入力デバイスからゲームプレイを操作しているユーザーだけでなければなりません。実績の詳細と実装方法については、Android の実績をご覧ください。

ゲームの起動時には、ユーザーのログインを試す必要があります。プレーヤーがログインを連続して数回拒否した場合、ゲームはログインを拒否する必要があります。ログインの詳細については、Android でのログインの実装をご覧ください。

保存

Google Play 開発者サービスの保存済みゲームを使用して、ゲームのセーブデータを保存します。ゲームの保存は、異なるデバイス間でも一意に識別できるように、特定の Google アカウントに結び付けて行う必要があります。プレーヤーが使用しているのがハンドセットかテレビかにかかわらず、保存済みゲーム情報を同じユーザーアカウントから取得できる必要があります。

また、プレーヤーがローカルとクラウドに保存されたデータを削除できるオプションをゲームの UI で提供する必要があります。このオプションはゲームの Settings 画面に置くことができます。Play 開発者サービスを使用した保存済みゲームの実装の詳細については、Android の保存済みゲームをご覧ください。

終了

ユーザーがゲームを正常に終了できる、一貫性のある明確な UI 要素を用意してください。この要素は、D-pad ナビゲーションボタンで利用できる必要があります。これは、ホームボタンに依存して終了を提供するのではなく、異なるコントローラ間の一貫性や信頼性に欠けるためです。

ウェブ

Android TV のゲームではウェブブラウジングを有効にしないでください。Android TV はウェブブラウザをサポートしていません。

注: ソーシャルメディアサービスへのログインには WebView クラスを使用できます。

ネットワーク

ゲームでは、最適なパフォーマンスを実現するためにより大きな帯域幅を必要とすることが多く、多くのユーザーは、そのパフォーマンスを提供するために Wi-Fi よりもイーサネットを好んでいます。アプリでは、WiFi 接続とイーサネット接続の両方を確認する必要があります。テレビ専用のアプリの場合、モバイルアプリの場合のように 3G/LTE サービスを確認する必要はありません。