دستورالعمل‌های افزودن پارامترهای صفحه نمایش دستگاه‌های جدید iOS به Cardboard SDK و افزونه XR

هر ساله دستگاه‌های iOS جدیدی عرضه می‌شوند. برای اینکه Cardboard SDK یا Cardboard XR Plugin با این دستگاه‌های جدید کار کنند، فایل resolutions.csv را برای پروژه‌ای که استفاده می‌کنید، به‌روزرسانی کنید.

منبع اطلاعات

  • رشته‌های مدل را می‌توان از ویکی اپل دریافت کرد.
  • مقادیر DPI (که PPI نیز نامیده می‌شود) را می‌توان از مشخصات فنی اپل دریافت کرد (برای مثال، به مشخصات آیفون ۱۶ مراجعه کنید).

چه چیزهایی باید به‌روزرسانی شوند

بسته به اینکه از Cardboard SDK یا Cardboard XR Plugin استفاده می‌کنید، فایل resolutions.csv مربوطه را به‌روزرسانی کنید:

هر دو پارامترهای صفحه نمایش دستگاه را به صورت پویا در زمان اجرا از resolutions.csv درون sdk.bundle بارگذاری می‌کنند.

  • هنگام ارائه پارامترهای جدید دستگاه به Google Cardboard، درخواست‌های pull را هم به مخازن Cardboard SDK و هم به مخازن Cardboard XR Plugin ارسال کنید (آنها با استفاده از LINT.IfChange / LINT.ThenChange همگام‌سازی می‌شوند).
  • برای پروژه‌های یونیتی محلی که از بسته‌های UPM تغییرناپذیر در Library/PackageCache/ استفاده می‌کنند، توسعه‌دهندگان می‌توانند resolutions.csv مستقیماً درون پروژه Xcode اکسپورت شده در مسیر Frameworks/com.google.xr.cardboard/Runtime/iOS/sdk.bundle/resolutions.csv ویرایش کنند.

فرمت resolutions.csv

برای هر دستگاه، با استفاده از قالب جدا شده با کاما زیر، یک خط جدید اضافه کنید:

identifier,device_name,dpis
  • identifier : رشته مدل سخت‌افزار که از ویکی اپل گرفته شده است، و هر کامایی با نقطه جایگزین شده است (برای مثال، iPhone17,3 تبدیل به iPhone17.3 می‌شود).
  • device_name : نام تجاری دستگاه (برای مثال، iPhone 16 ). این نام نباید حاوی کاما باشد، زیرا تجزیه‌کننده‌ی زمان اجرا ( stringSplit در screen_params.mm ) بر اساس کاماها به یک آرایه‌ی ثابت ۳ عنصری بدون پشتیبانی از نقل قول تقسیم می‌کند. یک کامای جاسازی‌شده، توکن 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