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