تعليمات لإضافة مَعلمات الشاشة لأجهزة iOS الجديدة إلى Cardboard SDK وXR Plugin

يتم إصدار أجهزة iOS جديدة كل عام. لإتاحة استخدام حزمة تطوير البرامج (SDK) أو Cardboard XR Plugin مع هذه الأجهزة الجديدة، عليك تعديل ملف resolutions.csv للمشروع الذي تستخدمه.

مصدر المعلومات

  • يمكن الحصول على سلاسل الطرازات من The Apple Wiki.
  • يمكن الحصول على قيم النقاط لكل بوصة (DPI) (المعروفة أيضًا باسم النقاط في البوصة PPI) من المواصفات الفنية التي تقدّمها Apple (على سبيل المثال، يمكنك الاطّلاع على مواصفات iPhone 16).

ما الذي يجب تعديله؟

استنادًا إلى ما إذا كنت تستخدم حزمة تطوير البرامج (SDK) الخاصة بـ Cardboard أو Cardboard XR Plugin، عدِّل ملف resolutions.csv المناسب:

يحمّل كلا الجهازين مَعلمات شاشة الجهاز بشكل ديناميكي في وقت التشغيل من resolutions.csv داخل sdk.bundle.

  • عند المساهمة في إضافة مَعلمات جديدة للأجهزة إلى Google Cardboard، أرسِل طلبات سحب إلى مستودعَي 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: كثافة وحدات البكسل على الشاشة بنقاط لكل بوصة/وحدات بكسل لكل بوصة، متبوعة بـ 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