大画面互換性モード

Android では、画面の向きやサイズ変更の制限を宣言するアプリに対して、互換性モードが有効になります。互換性モードを使用すると、大画面デバイスで許容されるアプリの動作が確保されますが、ユーザビリティは最適とはなりません。

アプリごとのオーバーライドを使用すると、デバイス メーカーはアプリの動作を変更して、ユーザー エクスペリエンスを改善したり、大画面でアプリが動作しなくなったりしないようにできます。

互換性に関する一般的な問題

互換性の問題は、主にアプリの向きの制限、サイズ変更やアスペクト比の制限、カメラ プレビューの向きの誤った処理、API の誤用により発生します。

レターボックス表示

レターボックス表示にすると、アプリは画面の中央に配置されます。大画面の場合は、アクセスしやすいように片方の側に寄せて表示されます。使用されていないディスプレイ領域(アプリの側面または上下)にはマット(単色のバーまたはぼかし壁紙)が表示されます。

大画面のデバイスでは、レターボックス表示になることが多くなります。デバイスのディスプレイの寸法やアスペクト比が通常は標準のスマートフォンとは異なりますが、ほとんどのアプリは標準のスマートフォン用に設計されているためです。

図 1. アプリが縦向きに制限されているため、横向きのタブレットや折りたたみ式デバイスではレターボックス表示されます。

問題

画面の向きやアスペクト比が固定されているか、サイズ変更ができないため、アプリが一部のディスプレイ構成をサポートしません。

アプリの向きとサイズ変更を制御する設定としては、たとえば次のものがあります。

  • screenOrientation: アプリの固定の向きを指定します。アプリでは Activity#setRequestedOrientation() を使用して、実行時の向きを設定することもできます。
  • resizeableActivity: システムがさまざまなディメンションのウィンドウに合うようにサイズ変更できるかどうかを示します。Android 11(API レベル 30)以前では、アプリがマルチ ウィンドウ モードをサポートするかどうかを指定します。Android 12(API レベル 31)以降では、アプリが小さい画面(画面幅 600 dp 未満)でマルチウィンドウ モードをサポートするかどうかを指定します。Android 12 以降では、この設定にかかわらず、アプリは大画面(画面幅 600 dp 以上)でのマルチウィンドウ モードをサポートします。
  • maxAspectRatio: アプリがサポートする最大アスペクト比を指定します。maxAspectRatio を設定できるのは、resizeableActivity を false に設定しているアプリのみです。
  • minAspectRatio: アプリがサポートする最小アスペクト比を指定します。minAspectRatio を設定できるのは、resizeableActivity を false に設定しているアプリのみです。

最適化

アプリは、すべてのデバイスとマルチウィンドウ モードのディスプレイの向きとサイズをサポートする必要があります。アプリのレイアウトとアプリのマニフェスト ファイルから、向きと固定アスペクト比の制限をすべて削除してください。詳しくは、各種の画面サイズのサポートをご覧ください。

互換性の対応策

画面の向きやアスペクト比が固定されているアプリが、サイズや画面の向きがアプリで直接サポートされていないウィンドウで実行されている場合、Android では、継続性を維持するためにアプリがレターボックス表示されます。

Android 12(API レベル 31)以降、12L(API レベル 32)を含め、プラットフォームではレターボックス表示のアプリについてさまざまな機能強化が行われています。こうした UI 拡張機能はデバイス メーカーが実装するため、これらの改善点を適用するためにアプリ側で追加の開発作業を行う必要はありません。

Android 12(API レベル 31)では、デバイス メーカーが設定できる以下の外観設定が強化されました。

  • 角丸: アプリ ウィンドウの角が洗練された印象になっています。
  • システムバーの透明度: アプリの上に重なるステータスバーとナビゲーション バーは半透明になり、バーのアイコンがレターボックスの背景の上に常に表示されます。
  • アスペクト比の設定が可能: アプリのアスペクト比を調整して、アプリの外観を改善することができます。

図 2. UI の機能が強化されたレターボックス表示のアプリ

12L(API レベル 32)では、次のような機能が改善されています。

  • 位置の設定が可能: デバイス メーカーは操作性を考慮して、大画面ディスプレイの左右どちら側にもアプリを配置できます。
  • 再起動ボタンのデザイン変更: デバイス メーカーはサイズ互換モードによって、再起動ボタンをユーザーにわかりやすいデザインにすることができます。

Android 13(API レベル 33)では、レターボックス表示されたアプリを画面上に配置する方法や、分割画面モードでのレターボックス表示に関するユーザー向け情報ダイアログが追加されています。

図 3. ユーザー向け情報ダイアログが表示された、レターボックス表示のアプリ。

サイズ互換モード

サイズ互換モードは、再起動コントロールを含むレターボックス表示です。ユーザーはこのコントロールによりアプリを再起動してディスプレイを再描画できます。Android は、サイズ変更不可と判断されたアプリに対して、サイズ互換モードを適用します。ディメンションの互換性がないディスプレイ コンテナにアクティビティが移ると、システムはアプリを再スケーリングして、少なくとも 1 つのディメンションがデバイスのディスプレイに収まるように表示されます。

たとえば、次のようなデバイス設定を変更すると、サイズ互換モードがトリガーされます。

  • デバイスの回転
  • 折りたたみ式デバイスの折りたたみと展開
  • 全画面モードと分割画面モードの切り替え

問題

一般的にサイズ互換モードが適用されるのは、画面の向きまたはアスペクト比が制限され、サイズ変更不可に設定(またはシステムによって決定)されているアクティビティです。

次のいずれかの条件を満たすアプリは、サイズ変更が可能と判断されるため、サイズ互換モードにはなりません。

アプリがこれらの条件のいずれかを満たしていない場合は、サイズ変更不可とみなされ、サイズ互換モードになる可能性があります。

最適化

アプリはすべてのディスプレイ サイズをサポートする必要があります。アプリ マニフェストで <activity> 要素または <application> 要素の android:resizeableActivity 属性を true に設定して、アプリをサイズ変更可能にします。アプリのレスポンシブ / アダプティブ レイアウトを設計します。詳しくは、各種の画面サイズのサポートマルチウィンドウのサポートをご覧ください。

互換性の対応策

Android でアプリがサイズ互換性モードになるのは、アプリを再スケーリングして、少なくとも 1 つのディメンションがディスプレイ ウィンドウに収まるようにすることで、レターボックス アプリの表示を改善できるとシステムで判断された場合です。システムは、アプリのプロセスを再作成する再起動コントロールを表示し、アクティビティを再作成してディスプレイを再描画します。プロセスとスレッドの概要もご覧ください。

ちらつきループ

アプリでサポートされていないディスプレイの向きがある場合、構成の変更時に新しい向きを繰り返しリクエストして無限ループが生じ、ディスプレイがちらついたり、アプリの回転が終わらなくなったりすることがあります。

問題

Android 12(API レベル 31)以降では、デバイス メーカーはアプリが指定した画面の向きの制限を無視し、代わりにその制限を使用して互換モードを起動できるようになりました。たとえば、折りたたみ式デバイスは、デバイスの横向きのタブレット サイズの内部画面でアクティビティが表示される場合、アクティビティの android:screenOrientation="portrait" 設定を無視することがあります。

アプリの向きの制限が無視される場合、アプリは Activity#setRequestedOrientation() を呼び出して画面の向きをプログラムで設定できます。アプリが構成の変更を処理していない場合、この呼び出しによりアプリの再起動がトリガーされます(構成の変更を処理するをご覧ください)。再起動後に、アプリの向きの制限が再度無視され、アプリが setRequestedOrientation() の呼び出しを繰り返し、その呼び出しによってアプリの再起動がトリガーされるという自動継続ループが発生します。

また、デバイスの画面の自然な向き(Android によって判断される通常の向き)が横向きの場合にも、この問題が発生することがあります(アスペクト比が横向きのデバイスで Display#getRotation() を呼び出すと Surface.ROTATION_0 が返されます)。従来、Display.getRotation() = Surface.ROTATION_0 の場合、アプリではデバイスが縦向きになっていると判断されていましたが、Google Pixel Fold の内部画面や一部のタブレットなどでは、そうでない場合もあります。

Google Pixel Fold のインナー ディスプレイで横向きになっているアプリの場合、画面の回転を確認し、ROTATION_0 の値を受け取り、自然な向きが縦向きであると想定し、setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) を呼び出す可能性があります。アプリが(横向きで)再起動すると、画面の回転を再度確認し、ROTATION_0 の値を受け取り、setRequestedOrientation(ActivityInfo.SCREEN_ORIENTATION_PORTRAIT) を呼び出すという無限ループが発生する可能性もあります。

最適化

アプリが以下のことを行わないようにする必要があります。

  • アクティビティの onCreate() メソッドで Activity#setRequestedOrientation() を使用してデフォルトの向きを設定する。構成の未処理の変更により画面の向きのリクエストが予期せずトリガーされる可能性があります。
  • デバイスの自然な向き(ROTATION_0)が縦向きであると想定する
  • 現在のウィンドウ サイズに関係のないシグナルに基づいて向きを設定する。たとえば、Display#getRotation()FoldingFeature の有無、非推奨 API(下記参照)などです。

互換性の対応策

Android は次の場合に Activity#setRequestedOrientation() の呼び出しを無視します。

  • メソッドに対する前回の呼び出しからすでにアクティビティが再開しているか、カメラ互換性による強制回転処理が有効になっている(下記のカメラ プレビューを参照)。

    デバイス メーカーは、OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION を使用してこの動作をアプリに適用できます。

  • アクティビティが 1 秒に 2 回以上、画面の向きのリクエストを行った。これは、ループが発生したことを示しています。Android はループ内の 2 つのリクエストのうち、アプリの表示領域を最大化するリクエストを使用します。

    デバイス メーカーは、OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED を使用してこの動作をアプリに適用できます。

カメラ プレビュー

タブレット、ノートパソコン、折りたたみ式ディスプレイでは、カメラアプリのカメラ プレビュー(またはビューファインダー)がずれたり、歪んだりすることがあります。

問題

Android 互換性定義では、カメラのイメージ センサーの向きは、カメラの長辺と画面の長辺が平行となる向きにしなければならないとされています。

多くのアプリは、デバイスの向きとカメラのセンサーの向きが縦向きであることを前提としています。これは、標準のスマートフォンでは妥当な想定です。しかし、タブレットやノートパソコン、およびそれらのデバイスのカメラセンサーでは自然な向きが横向きであることがあります。また、折りたたみ式などの新しいフォーム ファクタでは、自然な向きが複数存在したり、複数のカメラセンサーで向きが異なることがあります。

アプリが想定しないカメラの向きでアクティビティを開始したり、またはカメラやデバイス画面(折りたたみ式デバイス用)を切り替えると、カメラ プレビューの位置がずれたり、歪んだりすることがあります。

最適化

カメラアプリは、正しく調整、拡大縮小されたカメラ プレビューを表示するために、デバイスの向きとカメラのセンサーの向きを正しく識別して管理する必要があります。アプリは、デバイスの回転、センサーの回転、画面またはウィンドウのアスペクト比を計算し、その結果をカメラ プレビューに適用する必要があります。詳しくは、カメラ プレビューカメラ ビューファインダーの概要をご覧ください。

互換性の対応策

Display#getRotation()Surface.ROTATION_0 を返す場合、デバイスは自然な向きです。システムはデバイスの自然な向きから CameraCharacteristics.SENSOR_ORIENTATION を計算します。Android は、縦向き限定のアプリの縦向きウィンドウを、デバイスの自然な向きに合わせます。ほとんどのアプリではこの処理が想定されています。また、センサーの向きが横向きで、カメラ プレビューが縦向きの場合は、カメラセンサーの画像を切り抜きます。具体的な対応策は次のとおりです。

  • 縦向き限定のアプリでカメラ プレビューを強制的に回転する: 縦向き限定のアプリでは、デバイスの自然な向きとカメラセンサーの向きが縦向きであることを前提としています。ただし、Android 12(API レベル 31)以降では、デバイス メーカーが画面の向きの指定を無視した場合、複数のデバイスの向きでアプリを実行できます。

    縦向き限定のアプリがカメラに接続されている場合、Android はアプリを強制的に回転させて、アプリの縦向きのウィンドウをデバイスの自然な向きに合わせます。

    Google Pixel Tablet では、デバイスの自然な向きに合わせて、縦向きのウィンドウが回転し、縦向きで全画面表示されます。アプリは強制回転後に全画面表示されます。

    Google Pixel Fold の内部画面では、広げた状態の自然な向きに合わせて、縦向き限定のアクティビティが横向きに回転します。強制回転後にアプリがレターボックス表示されます。

  • 内部の前面カメラの切り抜き: Google Pixel Fold の内部の前面カメラセンサーは横向きです。Android では、Google Pixel Fold のインナー ディスプレイでカメラ プレビューを強制的に回転させるほか、内部の全面(横向き)カメラの画角を切り抜いて、センサーがデバイスの向きと反対の視界を捉えるようにします。

  • カメラ プレビューを強制的に更新する: 強制回転後、システムがアクティビティ メソッド onStop() および onStart()(デフォルト)、または onPause() および onResume()(アプリごとの OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE オーバーライドにより適用)を切り替え、カメラ プレビューが適切に表示されるようにします。

  • アスペクト比のスケーリング: 強制回転したカメラ プレビューのアスペクト比が、大きい方の最小アスペクト比となるように動的に変更されます。これにより、カメラ プレビューが適切に拡大縮小されます。

アプリがカメラ プレビューを正しく処理していれば、アプリ デベロッパーはこれらの回避策をオーバーライドできます。下記のアプリごとのオーバーライドをご覧ください。

よく誤用される API

Android でマルチウィンドウ モードなどの機能や折りたたみ式デバイスなどのデバイスのサポートが追加されると、それまでの API は非推奨になり、すべてのディスプレイ サイズとデバイス フォーム ファクタで機能する最新の API に置き換えられます。ただし、下位互換性のため、非推奨の API も引き続き使用できます。

一部の View API は特別な目的のために設計されていますが、この目的をデベロッパーが十分に理解しているとは限りません。

問題

デベロッパーが、非推奨の Display API を引き続き使用し、API がデバイスの表示領域の境界ではなくアプリの境界を返すものと誤った想定をします。また、デベロッパーが一般的なディスプレイの指標を取得するために特別な用途の View API を誤って使用している場合もあります。その結果、アプリ ウィンドウのサイズ変更イベント後に UI 要素を再配置すると計算が不正確になり、レイアウトの問題が発生します。

非推奨でよく誤用される Display API:

詳しくは、マルチウィンドウのサポートをご覧ください。

誤用される View API:

最適化

UI 要素の配置に、物理的なディスプレイ サイズを使用しないでください。WindowMetrics に基づいて、次の WindowManager API などの API にアプリを移行します。

互換性の対応策

2 つのオーバーライドで、非推奨の Display API と誤用された View API を調整し、アプリの境界を返すようにしました(Display API 用の ALWAYS_SANDBOX_DISPLAY_APIS と、View API 用の OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS)。ALWAYS_SANDBOX_DISPLAY_APIS は、サイズ互換モードの対象となるアプリにもデフォルトで適用されます。

透明アクティビティ

透明アクティビティは、透明な背景スタイルの結果です。以下に例を示します。

<style name="Transparent" parent="AppTheme">
    <item name="android:windowIsTranslucent">true</item>
    <item name="android:windowBackground">@android:color/transparent</item>
</style>

Theme.Material.Dialog などのダイアログに関連するテーマには、アクティビティを透明にするスタイルを設定できます。

透明アクティビティは、使用可能なディスプレイ領域をすべてカバーしているわけではありません。そのため、デバイスの回転、デバイスの開閉、マルチウィンドウ モードなどの構成変更に基づいて、利用可能なディスプレイ領域が変化する可能性があるため、大きな画面での処理は困難になる場合があります。

問題

大画面では、透明アクティビティは、タスク アクティビティ スタックで透明アクティビティの下にある最初の不透明アクティビティの境界に従う必要があります。ただし、権限ダイアログを起動する不透明アクティビティは、ダイアログの起動後に消えるトランポリン(他のアクティビティを起動するアクティビティ)である場合があります。そのため、透明アクティビティの下の不透明アクティビティの境界は、システムでは決定できません。

最適化

半透明アクティビティは、タスクのアクティビティ スタック内で、その下にある不透明アクティビティのうち最上位のものから制約を継承します。不透明アクティビティは、半透明アクティビティのライフサイクル(アクティビティの作成から破棄まで)の全体で使用できるようにする必要があります。このため、トランポリン アクティビティから権限のリクエストを開始しないでください。

トランポリン アクティビティが権限のリクエストを開始すると、ユーザーがダイアログに応答できるようになる前にトランポリン アクティビティが破棄されるため、ユーザーに権限ダイアログが表示されないことがあります。

アプリは必ず、ユーザーが権限に関する決定を行うまで表示されたままの状態になっているアクティビティから権限のリクエストを開始する必要があります。

角丸

アクティビティは、半透明テーマを使用するか、使用可能なディスプレイ領域を埋めないことによって、半透明にできます。半透明アクティビティが使用可能なディスプレイ領域を埋める場合、デバイス メーカーにより設定されていれば、システムにより角丸がアクティビティに自動的に適用されます。ただし、使用可能なスペースが半透明アクティビティ(権限ダイアログなど)で埋まらない場合は、角丸を適用するかどうかを判断する必要があります。

使用可能なディスプレイ領域を権限ダイアログが埋めることはありません。このダイアログのレイアウトでは通常、LayoutParams.MATCH_PARENT ではなく LayoutParams.WRAP_CONTENT を使用するためです。

互換性の対応策

ユーザーがダイアログに応答するまで、ダイアログ アクティビティを開始するアクティビティを表示したままにします。

システムにより、透明アクティビティは、アクティビティ スタック内で透明アクティビティの下にある最初の不透明アクティビティから、以下に関連する制約を含むすべての制約を継承するようにします。

  • サイズ互換モード
  • 向き
  • アスペクト比

Unity ゲーム

Unity ゲームは Android 全画面モードまたはマルチウィンドウ モードで動作します。しかし、アプリがマルチウィンドウ モードになっていると、Unity ゲームの多くがフォーカスを喪失し、コンテンツの描画が停止します。

問題

Unity には、Unity 2019.4 以降で Android のマルチウィンドウ モードをサポートする Resizable Window オプションが追加されました。しかし、初期実装はマルチウィンドウ モードでのアクティビティのライフサイクルに正しく反応せず、アプリがフォーカスを喪失したときに UnityPlayer が再生を一時停止していました。プレーヤーにより、黒い画面、またはゲームの最後のフリーズしたフレームがレンダリングされていました。ゲームプレイは、ユーザーが画面をタップした場合にのみ再開されていました。Unity エンジンを使用するアプリの多くがこの問題に直面しており、マルチウィンドウ モードでは黒いウィンドウとしてレンダリングされます。

最適化

Unity を 2019.4.40 以降にアップグレードして、ゲームを再エクスポートします。Android Player 設定Resizable Window オプションをオンにしたままにします。そうしないと、ゲームがマルチウィンドウ モードで完全に表示されている場合でも、フォーカスされていない間はゲームが一時停止します。

互換性の対応策

デバイス メーカーは、アプリごとの OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS オーバーライドを適用して、マルチウィンドウ モードでアプリに疑似フォーカス イベントを提供できます。オーバーライドすると、アクティビティはコンテンツを再描画できるようになり、ブラックアウトされなくなります。

互換性の問題がないかアプリをテストする

アプリをテストして、さまざまなフォーム ファクタでどのように動作するかを確認するには、次のリソースを活用してください。

  • デバイス ストリーミング: Google データセンターでホストされている製品版デバイス(Google Pixel Tablet と Google Pixel Fold など)でアプリをテストする場合は、Android Studio からの Android デバイスのストリーミングをご覧ください。
  • Android Studio Hedgehog での Google Pixel Tablet エミュレータと Google Pixel Fold エミュレータ: Google Pixel Tablet と Google Pixel Fold のエミュレータを作成する方法については、仮想デバイスの作成と管理をご覧ください。
  • Android Studio のサイズ変更可能なエミュレータ: 仮想デバイスへのアクセスについては、Android Emulator 上でアプリを実行するをご覧ください。

レターボックス表示になっているか

各アクティビティが、アプリで使用可能なディスプレイ領域をすべて使用できることを確認してください。まず、テストフォルダで次のコードを宣言します。

Kotlin

fun Activity.isLetterboxed() : Boolean {
    if (isInMultiWindowMode) return false

    val wmc = WindowMetricsCalculator.getOrCreate()
    val currentBounds = wmc.computeCurrentWindowMetrics(this).bounds
    val maxBounds = wmc.computeMaximumWindowMetrics(this).bounds

    val isScreenPortrait = maxBounds.height() > maxBounds.width()

    return if (isScreenPortrait) {
        currentBounds.height() < maxBounds.height()
    } else {
        currentBounds.width() < maxBounds.width()
    }
}

Java

public boolean isLetterboxed(Activity activity) {
    if (activity.isInMultiWindowMode()) {
        return false;
    }

    WindowMetricsCalculator wmc = WindowMetricsCalculator.getOrCreate();
    Rect currentBounds = wmc.computeCurrentWindowMetrics(activity).getBounds()
    Rect maxBounds = wmc.computeMaximumWindowMetrics(activity).getBounds();

    boolean isScreenPortrait = maxBounds.height() > maxBounds.width();

    return (isScreenPortrait)
        ? currentBounds.height() < maxBounds.height()
        : currentBounds.width() < maxBounds.width();
}

次に、テストを実行して動作をアサートし、ターゲット アクティビティがレターボックス表示されていないことを確認します。

Kotlin

@get:Rule
val activityRule = ActivityScenarioRule(MainActivity::class.java)

@Test
fun activity_launched_notLetterBoxed() {
    activityRule.scenario.onActivity {
        assertThat(it.isLetterboxed()).isFalse()
    }
}

Java

@Rule
public ActivityScenarioRule rule = new ActivityScenarioRule<>(MainActivity.class);

public void activity_launched_notLetterBoxed() {
    try (ActivityScenario scenario = ActivityScenario.launch(MainActivity.class)) {
        scenario.onActivity(activity -> {
            assertThat(isLetterboxed(activity)).isFalse();
        });
    }
}

理想的には、この種のテストは合格するまで実行し、アプリのアクティビティがアプリで使用可能なディスプレイ領域全体を使用しているとアサートします。すべてのデバイスタイプでアプリをテストして、動作が一貫していることを確認します。

アプリごとのオーバーライド

Android には、アプリに設定されている動作を変更するオーバーライドが用意されています。たとえば、FORCE_RESIZE_APP のオーバーライドは、アプリ マニフェストで resizeableActivity="false" が設定されている場合でも、サイズ互換モードをバイパスしてディスプレイの寸法に合わせてアプリのサイズを変更するようシステムに指示します。

デバイス メーカーは、特定の大画面デバイスで選択したアプリにオーバーライドを適用します。Android 14(API レベル 34)以降では、ユーザーはデバイスの設定でアプリにオーバーライドを適用できます。

ユーザーによるアプリごとのオーバーライド

Android 14 以降では、ユーザーは設定メニューでアプリのアスペクト比を変更できます。Google Pixel Tablet や Google Pixel Fold などの大画面デバイスにはメニューが実装されています。

メニューには、デバイスにインストールされているすべてのアプリのリストが表示されます。ユーザーがアプリを選択し、そのアプリのアスペクト比を 3:4、1:1、全画面、またはデバイスのメーカーが設定したその他の値に設定します。アスペクト比をアプリのデフォルト(アプリ マニフェストで指定した値)にリセットすることもできます。

アプリで互換性のオーバーライドをオプトアウトするには、次の PackageManager.Property タグを設定します。


  • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE

    ユーザー アスペクト比の互換性オーバーライドを無効にするには、このプロパティをアプリ マニフェストに追加し、値を false に設定します。

    <application>
        <property
            android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_OVERRIDE"
            android:value="false" />
    </application>
    

    アプリはデバイスの設定のアプリのリストから除外されます。ユーザーはアプリのアスペクト比をオーバーライドできません。

    このプロパティを true に設定しても影響はありません。


  • PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE

    ユーザー アスペクト比の互換性オーバーライドの全画面オプションを無効にするには、このプロパティをアプリ マニフェストに追加し、値を false に設定します。

    <application>
        <property
            android:name="android.window.PROPERTY_COMPAT_ALLOW_USER_ASPECT_RATIO_FULLSCREEN_OVERRIDE"
            android:value="false" />
    </application>
    

    デバイス設定のアスペクト比オプションのリストから全画面表示オプションが削除されます。ユーザーは、全画面のオーバーライドをアプリに適用できなくなります。

    このプロパティを true に設定しても影響はありません。

大画面向けにアプリを最適化する: アプリにアスペクト比の制限を設定しないでください。ウィンドウ サイズクラスを使用して、使用可能なディスプレイ スペースの大きさに基づいてさまざまなレイアウトをサポートします。

デバイス メーカーのアプリごとのオーバーライド

デバイス メーカーは、特定のデバイスでアプリごとにオーバーライドを適用します。Google Pixel Tablet と Google Pixel Fold はデフォルトで一部のオーバーライドをさまざまなアプリに適用します。

アプリではほとんどのオーバーライドをオプトアウトできます(下記のアプリごとのオーバーライドの表をご覧ください)。

互換性フレームワークを使用すると、オーバーライドを有効または無効にしてアプリをテストできます(互換性フレームワーク ツールをご覧ください)。有効にすると、オーバーライドがアプリ全体に適用されます。

Android Debug Bridge(adb)を使用して、オーバーライドを有効または無効にしたり、アプリに適用するオーバーライドを確認したりできます。

オーバーライドを有効または無効にする方法は次のとおりです。

adb shell am compat enable/disable <override name/id> <package>

Google Pixel Tablet と Google Pixel Fold の場合、アプリに適用されるオーバーライドを確認してください。

adb shell dumpsys platform_compat | grep <package name>

以下の表に、使用可能なオーバーライドと、アプリがオーバーライドに依存する必要がないようにアプリを最適化する方法のガイダンスを示します。一部のオーバーライドをオプトアウトするには、アプリ マニフェストにプロパティ フラグを追加します。

アプリごとのオーバーライド
タイプ 名前 ID 説明
サイズ変更 FORCE_RESIZE_APP 174042936 構成変更時にアプリのサイズ互換モードをバイパスします。
FORCE_NON_RESIZE_APP 181136395 構成を変更するとアプリを強制的にサイズ互換モードにします。
アスペクト比 OVERRIDE_MIN_ASPECT_RATIO 174042980 他のアスペクト比のオーバーライドを適用するには、ゲートキーパーのオーバーライドを有効にする必要があります。
OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY 203647190 有効(デフォルト)に設定した場合、スコープが縦向き限定のアクティビティにオーバーライドされます。
OVERRIDE_MIN_ASPECT_RATIO_MEDIUM 180326845 最小アスペクト比を 3:2 に変更します。
OVERRIDE_MIN_ASPECT_RATIO_LARGE 180326787 最小アスペクト比を 16:9 に変更します。
OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN 208648326 最小アスペクト比をディスプレイ サイズの 50%(分割画面のアスペクト比)に変更します。
OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN 218959984 最小アスペクト比のオーバーライドを無効にし、デバイスが縦向きのときにアプリが全画面表示されるようにします。
向き OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT 265452344 アクティビティの向きが未定義の場合、向きが縦向きになるようにオーバーライドします。
OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR 265451093 アクティビティの向きが未定義の場合、向きを nosensor(デバイスの自然な向きを使用)にオーバーライドします。
OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE 266124927 横向き限定のアプリを 180 度回転します。
OVERRIDE_ANY_ORIENTATION 265464455 任意の向きのオーバーライドを有効にします。
OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA 265456536 向きのオーバーライドのスコープを、アプリがカメラに接続している場合に限定します。
OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION 255940284 タスクが全画面表示の場合(レターボックス表示の場合も含む)に、ディスプレイを自然な横向きで固定します。
OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION 254631730 回転ループを避けるため、アプリからの向きのリクエストは無視されます。
OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED 273509367 アクティビティが再起動されている間、向きのリクエストの繰り返しを無視します。アプリが 1 秒以内に 2 つ以上の新しい画面の向きをリクエストしたことを Android が検出した場合、システムはこれを回転ループとみなし、オーバーライドを適用します。
OVERRIDE_RESPECT_REQUESTED_ORIENTATION 236283604 画面の向きのリクエスト設定を無視するデバイス メーカーを無効にすることで、レターボックス表示を防止します。
サンドボックス API NEVER_SANDBOX_DISPLAY_APIS 184838306 Display API の動作が変更されないようにします。
ALWAYS_SANDBOX_DISPLAY_APIS 185004937 アプリ内の Display API が強制的にアプリの境界を返すようにします。Display API はディスプレイ領域の境界を返しますが、場合によっては、Display API がアプリの境界を返すものとアプリが想定するため、UI の問題が発生することがあります。
OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS 237531167 アプリで使用される View API が強制的にアプリの境界を返すようにします。View API はディスプレイ領域の境界を返しますが、場合によっては、View API がアプリの境界を返すものとアプリが想定するため、UI の問題が発生することがあります。
カメラ互換性 OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION 263959004 強制回転をオフにします。デフォルトでは、カメラ プレビューが開いているときに、向きが固定されているすべてのカメラアプリが強制的に回転します。
OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH 264304459 カメラ プレビューが強制回転されたときに適用されるデフォルトのハード更新を削除します。
OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE 264301586 カメラ プレビューが強制的に回転されると、ハード更新がソフト更新に切り替わります。これにより、強制回転中の状態を保持できます。デフォルトでは、カメラ プレビューが強制的に回転されると、Android はハード更新を適用します。ハード更新を行うと、以前の状態をキャッシュに保存する方法によっては、特定のアプリが状態を失ったり、停止したりする問題が発生することがあります。
OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT 250678880 内部の前面カメラの画像バッファを切り抜きます。オーバーライドを無効にすると、前面カメラの切り抜きが解除され、カメラ プレビューの視野が広がります。Google Pixel Fold のデフォルトでは、内部の前面カメラを使用している場合、すべてのカメラアプリのカメラ プレビューが切り抜かれます。
その他 OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS 263259275 分割画面モードでアプリがフォーカスを喪失したときにアプリが黒く表示されないようにします。アプリは、フォーカスされてから、アプリのコンテンツを描画します。そのため、アプリはフリーズしたり、黒く表示されることがあります。このオーバーライドにより、Android はアプリに偽のフォーカス イベントを送信して、アプリにコンテンツの描画を再開するようシグナルを送ることができます。

FORCE_RESIZE_APP

オーバーライドが適用されるパッケージを強制的にサイズ変更可能にします。アプリをマルチウィンドウ モードにできるかどうかは変更されませんが、画面のサイズ変更時にサイズ互換モードにならずにアプリのサイズを変更できるようになります。

アプリでオーバーライドと同じ結果を得る方法

アプリ マニフェストで、android:resizeableActivity 属性を true に設定するか、android.supports_size_changes メタデータ フラグを true に設定します(android:resizeableActivity を false に設定してマルチウィンドウ モードを無効にする間のサイズ変更をサポートするため)。

アプリを最適化する方法

レスポンシブ / アダプティブ レイアウトを使用して、アプリがすべての表示サイズとアスペクト比に対応できるようにします。各種の画面サイズのサポートをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用してアプリのサイズを変更可能にするには:

adb shell am compat enable FORCE_RESIZE_APP <package>

オーバーライドを削除するには:

adb shell am compat disable FORCE_RESIZE_APP <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

FORCE_NON_RESIZE_APP

オーバーライドが適用されるパッケージを強制的にサイズ変更できないようにし、構成変更時にサイズ互換モードになります。

アプリでオーバーライドと同じ結果を得る方法

アプリ マニフェストで android:resizeableActivity 属性と android.supports_size_changes メタデータ フラグの両方を false に設定し、向きまたはアスペクト比の制限を宣言します。

アプリを最適化する方法

サイズ変更時に正常に動作するすべてのアプリでは、android:resizeableActivity または android.supports_size_changes が true に設定されています。それ以外のアプリは、サイズ変更時に適切に動作するように改善する必要があります。android:resizeableActivity をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_RESIZEABLE_ACTIVITY_OVERRIDES"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用してアプリのサイズを変更できないようにするには:

adb shell am compat enable FORCE_NON_RESIZE_APP <package>

オーバーライドを削除するには:

adb shell am compat disable FORCE_NON_RESIZE_APP <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO

所定の最小アスペクト比を強制的に適用するすべての変更に対するゲートキーパー。

アプリでオーバーライドと同じ結果を得る方法

アクティビティ レベルまたはアプリレベルで android:minAspectRatio を設定します。

アプリを最適化する方法

アプリにアスペクト比の制限を設定しないでください。アプリが複数の画面サイズをサポートしていることを確認してください。ウィンドウ サイズ クラスを使用すると、アプリの画面上のスペースの大きさに応じてさまざまなレイアウトをサポートできます。Compose WindowSizeClass APIView WindowSizeClass API をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

アスペクト比の制限を指定するか、プロパティ フラグ PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_MIN_ASPECT_RATIO_OVERRIDE"
  android:value="false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

縦向き限定のアクティビティに対して、所定の最小アスペクト比を強制的に適用する処理を制限します。デフォルトで有効です。OVERRIDE_MIN_ASPECT_RATIO も有効になっている場合にのみ効果があります。

アプリでオーバーライドと同じ結果を得る方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

アプリを最適化する方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを調整するプロパティ フラグ

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

アクティビティの最小アスペクト比を中程度の値(3:2)に設定します。

アプリでオーバーライドと同じ結果を得る方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

アプリを最適化する方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを調整するプロパティ フラグ

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_MEDIUM <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO_LARGE

アクティビティの最小アスペクト比を大きな値(16:9)に設定します

アプリでオーバーライドと同じ結果を得る方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

アプリを最適化する方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを調整するプロパティ フラグ

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_LARGE <package>`

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN

分割画面のアスペクト比の使用を有効にします。利用可能なすべてのスペースをアプリが分割画面モードで使用できるようにし、レターボックス表示を回避します。

アプリでオーバーライドと同じ結果を得る方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

アプリを最適化する方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを調整するプロパティ フラグ

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_TO_ALIGN_WITH_SPLIT_SCREEN <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN

利用可能なすべての画面スペースを使用するには、縦向きの全画面表示の最小アスペクト比のオーバーライドを無効にします。

アプリでオーバーライドと同じ結果を得る方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

アプリを最適化する方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドを調整するプロパティ フラグ

OVERRIDE_MIN_ASPECT_RATIO をご覧ください。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_MIN_ASPECT_RATIO_EXCLUDE_PORTRAIT_FULLSCREEN <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT

パッケージ内のすべてのアクティビティに対して縦向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。

アプリでオーバーライドと同じ結果を得る方法

activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation API を使用します。

アプリを最適化する方法

アプリはすべての画面の向きをサポートする必要があります。画面の向きの変更は構成変更であり、システムによるアプリの破棄と再作成を行う、または自分で構成変更を管理するという 2 つの方法のいずれかで行えます。構成の変更を自分で管理する場合は、ViewModel を使用してアプリの状態を保持できます。きわめてまれな例ではありますが、小さなディスプレイでのみ画面の向きをロックすることもできます。ただし、この方法は、ユーザーが必要に応じてアプリを回転できるようにする場合と比べてサイズ調整がうまくいかないことがあります。Android 12L 以降では、固定の画面の向きをデバイス設定でオーバーライドできます。構成変更の処理とすべての画面の向きのサポートについて詳しくは、構成の変更を処理するViewModel の概要スマートフォンではアプリの向きが制限されるが、大画面デバイスでは制限されないをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR

パッケージ内のすべてのアクティビティに対して nosensor の向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。

アプリでオーバーライドと同じ結果を得る方法

activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation API を使用します。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE

パッケージ内のすべてのアクティビティに対して reverseLandscape の向きを有効にします。OVERRIDE_ANY_ORIENTATION が有効になっていない限り、オーバーライドはアクティビティで他の固定の向きが指定されていない場合のみ使用されます。

アプリでオーバーライドと同じ結果を得る方法

activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation API を使用します。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_ANY_ORIENTATION

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAITOVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOROVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE の各オーバーライドが、すべての向きをオーバーライドできるようにします。

アプリでオーバーライドと同じ結果を得る方法

activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation API を使用します。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_ANY_ORIENTATION <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_ANY_ORIENTATION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAITOVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOROVERRIDE_LANDSCAPE_ORIENTATION_TO_REVERSE_LANDSCAPE の各オーバーライドが、カメラの接続が有効な場合のみ実行されるよう限定します。

アプリでオーバーライドと同じ結果を得る方法

activity:screenOrientation マニフェスト属性を設定するか、Activity#setRequestedOrientation API を使用します。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_ORIENTATION_ONLY_FOR_CAMERA <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION

次の条件を満たす場合、ディスプレイの向きを自然な横向きに制限します。

  • アクティビティが全画面表示である
  • オプトアウト コンポーネント プロパティ PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDE が有効になっていない
  • デバイス メーカーがディスプレイに対して画面の向きのリクエストを無視する設定を有効にする
  • ディスプレイの自然な向きが横向きである

アプリでオーバーライドと同じ結果を得る方法

該当なし。この問題はアプリケーション ロジックで解決する必要があります。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_DISPLAY_ORIENTATION_OVERRIDE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_USE_DISPLAY_LANDSCAPE_NATURAL_ORIENTATION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION

アプリの再起動時またはアクティブなカメラ互換処理がある場合に、Activity#setRequestedOrientation() の呼び出しに応じてアプリの向きの更新をスキップする互換性ポリシーを有効にします。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION を true に設定します。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_IGNORE_REQUESTED_ORIENTATION"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_ENABLE_COMPAT_IGNORE_REQUESTED_ORIENTATION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED

アクティビティが固定の向きに対してレターボックス表示されていないときにアプリが 1 秒間に 3 回以上 Activity#setRequestedOrientation() を呼び出した場合に、リクエストされたアプリの向きを無視する互換性ポリシーを有効にします。

アプリでオーバーライドと同じ結果を得る方法

該当なし。この問題はアプリケーション ロジックで解決する必要があります。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_IGNORING_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED"
  android:value="false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_ENABLE_COMPAT_IGNORE_ORIENTATION_REQUEST_WHEN_LOOP_DETECTED <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_RESPECT_REQUESTED_ORIENTATION

デバイス メーカーがディスプレイ領域またはディスプレイ全体で有効にできる画面の向きのリクエスト動作を無視する操作からパッケージを除外します。

アプリでオーバーライドと同じ結果を得る方法

該当なし。この問題はアプリケーション ロジックで解決する必要があります。

アプリを最適化する方法

OVERRIDE_UNDEFINED_ORIENTATION_TO_PORTRAIT をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

オプトアウトはできません。デバイス メーカーが画面の向きのリクエストを無視する設定を有効にしているデバイスにアプリが対応していない場合、オーバーライドを無効にすると危険が生じる可能性があります。オーバーライドを無効にするには、Android デベロッパー リレーションズにお問い合わせください。

オーバーライドを調整するプロパティ フラグ

このオーバーライドにプロパティ フラグはありません。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_RESPECT_REQUESTED_ORIENTATION <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_RESPECT_REQUESTED_ORIENTATION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

NEVER_SANDBOX_DISPLAY_APIS

レターボックス表示またはサイズ互換モードのアクティビティについて、パッケージに Display API サンドボックスが適用されなくなります。Display API は引き続きディスプレイ領域の境界を設定します。

アプリでオーバーライドと同じ結果を得る方法

android:resizeableActivity マニフェスト属性を true に設定するか、android.supports_size_changes メタデータ フラグを true に設定することで、サイズ変更可能なアクティビティを宣言します。

アプリを最適化する方法

アプリが完全にサイズ変更可能であると宣言する場合、表示サイズを使用して UI 要素を配置しないでください。WindowMetrics を提供する最新の API にアプリを移行します。Jetpack Compose を使用している場合は、WindowSizeClass API を利用して、現在のディスプレイ上のアプリの画面領域に基づいて UI を描画します。各種の画面サイズのサポートをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

オプトアウトはできません。非推奨の API から移行してください。

オーバーライドを調整するプロパティ フラグ

このオーバーライドにプロパティ フラグはありません。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable NEVER_SANDBOX_DISPLAY_APIS <package>

オーバーライドを削除するには:

adb shell am compat disable NEVER_SANDBOX_DISPLAY_APIS <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

ALWAYS_SANDBOX_DISPLAY_APIS

ウィンドウ モードに関係なく、適用されるパッケージを常に Display API サンドボックス化します。Display API では常にアプリの境界が設定されます。

アプリでオーバーライドと同じ結果を得る方法

android:resizeableActivity 属性を false に設定するか、android.supports_size_changes メタデータ フラグを false に設定することで、サイズ変更できないアクティビティを宣言します。

アプリを最適化する方法

アプリが完全にサイズ変更可能であると宣言する場合、表示サイズを使用して UI 要素を配置しないでください。非推奨の API から、WindowMetrics を提供する最新の API にアプリを移行します。WindowMetricsCalculator をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

オプトアウトはできません。非推奨の API から移行してください。

オーバーライドを調整するプロパティ フラグ

このオーバーライドにプロパティ フラグはありません。

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable ALWAYS_SANDBOX_DISPLAY_APIS <package>

オーバーライドを削除するには:

adb shell am compat disable ALWAYS_SANDBOX_DISPLAY_APIS <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS

パッケージが次の View API をアクティビティの境界でサンドボックス化するよう設定します。

アプリでオーバーライドと同じ結果を得る方法

アプリケーション コードの問題を解決するには、デバイス ディスプレイの境界とデバイス ディスプレイに対する相対オフセットではなく、アプリ ウィンドウの境界とアプリ ウィンドウに対する相対オフセットを提供する API を使用します。

アプリを最適化する方法

アプリでは、レターボックス表示とマルチウィンドウ モードがアプリに適用される可能性を考慮し、View API を使用する必要があります。詳しくは WindowMetricsCalculator をご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ALLOW_SANDBOXING_VIEW_BOUNDS_APIS を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ALLOW_SANDBOXING_VIEW_BOUNDS_APIS"
  android:value="false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_SANDBOX_VIEW_BOUNDS_APIS <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION

強制回転を無効にします。一部のアプリでユーザー エクスペリエンスが向上します。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION を false に設定します。

アプリを最適化する方法

キャッシュされたカメラセンサーの向きやデバイス情報を使用しないでください。カメラの互換性に関するガイドについては、カメラ ビューファインダーの概要カメラアプリでサイズ変更可能なサーフェスをサポートするをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION を true に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ALLOW_FORCE_ROTATION"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用して、強制回転を解除するには:

adb shell am compat enable OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION <package>

オーバーライドを解除して、強制回転を発生させるには:

adb shell am compat disable OVERRIDE_CAMERA_COMPAT_DISABLE_FORCE_ROTATION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH

強制回転後にアクティビティの更新を無効にします。更新が原因で状態が喪失した場合のアプリのユーザー エクスペリエンスが改善されます。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH を false に設定します。

アプリを最適化する方法

キャッシュされたカメラセンサーの向きやデバイス情報を使用しないでください。カメラの互換性に関するガイドについては、カメラ ビューファインダーの概要カメラアプリでサイズ変更可能なサーフェスをサポートするをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH を true に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ALLOW_REFRESH"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用して、アクティビティの更新を解除するには:

adb shell am compat enable OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH <package>

オーバーライドを解除して、アクティビティの更新を許可するには:

adb shell am compat disable OVERRIDE_CAMERA_COMPAT_DISABLE_REFRESH <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE

適用先のパッケージが、カメラ互換強制回転の後、onResume()onPause()onResume() ではなく、onResume()onStop()onResume() のサイクルでアクティビティの更新を実行するよう設定します。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE を true に設定します。

アプリを最適化する方法

キャッシュされたカメラセンサーの向きやデバイス情報を使用しないでください。カメラの互換性に関するガイドについては、カメラ ビューファインダーの概要カメラアプリでサイズ変更可能なサーフェスをサポートするをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_CAMERA_COMPAT_ENABLE_REFRESH_VIA_PAUSE <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT

カメラの縦向きがデバイスの自然な向きと一致しない場合、カメラの出力が反対方向に切り抜かれます。多くのアプリはこの状況に対処せず、引き伸ばされた画像を表示します。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT を true に設定します。

アプリを最適化する方法

キャッシュされたカメラセンサーの向きやデバイス情報を使用しないでください。カメラの互換性に関するガイドについては、カメラ ビューファインダーの概要カメラアプリでサイズ変更可能なサーフェスをサポートするをご覧ください。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.camera.PROPERTY_COMPAT_OVERRIDE_LANDSCAPE_TO_PORTRAIT"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用して、内部の前面カメラの切り抜きを適用するには:

adb shell am compat enable OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT <package>

オーバーライドを解除して、内部の前面カメラの切り抜きを解除するには:

adb shell am compat disable OVERRIDE_CAMERA_LANDSCAPE_TO_PORTRAIT <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION(オーバーライドが無効)

アプリがアプリの画面共有を無効にできないようにします(メディア プロジェクションをご覧ください)。アプリが createConfigForDefaultDisplay() API を誤用して強制的に全画面表示のキャプチャを行い、通知の内容(アプリの画面共有ではなく全画面でキャプチャされる)と、ウィンドウ モードに関係なく、すべてのアプリを公開することでユーザーのプライバシーを危険にさらした場合に実装されます。

アプリでオーバーライドと同じ結果を得る方法

デフォルトのメディア プロジェクション動作(createScreenCaptureIntent() により Android 14、API レベル 34 で実装)を許可します。これにより、ユーザーはウィンドウ モードに関係なく、全画面表示と 1 つのアプリ ウィンドウのどちらを共有するかを決定できます。または、createConfigForUserChoice() の呼び出しで返された MediaProjectionConfig 引数を指定して createScreenCaptureIntent(MediaProjectionConfig) を呼び出します。

アプリを最適化する方法

メディア プロジェクション中にデバイス画面全体を共有するか、アプリ ウィンドウを共有するかを選択できるようにします(Android 14 ではデフォルトの動作)。

マルチ ウィンドウ モードをサポートするには、アプリをサイズ変更可能にします(resizeableActivity="true")。

オーバーライドを無効化またはオプトアウトする方法

ユーザーのプライバシーは重要であるため、アプリでこのオーバーライドを無効にしたり無効にしたりすることはできません。

オーバーライドを調整するプロパティ フラグ

なし。

オーバーライドをテストする adb コマンド

オーバーライドを適用して、部分的な画面共有をアプリで無効にする(つまり、部分的な画面共有を有効にする)には:

adb shell am compat enable OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION <package>

オーバーライドを解除して、アプリで部分的画面共有をオプトアウトするには:

adb shell am compat disable OVERRIDE_DISABLE_MEDIA_PROJECTION_SINGLE_APP_OPTION <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS

分割画面モードで、フォーカスされていないアプリに対して偽のフォーカスを送信できるようになります。一部のゲームエンジンは、アプリのコンテンツを描画する前にフォーカスの取得を待機します。偽のフォーカスは、アプリが再開し、まだフォーカスされていない場合に、アプリが黒く塗りつぶされた状態にならないようにするのに役立ちます。

アプリでオーバーライドと同じ結果を得る方法

プロパティ フラグ PROPERTY_COMPAT_ENABLE_FAKE_FOCUS を true に設定します。

アプリを最適化する方法

アプリで複数の画面の向きと構成の変更を適切に処理できる場合は、この問題を回避できます。大画面のアプリの品質に関するガイドラインに沿って、アプリを大画面に対応させます。

Unity ゲームエンジンを実行している場合は、バージョン 2019.4.40 以降にアップグレードして、ゲームを再エクスポートしてください。Android Player 設定で Resizable Window オプションをオンのままにします。

オーバーライドを無効化またはオプトアウトする方法

プロパティ フラグ PROPERTY_COMPAT_ENABLE_FAKE_FOCUS を false に設定します。

オーバーライドを調整するプロパティ フラグ

<property android:name="android.window.PROPERTY_COMPAT_ENABLE_FAKE_FOCUS"
  android:value="true|false"/>

オーバーライドをテストする adb コマンド

オーバーライドを適用するには:

adb shell am compat enable OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS <package>

オーバーライドを削除するには:

adb shell am compat disable OVERRIDE_ENABLE_COMPAT_FAKE_FOCUS <package>

注: これらのコマンドによるオーバーライドの適用や削除はあくまで一時的なものです。

参考情報