دمج ميزة "معدل سرعة الإطارات" في Android في عارض Vulkan

يوضّح هذا البرنامج التعليمي كيفية دمج Frame Pacing API في سلسلة أدواتك، وكيفية استخدام الدوال التي توفّرها المكتبة، وكيفية التأكّد من تحسُّن معدّل عرض اللقطات. تتوفّر أداة "مزامنة عرض اللقطات على Android" كمكتبة ثابتة أو مشتركة في "مكتبات AGDK".

البدء

1. أنشئ نسخة طبق الأصل من مستودع games-samples.
2. اتّبِع التعليمات الواردة في قسم المتطلبات الأساسية في ملف AGDKTunnel README.

3. شغِّل نموذج AGDKTunnel في "استوديو Android". يدمج مثال المشروع هذا أداة Android Frame Pacing في لعبة تستخدم Vulkan للعرض.

   1. افتح "استوديو Android".
   2. انقر على المشروع > فتح واختَر دليل /games-samples/agdk/agdktunnel.
   3. انتظِر إلى أن يزامن "استوديو Android" المشروع.
   4. اربط جهازًا أو أنشئ جهازًا افتراضيًا لتشغيل العيّنة (لمزيد من المعلومات، راجِع إنشاء تطبيقك وتشغيله).
   5. اختَر الجهاز المستهدف وانقر على تشغيل .

   6. يجب إنشاء ملف APK للعيّنة وتثبيته على الجهاز المستهدف. في حال ظهور أخطاء، تحقَّق مما يلي:

      • يجب أن يكون لديك إصدار متوافق من حزمة تطوير البرامج (SDK) لنظام التشغيل Android. يمكنك الاطّلاع على الحقل compileSdkVersion في ملف build.gradle لوحدة تطبيقك للحصول على مزيد من المعلومات. يمكنك تحديث إصدار حزمة تطوير البرامج (SDK) من علامة التبويب منصات حزمة تطوير البرامج (SDK) في "أداة إدارة حزمة تطوير البرامج (SDK)".
      • يجب أن يكون لديك إصدار متوافق من حزمة تطوير البرامج (NDK) لنظام Android. راجِع الحقل ndkVersion في ملف build.gradle لوحدة التطبيق للحصول على مزيد من المعلومات. يمكنك تثبيت إصدار معيّن من NDK من علامة التبويب أدوات حزمة تطوير البرامج (SDK) في "مدير حزمة تطوير البرامج (SDK)".
      • لا يحتوي الملف local.properties في المشروع على إدخال لـ ndk.dir. يتم تحديد هذا الموقع الجغرافي من خلال "استوديو Android" ويستخدم إصدار NDK المذكور أعلاه. إذا كان لديك هذا الإدخال، عليك محو السطر بأكمله.
      • بعد إجراء أي تغيير على إعدادات الإصدار، عليك تنظيف المشروع (إنشاء > تنظيف المشروع) وإعادة تحميل مشاريع C++ المرتبطة (إنشاء > إعادة تحميل مشاريع C++ المرتبطة).