کتابخانه Game Controller که به نام Paddleboat نیز شناخته می شود، به شما کمک می کند تا از کنترلرهای بازی پشتیبانی قوی انجام دهید. این کتابخانه موارد زیر را ارائه می دهد:
تماس پاسخ برای تشخیص اتصالات و قطع ارتباط کنترلر
اطلاعات دستگاه کنترلر، از جمله سبک دکمه و طرح
داده‌های ورودی کنترل‌کننده، استاندارد شده در مورد طرح‌های کنترل‌کننده دوتایی مدرن
ویژگی‌های گسترده در کنترل‌کننده‌های پشتیبانی‌شده، از جمله لرزش، چراغ‌ها، داده‌های محور حرکت و وضعیت باتری
امکان خواندن ورودی از دستگاه های مجازی و فیزیکی ماوس
امکان تعیین داده های نقشه برداری کنترلر سفارشی برای دستگاه های خاص
الزامات سازگاری
کتابخانه Game Controller حداقل الزامات سازگاری را دارد:
کتابخانه 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-controllerREQUIREDCONFIG)
همچنین باید ورودی زیر را به لیست کتابخانه ها در دستور 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 در بازی خود به راهنماهای زیر مراجعه کنید:
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین به‌روزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونه‌ها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین به‌روزرسانی 2025-08-26 بهوقت ساعت هماهنگ جهانی."],[],[],null,["Game Controller Library\nPart of [Android Game Development Kit](/games/agdk/overview).\n\nThe Game Controller library, also known as Paddleboat, helps you implement robust support\nfor game controllers. The library provides the following:\n\n- Callbacks for detecting controller connections and disconnections\n- Controller device information, including button style and layout\n- Controller input data, standardized around modern dual-stick controller designs\n- Extended features on supported controllers, including vibration, lights, motion axis data, and battery status\n- Ability to read input from virtual and physical mouse devices\n- Ability to specify custom controller mapping data for particular devices\n\nCompatibility requirements\n\nThe Game Controller library has minimum compatibility requirements of:\n\n- Android 4.4 (API level 19) or higher\n- [Android NDK](/ndk) version 21 or higher\n\nIntegrate\n\nThe Game Controller library is distributed in two formats: As a [Jetpack](/jetpack)\nlibrary for games using a Gradle-based build system (including Android Studio),\nand as discrete files for games using custom build systems.\n\nFor a sample that integrates the Game Controller library, see the\n[games-samples repository](https://github.com/android/games-samples).\n\nJetpack library\n\nThe [Jetpack Android Games](/jetpack/androidx/releases/games) page has\nintegration instructions to add the Game Controller library dependency to your\ngame's `build.gradle` file.\n\nThe Jetpack library release of Game Controller is a static\nlibrary built against the C++ runtime shared library.\n\nAfter updating your `build.gradle` file, you will need to add the following\nline to your game's main `CMakeLists.txt` file: \n\n find_package(games-controller REQUIRED CONFIG)\n\nYou will also need to add the following entry to the list of libraries\nin the `target_link_libraries` command of your game's main shared\nlibrary: \n\n games-controller::paddleboat_static\n\nDiscrete files\n\nThe `.zip` archive distribution of the Android Game Development Kit includes\nheader and library files for the Game Controller library. The following files\nmust be included in your project to use the Game Controller library:\n\n- The `classes.jar` file containing the Dalvik bytecode portions of the Game Controller library. This file is located at `libs/classes.jar`\n- The `paddleboat.h` interface header file. This file is located at `include/paddleboat/paddleboat.h`\n- Either the `libpaddleboat.so` shared library file or the `libpaddleboat-static.a` static library file. These files are found in the build configuration subdirectories under the `libs` directory.\n\nThe build configuration subdirectories under the root `libs` directory are\ncategorized by:\n\n- ABI architecture\n- Minimum Android API level\n- Android NDK version\n- C++ runtime library version\n- Release or debug build configuration\n\nAs an example, the `arm64-v8a_API16_NDK21_cpp_shared_Release` subdirectory\ncontains library files for:\n\n- ARM 64-bit ABI\n- Minimum API level 16\n- Built against NDK version 21\n- Built against shared library version of C++ runtime\n- Release build configuration\n\nThe `libpaddleboat_static.a` file is located directly in the subdirectory. The\n`libpaddleboat.so` file is located at `lib/paddleboat/` within the subdirectory.\n\nNext steps\n\nSee the following guides to continue integrating the Game Controller library into your game:\n\n- [Use the Game Controller library](/games/sdk/game-controller/controller)\n- [Add mouse support](/games/sdk/game-controller/mouse)\n- [Add custom controller device mappings](/games/sdk/game-controller/custom-mapping)"]]
