Game Controller Library جزء من Android Game Development Kit
تساعدك مكتبة Game Controller، المعروفة أيضًا باسم Paddleboat، في توفير دعم قوي لأجهزة التحكّم في الألعاب. يتم توزيع مكتبة Game Controller كمكتبة Jetpack للألعاب التي تستخدم نظام إصدار يستند إلى Gradle (بما في ذلك "استوديو Android"). توفّر المكتبة ما يلي:
- عمليات ردّ الاتصال لرصد عمليات ربط وحدات التحكّم وفصلها
- معلومات جهاز التحكّم، بما في ذلك تصميم الأزرار وتخطيطها
- بيانات إدخال وحدة التحكّم، وهي موحّدة وفقًا لتصاميم وحدات التحكّم الحديثة ذات عصا التحكّم المزدوجة
- ميزات إضافية على وحدات التحكّم المتوافقة، بما في ذلك الاهتزاز والأضواء وبيانات محور الحركة وحالة البطارية
- إمكانية قراءة الإدخالات من أجهزة الماوس الافتراضية والفعلية
- إمكانية تحديد بيانات ربط مخصّصة لأزرار التحكّم بأجهزة معيّنة
متطلبات التوافق
تتضمّن مكتبة Game Controller الحدّ الأدنى من متطلبات التوافق التالية:
- الإصدار 4.4 من نظام التشغيل Android (المستوى 19 لواجهة برمجة التطبيقات) أو إصدار أحدث
- الإصدار 21 أو إصدار أحدث من Android NDK
الدمج
تحتوي صفحة ألعاب 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
للحصول على نموذج يدمج مكتبة Game Controller، راجِع مستودع games-samples.
الخطوات التالية
راجِع الأدلة التالية لمواصلة دمج مكتبة Game Controller في لعبتك:
- استخدام "مكتبة أدوات التحكّم في الألعاب"
- إضافة إمكانية استخدام الماوس
- إضافة عمليات ربط مخصّصة لأجهزة التحكّم