大画面互換性モード

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

アプリごとのオーバーライドを使用すると、デバイスの相手先ブランド製品製造企業（OEM）はアプリの動作を変更して、ユーザーエクスペリエンスを改善したり、大画面でアプリが動作しなくなったりしないようにできます。

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

互換性の問題は、主にアプリの向きの制限、サイズ変更やアスペクト比の制限、カメラプレビューの向きの誤った処理、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 つのディメンションがデバイスのディスプレイに収まるように表示されます。

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

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

問題

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

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

resizeableActivity="true" でサイズ変更が可能である
ピクチャーインピクチャー（PIP）モードをサポートしている
埋め込まれている
アプリごとの FORCE_RESIZE_APP オーバーライドがデバイスのメーカーにより適用されている（アプリが設定したプロパティは無視されます）

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

マルチウィンドウモードで、サイズ変更できないアプリがクラッシュします。

最適化

アプリはすべてのディスプレイサイズをサポートする必要があります。アプリマニフェストで <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) を呼び出すという無限ループが発生する可能性もあります。

横向き専用のアプリを縦向きで表示すると、`Activity#setRequestedOrientation()` が繰り返し呼び出されます。

最適化

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

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

アプリは構成の変更を処理し、画面の向きの制限がないため、ちらつきループに陥ることはありません。

互換性の対応策

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

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

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

OEM は、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 Tablet - 縦向き限定のアプリが強制的に回転されます。

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

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:

非推奨の API がアプリの境界を誤って計算し、アプリのコンテンツが画面外に出てしまいます。

最適化

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

プラットフォーム:
- getCurrentWindowMetrics()
- getMaximumWindowMetrics()
Jetpack:
- WindowMetricsCalculator#computeCurrentWindowMetrics()
- WindowMetricsCalculator#computeMaximumWindowMetrics()

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 オプションをオンにしたままにします。そうしないと、ゲームがマルチウィンドウモードで完全に表示されている場合でも、フォーカスされていない間はゲームが一時停止します。

フォーカスされていない場合でも、ゲームがマルチウィンドウモードでコンテンツを正しくレンダリングします。

互換性の対応策

OEM は、アプリごとの 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" が設定されている場合でも、サイズ互換モードをバイパスするようシステムに指示します。

OEM は、特定の大画面デバイスでアプリごとにオーバーライドを適用します。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	画面の向きのリクエストを無視する OEM 設定を無効にすることにより、レターボックス表示されないようにします。
サンドボックス 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 API と View 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 も有効になっている場合にのみ効果があります。

オーバーライドをテストする 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_PORTRAIT、OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR、OVERRIDE_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_PORTRAIT、OVERRIDE_UNDEFINED_ORIENTATION_TO_NOSENSOR、OVERRIDE_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 が有効になっていない
ディスプレイの画面の向きのリクエストを無視する OEM 設定が有効である
ディスプレイの自然な向きが横向きである

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

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

アプリを最適化する方法

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 をご覧ください。

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

オプトアウトはできません。画面の向きのリクエストを無効にする OEM 設定が有効になっているデバイスにアプリが対応していない場合、オーバーライドを無効にすると危険が生じる可能性があります。オーバーライドを無効にするには、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_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>

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

参考情報

大画面のアプリの品質に関するガイドライン
アプリの中核品質に関するガイドライン

大画面互換性モード

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

レターボックス表示

問題

アプリが縦向きに制限されているため、横向きのデバイスでは使用できません。

最適化

アプリはデバイスのすべての向きをサポートします。

互換性の対応策

サイズ互換モード

問題

マルチウィンドウ モードで、サイズ変更できないアプリがクラッシュします。

最適化

アプリがすべてのウィンドウ サイズで動作します。

互換性の対応策

縦向き専用のアプリが横向きでレターボックス表示され、再起動コントロールにより再スケーリングされています。

ちらつきループ

問題

横向き専用のアプリを縦向きで表示すると、Activity#setRequestedOrientation() が繰り返し呼び出されます。

最適化

アプリは構成の変更を処理し、画面の向きの制限がないため、ちらつきループに陥ることはありません。

互換性の対応策

カメラ プレビュー

問題

大画面の折りたたみ式デバイスで、カメラ プレビューの位置がずれたり、歪んだりします。

最適化

デバイスのすべての向きで、カメラ プレビューが正しく調整され、拡大縮小されます。

互換性の対応策

Google Pixel Tablet - 縦向き限定のアプリが強制的に回転されます。

Google Pixel Fold - 縦向き限定のアプリが強制的に回転されます。また、アプリはレターボックス表示になります。

よく誤用される API

問題

非推奨の API がアプリの境界を誤って計算し、アプリのコンテンツが画面外に出てしまいます。

最適化

API はアプリ ウィンドウの指標を正しく計算します。

互換性の対応策

透明アクティビティ

問題

透明な起動アクティビティ（トランポリン）のためにダイアログの位置がずれています。

最適化

角丸

角丸が設定された起動アクティビティの上にダイアログが正しく配置されています。

互換性の対応策

Unity ゲーム

問題

ゲームがマルチウィンドウ モードでフォーカスを喪失し、黒いウィンドウとしてレンダリングされます。

最適化

フォーカスされていない場合でも、ゲームがマルチウィンドウ モードでコンテンツを正しくレンダリングします。

互換性の対応策

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

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

Kotlin

Java

Kotlin

Java

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

FORCE_RESIZE_APP

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

アプリを最適化する方法

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

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

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

FORCE_NON_RESIZE_APP

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

アプリを最適化する方法

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

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

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

OVERRIDE_MIN_ASPECT_RATIO

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

アプリを最適化する方法

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

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

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

OVERRIDE_MIN_ASPECT_RATIO_PORTRAIT_ONLY

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

アプリを最適化する方法

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

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

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

OVERRIDE_MIN_ASPECT_RATIO_MEDIUM

マルチウィンドウモードで、サイズ変更できないアプリがクラッシュします。

アプリがすべてのウィンドウサイズで動作します。

横向き専用のアプリを縦向きで表示すると、`Activity#setRequestedOrientation()` が繰り返し呼び出されます。

カメラプレビュー

大画面の折りたたみ式デバイスで、カメラプレビューの位置がずれたり、歪んだりします。

デバイスのすべての向きで、カメラプレビューが正しく調整され、拡大縮小されます。

API はアプリウィンドウの指標を正しく計算します。

ゲームがマルチウィンドウモードでフォーカスを喪失し、黒いウィンドウとしてレンダリングされます。

フォーカスされていない場合でも、ゲームがマルチウィンドウモードでコンテンツを正しくレンダリングします。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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