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

کتابخانه Game Controller که به نام Paddleboat نیز شناخته می شود، به شما کمک می کند تا از کنترلرهای بازی پشتیبانی قوی انجام دهید. این کتابخانه موارد زیر را ارائه می دهد:

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

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

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

  • Android 4.4 (سطح API 19) یا بالاتر
  • Android NDK نسخه 21 یا بالاتر

ادغام کنید

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

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

کتابخانه جت پک

صفحه بازی‌های Android 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

فایل های گسسته

توزیع آرشیو .zip کیت توسعه بازی اندروید شامل فایل‌های هدر و کتابخانه برای کتابخانه Game Controller است. برای استفاده از کتابخانه Game Controller فایل های زیر باید در پروژه شما گنجانده شوند:

  • فایل classes.jar حاوی بخش‌های بایت کد Dalvik از کتابخانه Game Controller است. این فایل در libs/classes.jar قرار دارد
  • فایل هدر رابط paddleboat.h . این فایل در آدرس include/paddleboat/paddleboat.h قرار دارد
  • یا فایل کتابخانه مشترک libpaddleboat.so یا فایل کتابخانه ایستا libpaddleboat-static.a . این فایل‌ها در زیرشاخه‌های پیکربندی build در زیر پوشه libs یافت می‌شوند.

زیرمجموعه های پیکربندی ساخت در پوشه root libs بر اساس:

  • معماری ABI
  • حداقل سطح Android API
  • نسخه NDK اندروید
  • نسخه کتابخانه زمان اجرا C++
  • پیکربندی ساخت را منتشر یا اشکال زدایی کنید

به عنوان مثال، دایرکتوری فرعی arm64-v8a_API16_NDK21_cpp_shared_Release حاوی فایل های کتابخانه ای برای:

  • ARM 64 بیتی ABI
  • حداقل سطح API 16
  • بر اساس NDK نسخه 21 ساخته شده است
  • بر اساس نسخه کتابخانه مشترک C++ زمان اجرا ساخته شده است
  • پیکربندی ساخت را منتشر کنید

فایل libpaddleboat_static.a مستقیماً در زیر شاخه قرار دارد. فایل libpaddleboat.so در lib/paddleboat/ در زیر شاخه قرار دارد.

مراحل بعدی

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