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

ディスプレイカットアウトをサポートする

ディスプレイカットアウトは一部のデバイス上の領域です。表示面まで延びる形状です。エッジツーエッジのエクスペリエンスが可能になるデバイスの前面に重要なセンサーのスペースを確保します。

Android は、Android 9（API レベル 28）を搭載したデバイスでディスプレイカットアウトをサポートします。高くなります。ただし、デバイスメーカーはディスプレイカットアウトを Android 8.1 以前を搭載したデバイス

このドキュメントでは、カットアウトのあるデバイスのサポートを実装する方法について説明します。 カットアウト領域、つまりエッジツーエッジのエッジツーエッジのカットアウトを含むディスプレイ面上の長方形。

上部中央のディスプレイカットアウトの例を示す画像 — **図 1.** 1 ディスプレイカットアウト

アプリでのカットアウト領域の処理方法を選択する

コンテンツがカットアウト領域と重ならないようにする場合は、コンテンツがステータスバーやアクセスできます。カットアウト領域にレンダリングする場合は、 WindowInsetsCompat.getDisplayCutout() DisplayCutout オブジェクトを取得する場合。（各カットアウトの安全なインセットと境界ボックスを含む）を作成します。これらの API を使用すると、コンテンツがカットアウトと重なっていないか必要に応じて配置を変更します。

また、コンテンツがカットアウト領域の背後に配置されるかどうかも指定できます。「 layoutInDisplayCutoutMode ウィンドウレイアウト属性は、カットアウト領域にコンテンツを描画する方法を制御します。 layoutInDisplayCutoutMode は次のいずれかの値に設定できます。

LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT: ディスプレイカットアウトが表示されます。それ以外の場合は、ウィンドウがディスプレイカットアウトと重ならない。たとえば、横向き表示ではコンテンツがレターボックス表示されます。条件アプリが SDK 35 をターゲットとしている場合、非フローティングの場合は ALWAYS と解釈されます。表示されます。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS: コンテンツは常にカットアウト領域にまで拡張できます。アプリが Android 15 デバイスで実行されている場合、このモードのみが非フローティングウィンドウにすることをおすすめします。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES: コンテンツは、縦向きと横向きの両方でカットアウト領域にレンダリングされます。すべきでないこと使用することもできますSDK 35 をターゲットとするアプリの場合、これは次のように解釈されます。非フローティングウィンドウの場合は ALWAYS。
LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER: コンテンツがカットアウト領域にレンダリングされることはありません。SDK 35 をターゲットとするアプリの場合、次のようになります。非フローティングウィンドウでは ALWAYS と解釈されます。

カットアウトモードは、プログラムで設定するか、スタイルを定義します。次のこの例では、LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES を適用するスタイルを定義しています。アクティビティに割り当てられます。

<style name="ActivityTheme">
  <item name="android:windowLayoutInDisplayCutoutMode">
    shortEdges <!-- default, shortEdges, or never -->
  </item>
</style>

以降のセクションでは、さまざまなカットアウトモードについて詳しく説明します。

デフォルトの動作

SDK 35 をターゲットとするアプリが Android 15 デバイスで実行されている場合、 LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS がデフォルトの動作です。 LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT は次のように解釈されます。非フローティングウィンドウの場合は LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。

それ以外の場合は、LAYOUT_IN_DISPLAY_CUTOUT_MODE_DEFAULT がデフォルトです。

短い辺のカットアウト領域にコンテンツをレンダリングする

SDK 35 をターゲットとするアプリが Android 15 デバイスで実行されている場合、 LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES は次のように解釈されます。非フローティングウィンドウの場合は LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。

LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES を使用すると、コンテンツがディスプレイの短辺のカットアウト領域まで広がる縦向き、横向き（システムバーが非表示か、または非表示かは関係ありません）表示されます。このモードを使用する場合は、重要なコンテンツが他の画面と重ならないようにしてくださいカットアウト領域を追加します

次の図は、LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES の例です。縦向きのデバイスの場合:

ポートレートモードで、コンテンツがカットアウト領域にレンダリングされている様子を示す画像 — **図 2.** カットアウト領域にコンテンツをレンダリングするポートレートモードで使用できます

次の図は、LAYOUT_IN_DISPLAY_CUTOUT_MODE_SHORT_EDGES の例です。横向きのデバイスの場合:

横表示でカットアウト領域にコンテンツがレンダリングされる様子を示す画像 — **図 3.** カットアウト領域にコンテンツをレンダリングするクリックします

このモードでは、ディスプレイの短辺のカットアウトの下にウィンドウが拡張されますビューが非表示になっているかどうかに関係なく、表示されます。

隅のカットアウトは短辺にあるとみなされます。

隅にカットアウトがあるデバイスの画像 — **図 4.** 隅にカットアウトがあるデバイス。

コンテンツをディスプレイカットアウト領域にレンダリングしない

SDK 35 をターゲットとするアプリが Android 15 デバイスで実行されている場合、 LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER は次のように解釈されます。非フローティングウィンドウの場合は LAYOUT_IN_DISPLAY_CUTOUT_MODE_ALWAYS。

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER では、ウィンドウに次の処理が許可されることはありません。カットアウト領域と重なっています

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER の例を次に示します。縦向き:

縦向きの LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER を示す画像 — **図 5.** 例: 縦表示の場合は `LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER`。

LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER の例を次に示します。横表示:

横向きの LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER を示す画像 — **図 6.** 例: 横表示の`LAYOUT_IN_DISPLAY_CUTOUT_MODE_NEVER`。

ディスプレイカットアウトのサポートに関するベストプラクティス

ディスプレイカットアウトを使用する場合は、次の点を考慮してください。

UI の重要な要素の配置に注意してください。お客様のカットアウト領域を使うと、重要なテキスト、コントロール、その他の情報が見えにくくなります。
微調整が必要なインタラクティブな要素を配置または拡張しないカットアウト領域に認識されます設定によっては、タップの感度がカットアウト領域を指定します
可能な場合は、 WindowInsetsCompat～ステータスバーの高さを取得し、適用する適切なパディングを決定する追加できますステータスバーの高さをハードコードしないようにしてください。ハードコードすると、コンテンツの重複やカットオフが発生します
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph> 図 7.WindowInsetsCompat の用途コンテンツの重複や途切れを防ぎます
View.getLocationInWindow() を使用するアプリが使用しているウィンドウスペースのサイズを判定します。アプリが使用しないでください。また、使用しないでください。 View.getLocationOnScreen()。
アプリで必要な場合は、always、shortEdges、または never のカットアウトモードを使用する没入モードへの切り替えと切り替えデフォルトのカットアウト動作では、アプリのコンテンツをカットアウト領域にレンダリングし、システムバーが表示されますが、没入モードでは表示されなくなります。その結果、コンテンツのおよびダウンさせることもできます。
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph> 図 8.上下に移動するコンテンツの例おすすめします。
没入モードでは、ウィンドウ座標と画面座標を使用する際は注意が必要です。以下のためです。レターボックス表示されたときに画面全体は使用されません。なぜなら、レターボックス表示、画面の原点からの座標と座標が一致しない指定することもできます。画面の座標をビューの必要に応じて getLocationOnScreen() を使用します。次の画像は、コンテンツがレターボックス表示されるときの座標の違いを示しています。
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph> 図 9.ウィンドウ座標とスクリーン座標のレターボックス表示されます。
MotionEvent を処理する場合は、次のコマンドを使用します。 MotionEvent.getX() および回避: MotionEvent.getY() 生じることがあります。使用しない MotionEvent.getRawX() または MotionEvent.getRawY()。

コンテンツのレンダリング方法をテストする

アプリの画面とエクスペリエンスのすべてをテストします。異なるバージョンのデバイスでテストする可能であれば複数のカットアウトタイプを選びますカットアウトのあるデバイスをお持ちでない場合は、 Android を実行しているデバイスやエミュレータで、一般的なカットアウト構成をシミュレートする次の手順を実施します。

[開発者向けオプション] を有効にします。
[開発者向けオプション] 画面で、[図形描画] まで下にスクロールします。 [カットアウトでディスプレイをシミュレート] を選択します。
カットアウトのタイプを選択します。
<ph type="x-smartling-placeholder">
</ph> <ph type="x-smartling-placeholder">
</ph> 図 10.開発者向けオプションを使用して表示されます。

ディスプレイ カットアウトをサポートする