Instrukcje dodawania parametrów ekranu nowych urządzeń z iOS do pakietu Cardboard SDK i wtyczki XR

Każdego roku pojawiają się nowe urządzenia z iOS. Aby pakiet Cardboard SDK lub Cardboard XR Plugin działał na tych nowych urządzeniach, zaktualizuj plik resolutions.csv w używanym projekcie.

Źródło informacji

  • Ciągi znaków modelu można uzyskać z The Apple Wiki.
  • Wartości DPI (nazywane też PPI) można uzyskać ze specyfikacji technicznych Apple (np. specyfikacji iPhone'a 16).

Co należy zaktualizować

W zależności od tego, czy używasz pakietu Cardboard SDK czy Cardboard XR Plugin, zaktualizuj odpowiedni plik resolutions.csv:

Oba pakiety wczytują parametry ekranu urządzenia dynamicznie w czasie działania z pliku resolutions.csv w sdk.bundle.

  • Gdy przesyłasz nowe parametry urządzenia do Google Cardboard, prześlij żądania ściągnięcia do repozytoriów Cardboard SDK i Cardboard XR Plugin (są one synchronizowane za pomocą LINT.IfChange / LINT.ThenChange).
  • W przypadku lokalnych projektów Unity, które używają niezmiennych pakietów UPM w Library/PackageCache/, deweloperzy mogą edytować resolutions.csv bezpośrednio w wyeksportowanym projekcie Xcode w Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv.

Format pliku resolutions.csv

Dodaj nowy wiersz dla każdego urządzenia w tym formacie rozdzielonym przecinkami:

identifier,device_name,dpis
  • identifier: ciąg znaków modelu sprzętu uzyskany z The Apple Wiki, w którym każdy przecinek został zastąpiony kropką (np. iPhone17,3 staje się iPhone17.3).
  • device_name: nazwa marketingowa urządzenia (np. iPhone 16). Nie może zawierać przecinków, ponieważ parser czasu działania (stringSplit w screen_params.mm) dzieli ciąg znaków na stałą tablicę 3-elementową bez obsługi cudzysłowów. Przecinek w tekście spowoduje przesunięcie tokena DPI i jego wartość będzie wynosić 0.0.
  • dpis: gęstość pikseli ekranu w DPI/PPI, po której następuje f (np. 460.0f).

Przykładowe wpisy

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