새 iOS 기기의 화면 매개변수를 Cardboard SDK 및 XR 플러그인에 추가하는 방법

매년 새로운 iOS 기기가 출시됩니다. Cardboard SDK 또는 Cardboard XR 플러그인이 이러한 새 기기에서 작동하도록 하려면 사용 중인 프로젝트의 resolutions.csv 파일을 업데이트하세요.

정보 소스

  • 모델 문자열은 Apple Wiki에서 가져올 수 있습니다.
  • DPI (PPI라고도 함) 값은 Apple의 기술 사양에서 가져올 수 있습니다 (예: iPhone 16 사양 참고).

업데이트해야 하는 항목

Cardboard SDK 또는 Cardboard XR 플러그인을 사용하는지에 따라 해당하는 resolutions.csv 파일을 업데이트합니다.

둘 다 런타임에 sdk.bundle 내의 resolutions.csv에서 기기 화면 매개변수를 동적으로 로드합니다.

  • 새 기기 매개변수를 Google Cardboard에 업스트림으로 기여할 때는 Cardboard SDK 및 Cardboard XR 플러그인 저장소 모두에 풀 요청을 제출합니다(LINT.IfChange / LINT.ThenChange를 사용하여 동기화됨).
  • `Library/PackageCache/`Library/PackageCache/에서 변경 불가능한 UPM 패키지를 사용하는 로컬 Unity 프로젝트의 경우 개발자는 내보낸 Xcode 프로젝트의 `Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv`Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv 내에서 resolutions.csv를 직접 수정할 수 있습니다.

resolutions.csv 형식

다음 쉼표로 구분된 형식을 사용하여 각 기기에 새 줄을 추가합니다.

identifier,device_name,dpis
  • identifier: Apple Wiki에서 가져온 하드웨어 모델 문자열로, 쉼표는 모두 마침표로 대체됩니다 (예: iPhone17,3은 iPhone17.3이 됨).
  • device_name: 기기의 마케팅 이름 (예: iPhone 16). 런타임 파서(screen_params.mm의 stringSplit)는 따옴표 지원 없이 쉼표로 구분하여 고정된 3요소 배열로 분할하므로 쉼표를 포함해서는 안 됩니다. 쉼표가 삽입되면 DPI 토큰이 이동하고 0.0으로 평가됩니다.
  • dpis: DPI/PPI의 화면 픽셀 밀도 (예: 460.0f) 뒤에 f가 붙습니다.

예시 항목

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