مكتبة وحدة تحكّم الألعاب جزء من حزمة تطوير الألعاب (Android Game Development Kit).

تساعدك مكتبة وحدة التحكم في الألعاب، المعروفة أيضًا باسم Paddleboat، في تنفيذ دعم قوي لوحدات التحكم في الألعاب. توفّر المكتبة ما يلي:

  • عمليات معاودة الاتصال لاكتشاف اتصالات وحدة التحكّم وانقطاع الاتصال
  • معلومات جهاز وحدة التحكّم، بما في ذلك نمط الزرّ وتخطيطه
  • بيانات إدخال وحدة التحكم، موحّدة حول تصميمات وحدات التحكم المزدوجة الحديثة
  • ميزات موسّعة في وحدات التحكّم المتوافقة، بما في ذلك الاهتزاز والأضواء وبيانات محور الحركة وحالة البطارية
  • إمكانية قراءة الإدخال من أجهزة الماوس الافتراضية والمادية
  • إمكانية تحديد بيانات تعيين وحدة التحكّم المخصَّصة لأجهزة معيّنة

متطلبات التوافق

يجب أن تستوفي مكتبة وحدة التحكّم في الألعاب حدًّا أدنى من متطلبات التوافق، وهي تشمل ما يلي:

  • Android 4.1 (المستوى 16 لواجهة برمجة التطبيقات) أو إصدار أحدث
  • Android NDK الإصدار 17 أو أحدث

الدمج

يتم توزيع مكتبة وحدة التحكم في الألعاب بتنسيقين: كمكتبة Jetpack للألعاب التي تستخدم نظام تصميم يستند إلى Gradle (بما في ذلك Android Studio)، وكملفات منفصلة للألعاب التي تستخدم أنظمة تصميم مخصّصة.

للاطّلاع على النموذج الذي يدمج مكتبة وحدة التحكم في الألعاب، يُرجى مراجعة مستودع نماذج الألعاب.

مكتبة Jetpack

تحتوي صفحة ألعاب Jetpack على Android على تعليمات دمج لإضافة مكتبة وحدة التحكم في الألعاب إلى ملف build.gradle الخاص باللعبة.

إصدار مكتبة Jetpack من وحدة التحكم في الألعاب هو مكتبة ثابتة تم إنشاؤها مقابل المكتبة المشتركة لوقت تشغيل C++.

بعد تحديث ملف build.gradle، يجب إضافة السطر التالي إلى ملف CMakeLists.txt الرئيسي الخاص باللعبة:

find_package(games-controller REQUIRED CONFIG)

سيكون عليك أيضًا إضافة الإدخال التالي إلى قائمة المكتبات ضِمن الأمر target_link_libraries في المكتبة المشتركة الرئيسية للعبتك:

games-controller::paddleboat_static

الملفات المنفصلة

يتضمن توزيع أرشيف .zip لـ Android Game Development Kit ملفات العناوين والمكتبة لمكتبة وحدة تحكّم الألعاب. يجب تضمين الملفات التالية في مشروعك لاستخدام مكتبة وحدة التحكم في الألعاب:

  • الملف classes.jar الذي يحتوي على أجزاء رمز بايت Dalvik في مكتبة وحدة التحكم في الألعاب يقع هذا الملف في libs/classes.jar
  • ملف عنوان الواجهة paddleboat.h هذا الملف موجود في include/paddleboat/paddleboat.h
  • ملف المكتبة المشتركة libpaddleboat.so أو ملف المكتبة الثابت libpaddleboat-static.a. ويمكن العثور على هذه الملفات في الأدلة الفرعية لإعداد الإصدار ضمن دليل libs.

في ما يلي الأدلّة الفرعية لإعدادات الإصدار ضمن دليل libs الجذر:

  • بنية ABI
  • الحد الأدنى لمستوى واجهة برمجة تطبيقات Android
  • إصدار Android NDK
  • إصدار مكتبة وقت التشغيل لـ C++
  • إصدار إعدادات الإصدار أو تصحيح أخطائها

على سبيل المثال، يحتوي الدليل الفرعي arm64-v8a_API16_NDK21_cpp_shared_Release على ملفات مكتبة تشمل ما يلي:

  • ARM 64 بت ABI
  • الحد الأدنى من المستوى 16 لواجهة برمجة التطبيقات
  • التطبيق متوافق مع الإصدار 21 من NDK
  • مصممة وفقًا لإصدار المكتبة المشتركة من وقت تشغيل C++
  • إعدادات إصدار الإصدار

يتوفّر ملف libpaddleboat_static.a مباشرةً في الدليل الفرعي. يقع الملف libpaddleboat.so في lib/paddleboat/ ضمن الدليل الفرعي.

الخطوات التالية

يمكنك الاطّلاع على الأدلة التالية لمواصلة دمج مكتبة وحدة تحكّم الألعاب في لعبتك: