Инструкции по добавлению параметров экрана новых устройств iOS в SDK Cardboard и плагин XR.

Каждый год выпускаются новые устройства iOS. Чтобы Cardboard SDK или Cardboard XR Plugin работали с этими новыми устройствами, обновите файл resolutions.csv для используемого вами проекта.

Источник информации

Что нужно обновить

В зависимости от того, используете ли вы Cardboard SDK или плагин Cardboard XR, обновите соответствующий файл resolutions.csv :

Оба приложения динамически загружают параметры экрана устройства во время выполнения из файла resolutions.csv находящегося внутри sdk.bundle .

  • При добавлении новых параметров устройства в репозиторий Google Cardboard отправляйте запросы на слияние (pull requests) как в репозиторий Cardboard SDK, так и в репозиторий Cardboard XR Plugin (синхронизация осуществляется с помощью LINT.IfChange / LINT.ThenChange ).
  • Для локальных проектов Unity, использующих неизменяемые пакеты UPM в Library/PackageCache/ , разработчики могут редактировать resolutions.csv непосредственно в экспортированном проекте Xcode по адресу Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv .

Формат файла resolutions.csv

Для каждого устройства добавьте новую строку, используя следующий формат с разделителями-запятыми:

identifier,device_name,dpis
  • identifier : строка с моделью оборудования, полученная из вики-страницы Apple , где запятая заменена точкой (например, iPhone17,3 становится iPhone17.3 ).
  • device_name : Маркетинговое название устройства (например, iPhone 16 ). Оно не должно содержать запятых, поскольку парсер во время выполнения ( stringSplit в screen_params.mm ) разделяет данные по запятым на фиксированный массив из 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