کتابخانه کنترل‌کننده بازی، بخشی از کیت توسعه بازی اندروید .

کتابخانه Game Controller که با نام Paddleboat نیز شناخته می‌شود، به شما کمک می‌کند تا پشتیبانی قوی برای کنترلرهای بازی پیاده‌سازی کنید. کتابخانه Game Controller به عنوان یک کتابخانه Jetpack برای بازی‌ها با استفاده از سیستم ساخت مبتنی بر Gradle (از جمله اندروید استودیو) توزیع شده است. این کتابخانه موارد زیر را ارائه می‌دهد:

  • فراخوانی‌های مجدد برای تشخیص اتصال‌ها و قطع اتصال‌های کنترلر
  • اطلاعات دستگاه کنترل‌کننده، شامل سبک و چیدمان دکمه‌ها
  • داده‌های ورودی کنترلر، استاندارد شده بر اساس طرح‌های کنترلر دو استیک مدرن
  • ویژگی‌های پیشرفته در کنترلرهای پشتیبانی‌شده، از جمله لرزش، چراغ‌ها، داده‌های محور حرکت و وضعیت باتری
  • قابلیت خواندن ورودی از دستگاه‌های ماوس مجازی و فیزیکی
  • امکان تعیین داده‌های نگاشت کنترلر سفارشی برای دستگاه‌های خاص

الزامات سازگاری

کتابخانه کنترلر بازی حداقل الزامات سازگاری زیر را دارد:

  • اندروید ۴.۴ (سطح API ۱۹) یا بالاتر
  • اندروید NDK نسخه ۲۱ یا بالاتر

ادغام

صفحه بازی‌های اندروید Jetpack دستورالعمل‌های یکپارچه‌سازی برای اضافه کردن وابستگی کتابخانه Game Controller به فایل build.gradle بازی شما را دارد.

نسخه کتابخانه Jetpack از Game Controller یک کتابخانه استاتیک است که در مقابل کتابخانه مشترک زمان اجرای C++ ساخته شده است.

پس از به‌روزرسانی فایل build.gradle ، باید خط زیر را به فایل اصلی CMakeLists.txt بازی خود اضافه کنید:

find_package(games-controller REQUIRED CONFIG)

همچنین باید ورودی زیر را به لیست کتابخانه‌ها در دستور target_link_libraries از کتابخانه مشترک اصلی بازی خود اضافه کنید:

games-controller::paddleboat_static

برای نمونه‌ای که کتابخانه‌ی Game Controller را ادغام می‌کند، به مخزن games-samples مراجعه کنید.

مراحل بعدی

برای ادامه ادغام کتابخانه کنترلر بازی در بازی خود، به راهنماهای زیر مراجعه کنید: