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

TV ゲームを作成する

テレビ画面には、モバイルゲームでは新しいと思われるさまざまな考慮事項が提示されている開発できます。これらの分野には、その規模、コントロール方法、すべてのプレーヤーが表示されます。

ディスプレイ

テレビ画面用のゲームを開発する際には、低レイテンシに対応できるよう設計されています

横向き表示のサポート

テレビは常に横向きで、回転させることはできず、縦向きにはなりません。常に設計するテレビゲームを横向きで表示できます

自動低遅延モード

一部のディスプレイでは、グラフィックの後処理を実行できます。この後処理によりグラフィックスが改善します。レイテンシが増加する可能性がありますHDMI 2.1 対応の新しいディスプレイには、 レイテンシモード（ALLM）は、この後処理をオフに切り替えることでレイテンシを最小限に抑えます。対象 ALLM について詳しくは、このモジュールの HDMI 2.1 仕様その他ディスプレイが、同様の動作のゲームモードをサポートしている場合があります。

Android 11 以降では、ウィンドウで自動低遅延モードまたはゲームをリクエストできます。モードを使用する場合は、最小限の後処理をリクエストします。これは特にゲームアプリケーションやビデオ会議アプリケーションに役立ちます。これらのアプリケーションでは、アプリケーションよりもレイテンシの最適なグラフィックで最適な状態を提供することを目指しています

最小限の後処理を有効または無効にするには、 Window.setPreferMinimalPostProcessing(), またはウィンドウの preferMinimalPostProcessing 属性を true に設定します。すべてのディスプレイが最小限の後処理をサポートしているわけではありません。問題の有無をサポートしている場合は、 Display.isMinimalPostProcessingSupported() メソッドを使用します。

入力デバイス

テレビにはタッチ操作のインターフェースがないので正しく操作してプレーヤーが直感的で楽しいと感じられることが重要ですコントローラの処理また、複数のイベントの追跡など、注意を払うべき正常な切断の処理を行いますゲームを含むすべてのテレビアプリは、整合性を維持します。詳しくは、テレビの管理コントローラをご覧ください。特定のインスタンスのゲーム用のコントローラを処理するゲームでのテレビコントローラの使用に関する情報をご覧ください。

キーボードレイアウト

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 のホーム画面では、通常のアプリとは別の行にゲームが表示されます。ゲームをゲームリストに表示するには、 <ph type="x-smartling-placeholder"></ph> android:isGame 属性を、アプリマニフェストの "true" に追加する <application> タグを付けます。次に例を示します。

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

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

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

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

注: android:hardware:gamepad サポートを指定する場合は、 android:required 属性を "true" に設定。この操作を行うと、ユーザーはテレビデバイスにアプリをインストールします。

マニフェストエントリの詳細については、このモジュールのアプリマニフェスト。

Google Play ゲームサービス

ゲームが Google Play Games サービスを統合している場合は、注意すべき点として実績、ログイン、ゲームの保存に関する考慮事項。

実績

ゲームには、少なくとも 5 つの（獲得可能な）実績がなければなりません。ゲームプレイを制御しているユーザーのみ実績を獲得できるようにする必要があります。詳細については、このモジュールのおよびその実装方法については、Android での実績をご覧ください。

ゲームの起動時には、ユーザーのログインを試す必要があります。プレーヤーがログインを何度か拒否した場合質問が止まるようにする必要があります。ログインについて詳しくは、ログインを実装する Android。

保存

Google Play 開発者サービスの保存済みゲームを使用してデータを保存表示されます。ゲームは、ゲームセーブを特定の Google アカウントにバインドして、たとえば、プレーヤーが使用しているのがハンドセットかテレビかにかかわらず、ゲームは、同じユーザーアカウントからゲーム保存情報を取得できる必要があります。

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

終了

ユーザーがゲームを正常に終了できる、一貫性のある明確な UI 要素を用意してください。この要素には、D-pad ナビゲーションボタンでアクセスできる必要があります。この方法は、基盤となるインフラストラクチャ終了するためのホームボタンを使用する。これは、コントローラ間で一貫性もなく、信頼性もない。

ウェブ

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

注: ログインに WebView クラスを使用すると、ソーシャルメディアサービスなど、

ネットワーク

ゲームで最適なパフォーマンスを実現するには、大容量の帯域幅が必要になることが多く、ユーザーの多くはそのパフォーマンスを提供しますアプリで Wi-Fi とイーサネットの両方を確認する必要があります。接続しますアプリがテレビのみを対象としている場合、それまでと同様に 3G/LTE サービスを確認する必要はありません。モバイルアプリの場合は