新しい iOS デバイスの画面パラメータを Cardboard SDK と XR プラグインに追加する手順

毎年、新しい iOS デバイスがリリースされます。Cardboard SDK または Cardboard XR Plugin をこれらの新しいデバイスで動作させるには、使用しているプロジェクトの resolutions.csv ファイルを更新します。

情報源

  • モデル文字列は Apple Wiki から取得できます。
  • DPI（PPI とも呼ばれます）の値は、Apple の技術仕様から取得できます（たとえば、iPhone 16 の仕様をご覧ください）。

更新が必要なもの

Cardboard SDK または Cardboard XR Plugin のどちらを使用しているかに応じて、対応する resolutions.csv ファイルを更新します。

どちらも、sdk.bundle 内の resolutions.csv から実行時にデバイスの画面パラメータを動的に読み込みます。

  • 新しいデバイス パラメータを Google Cardboard にアップストリームで提供する場合は、Cardboard SDK と Cardboard XR Plugin の両方のリポジトリにプルリクエストを送信します（これらは LINT.IfChange / LINT.ThenChange を使用して同期されます）。
  • Library/PackageCache/ で不変の UPM パッケージを使用するローカル Unity プロジェクトの場合、デベロッパーは Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv の下にあるエクスポートされた Xcode プロジェクト内で resolutions.csv を直接編集できます。

resolutions.csv の形式

次のカンマ区切りの形式で、デバイスごとに新しい行を追加します。

identifier,device_name,dpis
  • identifier: Apple Wiki から取得したハードウェア モデル文字列。カンマはすべてドットに置き換えられます（例: iPhone17,3 は iPhone17.3 になります）。
  • device_name: デバイスのマーケティング名（iPhone 16 など）。ランタイム パーサー（screen_params.mm の stringSplit）は、引用符のサポートなしでカンマで分割して固定の 3 要素配列にするため、カンマを含めることはできません。カンマが埋め込まれていると、DPI トークンが置き換えられ、0.0 と評価されます。
  • dpis: 画面のピクセル密度（DPI/PPI）の後に f を続けます（例: 460.0f）。

入力内容

iPhone17.3,iPhone 16,460.0f
iPhone17.4,iPhone 16 Plus,460.0f
iPhone17.1,iPhone 16 Pro,460.0f
iPhone17.2,iPhone 16 Pro Max,460.0f