Game Controller Library   جزء من Android Game Development Kit

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

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

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

تتضمّن مكتبة Game Controller الحدّ الأدنى من متطلبات التوافق التالية:

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

الدمج

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

للحصول على نموذج يدمج مكتبة Game Controller، اطّلِع على مستودع games-samples.

مكتبة Jetpack

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

إصدار مكتبة Game Controller من Jetpack هو مكتبة ثابتة تم إنشاؤها باستخدام المكتبة المشتركة لوقت التشغيل بلغة C++.

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

find_package(games-controller REQUIRED CONFIG)

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

games-controller::paddleboat_static

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

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

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

يتم تصنيف الأدلة الفرعية لإعدادات الإنشاء ضمن الدليل الجذر libs حسب ما يلي:

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

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

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

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

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

راجِع الأدلة التالية لمواصلة دمج مكتبة Game Controller في لعبتك: