مكتبة وحدة تحكّم الألعاب جزء من حزمة تطوير الألعاب (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/
ضمن الدليل الفرعي.
الخطوات التالية
يمكنك الاطّلاع على الأدلة التالية لمواصلة دمج مكتبة وحدة تحكّم الألعاب في لعبتك:
- استخدام مكتبة وحدة تحكّم الألعاب
- إضافة دعم الماوس
- إضافة عمليات ربط الجهاز الخاصة بوحدة التحكّم المخصّصة