ドキュメント

Unity Engine

Unity Engine

iOS Scripting

iOS 用のスクリプトを理解します。
読み終わるまでの所要時間 20 分最終更新 5日前

iOS デバイスのほとんどの機能は、入力クラスとハンドヘルドクラスで公開されています。クロスプラットフォームプロジェクトでは、iOS 固有の C# コードを条件付きでコンパイルするために Unity_IPHONE が定義されます。

デバイス プロパティ

アクセスできるデバイス固有のプロパティが多数あります。次のスクリプト リファレンス ページを参照してください。

海賊版チェック

アプリケーションをハッキングする一般的な方法は、AppStore DRM保護を解除してから、そのアプリケーションを無料で再配布することです。Unityの海賊版チェックを使用して、AppStoreへの提出後にアプリケーションが変更されたかどうかを確認します。
application.genuine プロパティを使用して、アプリケーションが本物 (ハッキングされていない) かどうかを確認します。プロパティに
false
が返された場合は、ハッキングされたアプリを使用していることをユーザーに警告したり、特定の機能を使用不可にしたりできます。
注
application.genuineCheckAvailable を
Application.genuine
とともに使用して、アプリケーション整合性を検証します。application.genuine プロパティへのアクセスはリソースに負荷がかかる操作であるため、フレームの更新やその他のタイムクリティカルなコードでは実行しないでください。

振動サポート

ハンドヘルド.Vibrate を呼び出すことでバイブレーションをトリガーできます。バイブレーション ハードウェアのないデバイスでは、このコールは無視されます。

アクティビティインジケーター

モバイルオペレーティングシステムにはビルトインのアクティビティインジケーターがあり、処理に時間がかかるときに使用できます。例については、 ハンドヘルド.StartActivityIndicator ドキュメントを参照してください。

画面方向

iOS デバイスと Android デバイスの両方でアプリケーションの画面の向きをコントロールできます。向きの変化を検出したり、特定の向きを強制したりすることで、ユーザーのデバイスの持ち方に応じたアプリ動作を作成できます。
デバイスの向きを取得するには、 screen.orientation プロパティにアクセスします。向きは以下のいずれかになります。

orientation:

動作

Portrait (縦向き)デバイスは縦向きモードです。デバイスは直立状態で、ホームボタンは下部にあります。
PortraitUpsideDownデバイスは縦向きモードですが、デバイスを直立させ、ホームボタンを上にして上下逆さまにしています。
LandscapeLeftデバイスはランドスケープモードです。デバイスは直立状態で、ホームボタンは右側にあります。
LandscapeRightデバイスはランドスケープモードで、デバイスは直立状態でホームボタンは左側にあります。
screen.orientation を上記のいずれかの向きに設定するか、ScreenOrientation.AutoRotation を使用して画面の向きをコントロールします。自動回転を有効にしても、ケースバイケースで一部の向きを使用不可にすることができます。
詳細については、以下の API ドキュメントを参照してください。
アプリケーションの画面の向きは、アプリケーションのデフォルトの向きの設定に関係なく、ユーザーが設定したデバイスの向きによって異なる場合があります。
以下の表は、アプリケーションに設定されているデフォルトの画面の向きと、デバイスの向きに基づいてアプリケーションがロードされる実際の向きを示しています。

デフォルト画面方向:自動回転

**デフォルト画面方向:Portrait (縦向き)

**デフォルト画面方向:Landscape (横向き)

Device Orientation (デバイスの向き)自動**回転アプリケーション画面は縦向きでロードされ、縦向き、ランドスケープ右向き、ランドスケープ左向きの間で回転できます (縦向き逆さまの向きを除く)。
ノート:iPad では、アプリケーション画面はデバイスの向きに基づいて縦向きまたはランドスケープ向きでロードされます。画面は縦向き、縦向き、横向き、ランドスケープ右向き、ランドスケープ左向きの間で回転できます。
アプリケーション画面がロードされ、縦向きに固定されます。縦向きの上下逆の向きは許可されていますが、画面はその向きに回転しません。
ノート:iPad では、アプリケーション画面は縦向きでロードされ、縦向きと縦向きを逆に回転できます。起動時にデバイスの向きがランドスケープの場合、スプラッシュスクリーンはランドスケープでロードできます。
スプラッシュスクリーンは、デバイスの向きと同じ向きにロードされます。アプリケーション画面は、シーンがロードされたときにランドスケープにロードされ、ランドスケープの左方向またはランドスケープの右方向の間で回転できます。
ノート:iPad では、アプリケーション画面はランドスケープでロードされ、ランドスケープ左とランドスケープ右の間で回転できます。起動時にデバイスの向きが縦向きの場合、スプラッシュスクリーンは縦向きでロードできます。
Device Orientation (デバイスの向き)縦向きロック**アプリケーション画面がロードされ、縦向きに固定されます。
ノート:縦向きのとき、縦向きの ScreenOrientation.AutoRotation プロパティを false に設定すると、アプリケーション画面はランドスケープに回転します。ランドスケープの ScreenOrientation.AutoRotation プロパティを false に設定しても、画面の向きは変わりません。
アプリケーション画面がロードされ、縦向きに固定されます。スプラッシュスクリーンは縦向きでロードされますが、アプリケーション画面はシーンのロード時にランドスケープでロードされます。デフォルトでは、アプリケーション画面はランドスケープ左向きに固定されたままになります。
ノート:iPad では、スプラッシュスクリーンは縦向きでロードされ、シーンはランドスケープ向きでロードされます。アプリケーション画面はランドスケープに固定されたままになります。
Device Orientation (デバイスの向き)ランドスケープロック**iPhone にはランドスケープロック設定がないため、適用されません。アプリケーションがランドスケープのときにユーザーがデバイスの自動回転設定オフオフにすると、アプリケーション画面は縦向きに回転し、縦向きに固定されたままになります。
ノート:iPad では、アプリケーションがロードされ、ランドスケープに固定されます。
iPhone にはランドスケープロック設定がないため、適用されません。アプリケーションは縦向きに固定されたままになります。
ノート:iPad では、スプラッシュスクリーンはランドスケープに読み込まれ、シーンは縦向きに読み込まれます。アプリケーション画面は縦向きに固定されたままになります。
iPhone にはランドスケープロック設定がないため、適用されません。アプリケーション画面はランドスケープでロードされ、アプリケーションのロード時にランドスケープ左方向とランドスケープ右方向の両方でロックされたままになります。
ノート:iPad では、アプリケーション画面はランドスケープでロードされ、デバイスの向きに応じてランドスケープ左またはランドスケープ右に固定されます。

iPad のマルチタスクモード

iPadOS は、ユーザーが複数のアプリケーションを同時に実行できるマルチタスクモードをサポートしています。使用可能なモードは iPadOS のバージョンによって異なります。

iPadOS version

使用可能なモード

iPadOS 9 to 15分割ビュー、スライドオーバー
iPadOS 16 から 18分割ビュー、スライドオーバー、Stage Manager
iPadOS 26以降全画面アプリケーション、ウィンドウ付きアプリケーション、Stage Manager
全画面アプリケーションを除くすべてのモードで、アプリケーションは他のアプリケーションと一緒にサイズ変更可能なスペースで実行できます。iPadOS 26以降では、Window AppsとStage Managerの両方で、自由にサイズ変更や再配置が可能なWindowsを使用できます。Stage Managerでは、ワークスペースのグループ化を追加してWindow Apps上に構築します。これにより、ユーザーはWindowsをグループごとに整理し、切り替えて使用することができます。

画面 API 動作

アプリケーションをマルチタスクモードで実行すると、以下の動作が適用されます。
  • ウィンドウまたは分割のサイズが変更されると、 screen.幅と screen.高さを更新。
  • screen.safeArea は、使用可能なセーフエリアを反映するように調整します。
  • screen.全画面 は、アプリが全画面を占有していない場合に
    false
    を返します。
注
アプリケーションはウィンドウをコントロールできません。ウィンドウ寸法はユーザーとオペレーティングシステムによって決まります。

向きロックされたアプリケーション

アプリケーションがプレイヤー設定で縦向きのみまたはランドスケープのみに制限している場合、マルチタスクモードで以下の動作が適用されます。
  • アプリケーション ウィンドウがロックされた向きに対して正しいアスペクト比を維持する。
  • screen.orientation はロックされた向きを引き続きレポートします。
縦向きにロックされたアプリケーションは、全画面モードになってもアスペクト比を維持します。デバイスの向きがアプリケーションのロックされた向きと異なる場合 (ランドスケープのデバイスの縦向き専用アプリ例えば)、アプリケーションはレターボックス化されます。

制限事項

  • iPadOS 26 以降の向きロック:screen.orientation によるプログラムによる向きのロックは、プレイヤー設定で Requires Fullscreen が有効になっている場合にのみ機能します。[全画面が必要] が無効になっている場合、iPadOS 26 以降では、アプリケーションが全画面モードであっても、特定の向きに
    Screen.orientation
    を設定してもエフェクトはありません。
  • **ウィンドウサイズコントロール:**アプリケーションはウィンドウの最小サイズと最大サイズを設定できません。
  • ウィンドウモードの SetResolution:画面.SetResolution はレンダリング解像度を変更しますが、ウィンドウはサイズ変更しません。呼び出した後、 screen.幅と screen.高さはウィンドウサイズではなくレンダリングする解像度をレポートします。

デバイス生成の決定

デバイス世代によってパフォーマンスやサポート機能が異なります。デバイスの生成をクエリするには、iOS.DeviceGeneration プロパティを使用します。

ディスプレイ カットアウト

一部のディスプレイでは、他のハードウェアがそのスペースを占有しているために、画面の特定の領域が隠されていたり、機能しない場合があります。screen.cutouts を使用して、各カットアウトを囲むバウンディングボックスのリストを返します。
iOS デバイスでは、ディスプレイのカットアウト情報を取得するためのネイティブ API が提供されていないため、カットアウトは使用可能な各 iOS デバイスの Xcode プロジェクトにハードコードされています。
UnityView.mm
ファイル内の Unity Xcode プロジェクト
ReportSafeAreaChangeForView
機能で、既存データの変更やデバイスの追加ができます。

ゲームのリプレイのレコーディング

ReplayKitを使用して、ゲームのオーディオとビデオ、およびデバイスのマイクとカメラからキャプチャしたオーディオとビデオの解説をレコードできます。