ドキュメント

Unity Engine

Unity Engine

大画面および折りたたみデバイスサポート

大画面および折り畳み式の Android デバイス向けにアプリケーションを最適化するために使用できる設定と API に関する情報が記載されています。
読み終わるまでの所要時間 13 分最終更新 6日前

Android 12 以降を実行する大画面デバイスや折り畳み式デバイスでは、アプリケーションはデフォルト設定に関係なく、マルチウィンドウモードで他のアプリケーションと同時に実行できます。アプリケーションが特定の向きやアスペクト比向けに設計されている場合、またはサイズ変更できない場合、Android OS は自動的に互換性モードに切り替えます。このモードでは、Android OS は使用可能な画面サイズに合わせてアプリケーションを拡大縮小します。ただし、アプリケーションが特定の画面サイズ用に最適化されていないため、ユーザー体験が最適でない場合があります。
注
Android 12 以降のバージョンを実行するデバイスでは、マルチウィンドウモード がデフォルト動作です。Android 16以降、Android 16以降のバージョンをターゲットとするアプリケーションでは、大画面デバイスに対する追加の変更が導入されています。詳細については、Android 16の大画面デバイスでの動作変更に関するドキュメントを参照してください。
一貫したユーザー エクスペリエンスを確保するには、大画面や折り畳み式デバイスなど、さまざまな画面サイズに適応するアプリケーション設計を検討してください。以下の設定と API を使用できます。

Resizeable Activity プレイヤー 設定

Resizeable Activity プレイヤー設定は、アプリケーションでマルチウィンドウモードを有効にし、Android OS がリサイズ可能と見なすようにします。新しいプロジェクトの場合、Unity はこの設定をデフォルトで有効にし、Android マニフェストファイルに
android.resizeableActivity="true"
を設定します。この場合、アスペクト比の制限は無視されます。
android.resizeableActivity="false"
を設定すると、Android OS の動作は以下のようになります。

Android OSバージョン

動作

Android 12 より古いアプリケーションを全画面表示し、マルチウィンドウモードを無効にします。
Android 12 以降デフォルトでマルチウィンドウモードを有効にし、アプリケーションの互換性モードをアクティブにして、使用可能な画面サイズに調整します。

ノート:Android 16 をターゲットとするアプリケーションの場合、Android OS は
resizeableActivity
マニフェスト属性を無視し、使用可能なスクリーンスペースに合わせてアプリケーションを調整します。詳細については、大画面デバイスでの Android 16 の動作変更に関するドキュメントを参照してください。
互換性モードでは、アプリケーションが期待通りにディスプレイされない可能性があります。大画面の画面と折り畳み式デバイスの画面の切り替えなどのシナリオでは、OS がアプリケーションの再起動をユーザーにプロンプトする場合があります。アプリケーションを再起動すると、アクティビティとアプリケーション全体のステートが失われます。
注
Android 12 以降のバージョンを実行する小画面デバイスでは、サイズ変更可能なアプリケーションは、アクティビティの minWidth と minHeight に基づくマルチウィンドウモードをサポートします。サイズ変更できないアプリケーションは、小画面デバイスでのマルチウィンドウモードをサポートしません。

アプリケーションと設定 API

AndroidApplication API は、デバイス上で実行されている Android アプリケーションに関する情報を提供します。この API を使用して、以下のアクションを実行できます。
  • 現在のアクティビティの Java インスタンスにアクセスします。
  • アプリケーションの UI スレッドまたはメインスレッドでイベントを実行します。
  • デバイスでアプリケーションを実行中に設定変更を検出して処理します。
AndroidApplication.onConfigurationChanged メソッドを使用して、デバイス設定変更を検出できます。画面レイアウト、画面サイズ、向きなどのデバイス情報を取得できます。このメソッドは、画面の折り畳みか展開か、使用されているキーボードの種類、言語と地域のユーザー設定など、追加の設定詳細も取得します。取得できるデバイスプロパティの詳細については、AndroidConfiguration API を参照してください。AndroidApplication.onConfigurationChanged メソッドを使用して、ユーザーインターフェースの再配置など必要な調整を行い、アプリケーションがさまざまなデバイス構成にシームレスに適応できるようにします。

大画面デバイスでのAndroid 16の動作変更

Android 16以降、Android 16以降のバージョンをターゲットとするアプリケーションでは、最適なユーザー エクスペリエンスを実現するために、コンテンツをさまざまな画面サイズに動的に適応させる必要があります。大画面デバイスの場合、Android OS はマニフェスト属性または API で定義された向き、サイズ変更、アスペクト比の固定設定を無視します。代わりに、OSはアプリケーションのコンテンツを使用可能なスクリーンスペースに合わせて調整しようとします。
無視される属性の詳細については、Android ドキュメントを参照してください。レイアウトの問題を回避するために、アプリケーションがこれらの変更をサポートしていることを確認してください。

免除

Android 16の動作変更は、以下の場合は適用されません。
  • ゲームに分類されたアプリケーション
  • 最小の画面幅 600dp 未満のデバイスで実行されるアプリケーション
  • デバイス上で実行するアプリケーション。ユーザーがデバイスのアスペクト比設定でアプリケーションのデフォルト動作を手動で選択する。
ゲーム アプリケーションの免除を有効にするために、Unity にはアプリ カテゴリ プレイヤー設定が用意されています。この設定は、サポートされなくなった androidIsGame API に置き換わるものです。

アプリ カテゴリ プレイヤー 設定

アプリカテゴリ設定では、ゲームやその他のアプリタイプなど、アプリケーションのカテゴリを指定できます。ゲームに分類されたアプリケーションの場合、この設定を有効にすると、Android 16の動作変更が確実に免除されます。つまり、Android OS はアプリケーションに定義された固定の向き、サイズ変更、アスペクト比の設定を無視しません。
Adaptive PerformanceパッケージまたはGameMode APIを使用している場合は、アプリ カテゴリをGameに設定する必要があります。これを行うには、以下のステップに従います。
  1. Androidプレイヤー設定>その他設定>設定を開きます。
  2. Enable アプリカテゴリ。
  3. カテゴリのドロップダウンで、Game (ゲーム) を選択します。
ステップが完了すると、Unity はビルドプロセス中にアプリケーションマニフェストファイルに
android:appCategory=game
を自動的に追加します。
ノート:
  • 新規プロジェクトの場合、アプリカテゴリは有効になっており、デフォルトで Game に設定されています。
  • androidIsGame が false に設定されている既存のプロジェクトの場合、アプリカテゴリは無効のままになります。

追加リソース