Istruzioni per aggiungere i parametri dello schermo dei nuovi dispositivi iOS all'SDK Cardboard e al plug-in XR

Ogni anno vengono rilasciati nuovi dispositivi iOS. Per far funzionare Cardboard SDK o Cardboard XR Plugin con questi nuovi dispositivi, aggiorna il file resolutions.csv per il progetto che stai utilizzando.

Fonte delle informazioni

  • Le stringhe del modello possono essere ottenute da The Apple Wiki.
  • I valori DPI (chiamati anche PPI) possono essere ottenuti dalle specifiche tecniche di Apple (ad esempio, consulta le specifiche di iPhone 16).

Cosa deve essere aggiornato

A seconda che tu stia utilizzando Cardboard SDK o Cardboard XR Plugin, aggiorna il file resolutions.csv corrispondente:

Entrambi caricano dinamicamente i parametri dello schermo del dispositivo in fase di runtime da resolutions.csv all'interno di sdk.bundle.

  • Quando contribuisci con nuovi parametri del dispositivo a Google Cardboard, invia richieste di pull sia ai repository di Cardboard SDK sia a quelli di Cardboard XR Plugin (vengono mantenuti sincronizzati utilizzando LINT.IfChange / LINT.ThenChange).
  • Per i progetti Unity locali che utilizzano pacchetti UPM immutabili in Library/PackageCache/, gli sviluppatori possono modificare resolutions.csv direttamente all'interno del progetto Xcode esportato in Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Formato di resolutions.csv

Aggiungi una nuova riga per ogni dispositivo utilizzando il seguente formato separato da virgole:

identifier,device_name,dpis
  • identifier: la stringa del modello hardware ottenuta da The Apple Wiki, con ogni virgola sostituita da un punto (ad esempio, iPhone17,3 diventa iPhone17.3).
  • device_name: il nome commerciale del dispositivo (ad esempio, iPhone 16). Non deve contenere virgole, poiché il parser di runtime (stringSplit in screen_params.mm) suddivide le virgole in un array a 3 elementi fissi senza supporto per le virgolette; una virgola incorporata sposterebbe il token DPI e lo farebbe valutare come 0.0.
  • dpis: la densità di pixel dello schermo in DPI/PPI seguita da f (ad esempio, 460.0f).

Voci di esempio

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