Instructions pour ajouter les paramètres d'écran des nouveaux appareils iOS au SDK Cardboard et au plug-in XR

Chaque année, de nouveaux appareils iOS sont mis sur le marché. Pour que le SDK Cardboard ou le plug-in Cardboard XR fonctionnent avec ces nouveaux appareils, mettez à jour le fichier resolutions.csv du projet que vous utilisez.

Source d'information

  • Les chaînes de modèle peuvent être obtenues à partir de The Apple Wiki.
  • Les valeurs PPP (également appelées PPI) peuvent être obtenues à partir des spécifications techniques d'Apple (par exemple, consultez les spécifications de l'iPhone 16).

Éléments à mettre à jour

Selon que vous utilisez le SDK Cardboard ou le plug-in Cardboard XR, mettez à jour le fichier resolutions.csv correspondant :

Les deux chargent les paramètres de l'écran de l'appareil de manière dynamique au moment de l'exécution à partir de resolutions.csv dans sdk.bundle.

  • Lorsque vous envoyez des paramètres d'appareil en amont à Google Cardboard, envoyez des requêtes d'extraction aux dépôts du SDK Cardboard et du plug-in Cardboard XR (ils sont synchronisés à l'aide de LINT.IfChange / LINT.ThenChange).
  • Pour les projets Unity locaux qui utilisent des packages UPM immuables dans Library/PackageCache/, les développeurs peuvent modifier resolutions.csv directement dans le projet Xcode exporté sous Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Format de resolutions.csv

Ajoutez une ligne pour chaque appareil au format suivant, séparé par une virgule :

identifier,device_name,dpis
  • identifier : chaîne de modèle matériel obtenue à partir de The Apple Wiki, avec chaque virgule remplacée par un point (par exemple, iPhone17,3 devient iPhone17.3).
  • device_name: nom commercial de l'appareil (par exemple, iPhone 16). Ce nom ne doit pas contenir de virgules, car l'analyseur d'exécution (stringSplit dans screen_params.mm) divise les virgules en un tableau fixe à trois éléments sans prise en charge des guillemets. Une virgule intégrée déplacerait le jeton PPP et le ferait évaluer à 0.0.
  • dpis : densité de pixels de l'écran en PPP/PPI, suivie de f (par exemple, 460.0f).

Exemples d'entrées

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