Anleitung zum Hinzufügen der Bildschirmparameter neuer iOS-Geräte zum Cardboard SDK und XR-Plug-in

Jedes Jahr werden neue iOS-Geräte veröffentlicht. Damit das Cardboard SDK oder das Cardboard XR Plugin mit diesen neuen Geräten funktioniert, müssen Sie die Datei resolutions.csv für das verwendete Projekt aktualisieren.

Informationsquelle

Was muss aktualisiert werden?

Je nachdem, ob Sie das Cardboard SDK oder das Cardboard XR Plugin verwenden, aktualisieren Sie die entsprechende Datei resolutions.csv:

Beide laden die Parameter des Gerätebildschirms dynamisch zur Laufzeit aus resolutions.csv in sdk.bundle.

  • Wenn Sie neue Geräteparameter an Google Cardboard senden, reichen Sie Pull-Anfragen sowohl für das Cardboard SDK als auch für das Cardboard XR Plugin-Repository ein. Sie werden mit LINT.IfChange / LINT.ThenChange synchronisiert.
  • Bei lokalen Unity-Projekten mit unveränderlichen UPM-Paketen in Library/PackageCache/ können Entwickler resolutions.csv direkt im exportierten Xcode-Projekt unter Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv bearbeiten.

Format von resolutions.csv

Fügen Sie für jedes Gerät eine neue Zeile im folgenden kommagetrennten Format hinzu:

identifier,device_name,dpis
  • identifier: Der Hardwaremodellstring aus dem Apple Wiki, wobei jedes Komma durch einen Punkt ersetzt wird (z. B. wird aus iPhone17,3 iPhone17.3).
  • device_name: Der Marketingname des Geräts (z. B. iPhone 16). Er darf keine Kommas enthalten, da der Laufzeitparser (stringSplit in screen_params.mm) die Werte durch Kommas in ein Array mit drei Elementen aufteilt, ohne Anführungszeichen zu unterstützen. Ein eingebettetes Komma würde das DPI-Token verschieben und dazu führen, dass es als 0.0 ausgewertet wird.
  • dpis: Die Pixeldichte des Bildschirms in DPI/PPI, gefolgt von f (z. B. 460.0f).

Beispieleinträge

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