Instrucciones para agregar los parámetros de pantalla de los nuevos dispositivos iOS al SDK de Cardboard y al complemento de XR

Cada año, se lanzan nuevos dispositivos iOS. Para que el SDK de Cardboard o el complemento de Cardboard XR funcionen con estos dispositivos nuevos, actualiza el archivo resolutions.csv del proyecto que usas.

Fuente de información

  • Las cadenas de modelos se pueden obtener de The Apple Wiki.
  • Los valores de DPI (también llamados PPI) se pueden obtener de las especificaciones técnicas de Apple (por ejemplo, consulta las especificaciones del iPhone 16).

Qué se debe actualizar

Según si usas el SDK de Cardboard o el complemento de Cardboard XR, actualiza el archivo resolutions.csv correspondiente:

Ambos cargan los parámetros de la pantalla del dispositivo de forma dinámica en el tiempo de ejecución desde resolutions.csv dentro de sdk.bundle.

  • Cuando envíes parámetros de dispositivos nuevos de forma ascendente a Google Cardboard, envía solicitudes de extracción a los repositorios del SDK de Cardboard y del complemento de Cardboard XR (se mantienen sincronizados con LINT.IfChange / LINT.ThenChange).
  • En el caso de los proyectos locales de Unity que usan paquetes UPM inmutables en Library/PackageCache/, los desarrolladores pueden editar resolutions.csv directamente dentro del proyecto de Xcode exportado en Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Formato de resolutions.csv

Agrega una línea nueva para cada dispositivo con el siguiente formato separado por comas:

identifier,device_name,dpis
  • identifier: Es la cadena del modelo de hardware obtenida de The Apple Wiki, con cualquier coma reemplazada por un punto (por ejemplo, iPhone17,3 se convierte en iPhone17.3).
  • device_name: Es el nombre de marketing del dispositivo (por ejemplo, iPhone 16). No debe contener comas, ya que el analizador de tiempo de ejecución (stringSplit en screen_params.mm) se divide en comas en un array fijo de 3 elementos sin compatibilidad con comillas. Una coma incorporada desplazaría el token de DPI y haría que se evalúe como 0.0.
  • dpis: Es la densidad de píxeles de la pantalla en DPI/PPI seguida de f (por ejemplo, 460.0f).

Entradas de ejemplo

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