ספריית Game Controller חלק מ-Android Game Development Kit.
ספריית Game Controller, שנקראת גם Paddleboat, עוזרת להטמיע תמיכה חזקה בשלטי משחק. ספריית שלט המשחק מופצת כספריית Jetpack למשחקים שמשתמשים במערכת build שמבוססת על Gradle (כולל Android Studio). הספרייה מספקת את הדברים הבאים:
- קריאות חוזרות (callbacks) לזיהוי חיבורים וניתוקים של בקרים
- פרטי מכשיר הבקר, כולל סגנון ופריסת הכפתורים
- נתוני קלט של בקר, שתואמים לעיצובים מודרניים של בקרים עם שני ג'ויסטיקים
- תכונות מורחבות בבקרים נתמכים, כולל רטט, אורות, נתוני ציר תנועה ומצב הסוללה
- יכולת לקרוא קלט ממכשירי עכבר וירטואליים ופיזיים
- אפשרות לציין נתוני מיפוי של שלטי משחק בהתאמה אישית למכשירים מסוימים
דרישות תאימות
אלה דרישות התאימות המינימליות של ספריית שלט המשחק:
- Android מגרסה 4.4 (רמת API 19) ומעלה
- Android NDK מגרסה 21 ואילך
פתרון אינטגרל
בדף Jetpack Android Games יש הוראות שילוב להוספת התלות בספריית Game Controller לקובץ build.gradle של המשחק.
גרסת ספריית Jetpack של שלט משחק היא ספרייה סטטית שנוצרה מול הספרייה המשותפת של סביבת זמן הריצה של C++.
אחרי שמעדכנים את הקובץ build.gradle, צריך להוסיף את השורה הבאה לקובץ CMakeLists.txt הראשי של המשחק:
find_package(games-controller REQUIRED CONFIG)
תצטרכו גם להוסיף את הרשומה הבאה לרשימת הספריות בפקודה target_link_libraries של הספרייה המשותפת הראשית של המשחק:
games-controller::paddleboat_static
במאגר games-samples יש דוגמה לשילוב של ספריית שלט משחק.
השלבים הבאים
במדריכים הבאים מוסבר איך להמשיך לשלב את ספריית Game Controller במשחק: