INDIE INDEX

レベル:入門

スマホのノッチでUIが隠れる|UnityとGodotのセーフエリア

公開 2026-11-03更新 2026-11-03

一部のディスプレイでは画面の一部の領域がユーザーに見えないことがあるので、Unity では Screen.safeArea の矩形の外の領域に UI の要素を置くのを避けます。Android 15(API レベル 35)以降では Android Player settings の Render outside safe area が効かず、Screen.safeArea は切り欠きを除いた範囲になります。Godot では DisplayServer の get_display_safe_area() が、操作用の部品が描画されるべき、隠されていない領域を返し、現在は Android と iOS だけで実装されています。

このページの目次
  1. セーフエリアと切り欠きの値
  2. Unity の Render outside safe area
  3. Android の端から端までの表示
  4. Unity で値を確かめる手順
  5. Godot で値を確かめる手順
  6. 縦持ちと横持ちの図
  7. 失敗を避ける注意
  8. 次に読む
  9. 情報源

セーフエリアと切り欠きの値

Unity と Godot で、セーフエリアや切り欠きを返す値には、たとえば次のものがあります。

Unity と Godot のセーフエリアと切り欠きの値

項目内容
Unity(6000.6)の Screen.safeArea型は Rect です。セーフエリアをピクセルで返します(読み取り専用)。最大の大きさは画面の解像度(ピクセル)で、Rect(0, 0, Screen.width, Screen.height) として定義されています。原点は画面の左下です。アプリのウィンドウに対する値で、物理的なデバイスの画面に対する値ではありません。
Unity(6000.6)の Screen.cutouts型は Rect[] です。コンテンツを表示しない画面の領域の一覧を返します(読み取り専用)。これらの領域は、ピクセルで表した Rect 構造体です。
Godot(stable)の DisplayServer の get_display_safe_area()戻り値は Rect2i です。操作用の部品が描画されるべき、隠されていないディスプレイの領域を返します。現在は Android と iOS だけで実装されています。ほかのプラットフォームでは、フォールバックとして screen_get_usable_rect(SCREEN_OF_MAIN_WINDOW) が返されます。
Godot(stable)の DisplayServer の get_display_cutouts()戻り値は Rect2 の配列(Array[Rect2])です。それぞれが、ディスプレイの切り欠きまたはノッチを囲む矩形で、カメラやセンサーが使う、端から端までの画面にある、機能しない領域です。切り欠きがないデバイスでは、空の配列を返します。現在は Android だけで実装されていて、ほかのプラットフォームは、切り欠きやノッチがあっても空の配列を返します。
表1

Unity の Render outside safe area

Unity の Android Player settings にある Render outside safe area は、有効にすると、切り欠き(ノッチ)にあたる領域を含む、使える画面の領域全体にアプリが描画するのを許す設定です。この設定の挙動は、Android のバージョンで変わります。

Render outside safe area の Android のバージョンごとの違い

Android のバージョン有効にしたとき無効にしたとき
Android 15 以降この設定は効きません。アプリは既定で画面の領域全体を使います。この設定は効きません。アプリは既定で画面の領域全体を使います。
Android 11 から 14アプリは、使える画面の領域全体を使います。アプリは、切り欠きの周りの領域を、システムバー(デバイスの上または下)の内側にある場合だけ使います。そうでない場合は、切り欠きの領域に黒い帯を表示します。
Android 10 以前アプリは、デバイスの短い辺(上または下など)にある切り欠きの周りの領域を使います。ただし、デバイスの長い辺(側面など)にある切り欠きは、黒い帯でふさぎます。アプリは、切り欠きの周りの領域を、システムバーの内側にある場合だけ使います。そうでない場合は、切り欠きの領域に黒い帯を表示します。
表2

Android の端から端までの表示

Android の端から端まで(エッジ ツー エッジ)の表示で適用されるインセットの種類には、たとえば次のものがあります。

Android の端から端までの表示のインセット

インセット内容
システムバー インセットシステムバーには、ステータスバー・キャプション バー・ナビゲーション バーが含まれます。タップできて、システムバーによって視覚的に隠れてはならないビューに使います。
ディスプレイ カットアウト インセットデバイスの形状により、画面のカットアウトが発生する可能性がある領域です。
表3

ディスプレイ カットアウトは、一部のデバイスにだけあります。ふつうは画面の上の辺にあって、ステータスバーの中に収まります。画面を横向きにしたデバイスでは、縦の辺の側に来ることがあります。既定の状態では、アプリの描画はディスプレイ カットアウトの部分にも及びます。

Android 15 以降のデバイスでは、SDK 35 以降をターゲットにしたアプリのエッジ ツー エッジが自動的に有効になります。

Unity で値を確かめる手順

  1. Android Player settings の Render outside safe area が有効か無効かを見ます。Android 15 以降では、この設定は効きません。
  2. Screen.safeArea と Screen.cutouts の値を、画面に表示するテキストに出します。どちらも読み取り専用で、単位はピクセルです。
  3. 端末の向きを縦と横に変えて、それぞれで2つの値を見比べます。
  4. UI Toolkit のような、原点が左上にある UI の仕組みで Screen.safeArea か Screen.cutouts を使うときは、座標を反転させる必要があります。Screen.safeArea の場合は、次のコードの断片の形です。
var safeAreaForUIToolkit = new Rect(Screen.safeArea.x, Screen.height - Screen.safeArea.y, Screen.safeArea.width, Screen.safeArea.height);

Godot で値を確かめる手順

  1. DisplayServer の get_display_safe_area() と DisplayServer の get_display_cutouts() の戻り値を、画面に表示するテキストに出します。前者は Rect2i で、後者は Rect2 の配列です。
  2. Android か iOS の実機で、2つの値を見ます。get_display_safe_area() は Android と iOS で実装されていて、get_display_cutouts() は Android だけで実装されています。
  3. 操作用の部品の位置と大きさを、get_display_safe_area() が返した矩形の内側に収めます。この矩形は、操作用の部品が描画されるべき、隠されていない領域です。

縦持ちと横持ちの図

画面全体・切り欠き・セーフエリアの3つの四角を、縦持ちと横持ちで重ねた図です。

縦持ちと横持ちの図。灰色の四角が画面全体、赤い四角が切り欠き、緑の点線の四角がセーフエリアで、縦持ちでは上の辺の真ん中に、横持ちでは左の辺の真ん中に切り欠きがあり、セーフエリアは切り欠きの部分を含まない。左下の青い点は原点

失敗を避ける注意

Android 15(API レベル 35)以降では、Render outside safe area が効きません。アプリは常に切り欠き(ノッチ)にあたる領域に描画するので、Screen.safeArea は切り欠きを除いた範囲になります。重要な UI の要素と、操作する UI の要素の位置には、Screen.safeArea を使います。

Android 14(API レベル 34)以前で Render outside safe area を無効にしているときは、Unity がアプリのウィンドウをデバイスのセーフエリアに合わせて小さくします。ウィンドウに安全でない領域が含まれなくなるので、返される Rect は、通常は Rect(0, 0, Screen.width, Screen.height) と等しくなります。

Screen.safeArea は、アプリのウィンドウに対する値で、物理的なデバイスの画面に対する値ではありません。

Godot の get_display_cutouts() は、Android 以外のプラットフォームでは、切り欠きやノッチがあっても空の配列を返します。get_display_safe_area() が実装されているのは Android と iOS だけで、ほかのプラットフォームでは screen_get_usable_rect(SCREEN_OF_MAIN_WINDOW) が返されます。

Android 15(API レベル 35)以降では、SDK 35 をターゲットにしたアプリにエッジ ツー エッジが適用されます。まだエッジ ツー エッジに対応していないアプリは、一部が隠れる可能性があるので、インセットの処理が要ります。アプリによって、この作業が重要になることも、ならないこともあります。

次に読む

Android 向けの書き出しと署名の手順は、Androidに書き出す|UnityとGodotの署名とAABにあります。

情報源

このページに出た言葉

このページの内容の誤りは、問い合わせの窓口で受け付けています。