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

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

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

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

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

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

الدمج

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

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

مكتبة 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" على ما يلي: عنوانًا وملفات مكتبة لمكتبة "وحدة تحكّم الألعاب". الملفات التالية في مشروعك لاستخدام مكتبة "وحدة تحكُّم الألعاب":

  • يحتوي الملف 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/ ضمن الدليل الفرعي.

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

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