מדי שנה יוצאים מכשירי iOS חדשים. כדי שה-SDK של Cardboard או הפלאגין Cardboard XR יפעלו עם המכשירים החדשים האלה, צריך לעדכן את הקובץ resolutions.csv של הפרויקט שבו אתם משתמשים.
מקור המידע
- מחרוזות הדגם זמינות ב-Apple Wiki.
- אפשר למצוא ערכי DPI (שנקראים גם PPI) במפרטים הטכניים של אפל (לדוגמה, המפרטים של iPhone 16).
מה צריך לעדכן
בהתאם לשימוש ב-Cardboard SDK או ב-Cardboard XR Plugin, מעדכנים את הקובץ המתאים resolutions.csv:
- Cardboard SDK:
sdk/qrcode/ios/sdk.bundle/resolutions.csv - Cardboard XR Plugin:
Runtime/iOS/sdk.bundle/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: מחרוזת של דגם החומרה שהתקבלה מתוך The Apple Wiki, כאשר כל פסיק מוחלף בנקודה (לדוגמה,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