مكتبة وحدة التحكم في الألعاب جزء من مجموعة أدوات تطوير ألعاب Android.

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

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

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

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

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

الدمج

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

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

مكتبة Jetpack

تتضمن صفحة Jetpack Android Games تعليمات دمج لإضافة مكتبة وحدة التحكم في الألعاب إلى ملف 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/ ضمن الدليل الفرعي.

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

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