Game Controller Library Part of Android Game Development Kit.
ספריית Game Controller, שנקראת גם Paddleboat, עוזרת לכם להטמיע תמיכה חזקה בשלטים למשחקים. הספרייה מספקת את האפשרויות הבאות:
- התקשרות חוזרת לזיהוי חיבורים וניתוקים של בקרים
- פרטי מכשיר הבקרה, כולל סגנון ופריסת הלחצנים
- נתוני קלט של בקר, שעברו סטנדרטיזציה בהתאם לעיצובים מודרניים של בקרים עם שני ג'ויסטיקים
- תכונות נוספות בבקרי משחקים נתמכים, כולל רטט, אורות, נתוני ציר תנועה ומצב הסוללה
- היכולת לקרוא קלט ממכשירי עכבר וירטואליים ופיזיים
- אפשרות לציין נתוני מיפוי של בקרים בהתאמה אישית למכשירים מסוימים
דרישות התאימות
ספריית בקר המשחקים כוללת דרישות תאימות מינימליות:
- Android 4.4 (API ברמה 19) ואילך
- Android NDK מגרסה 21 ואילך
שילוב
ספריית בקר המשחקים מופצת בשני פורמטים: כספריית Jetpack למשחקים שמשתמשים במערכת בנייה מבוססת Gradle (כולל Android Studio), וכקבצים נפרדים למשחקים שמשתמשים במערכות בנייה בהתאמה אישית.
דוגמה לשילוב של ספריית בקר המשחק זמינה במאגר הדוגמאות של משחקים.
ספריית Jetpack
בדף Jetpack Android Games יש הוראות לשילוב של ספריית 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 של Android Game Development Kit כוללת קובצי כותרת וספרייה של ספריית בקר המשחק. כדי להשתמש בספריית בקר המשחק, צריך לכלול בפרויקט את הקבצים הבאים:
- קובץ
classes.jarשמכיל את חלקי ה-bytecode של Dalvik בספריית בקר המשחקים. הקובץ הזה נמצא במיקוםlibs/classes.jar - קובץ הכותרת של הממשק
paddleboat.h. הקובץ הזה נמצא במיקוםinclude/paddleboat/paddleboat.h - קובץ הספרייה המשותפת
libpaddleboat.soאו קובץ הספרייה הסטטיתlibpaddleboat-static.a. הקבצים האלה נמצאים בספריות המשנה של הגדרת ה-build בספרייהlibs.
ספריות המשנה של הגדרות ה-build שנמצאות מתחת לספריית השורש libs מחולקות לקטגוריות לפי:
- ארכיטקטורת ABI
- רמת ה-API המינימלית ב-Android
- גרסת Android NDK
- גרסת ספריית זמן הריצה של C++
- הגדרת גרסת build להפצה או לניפוי באגים
לדוגמה, ספריית המשנה arm64-v8a_API16_NDK21_cpp_shared_Release מכילה קבצים של ספריות עבור:
- ממשק ABI 64 ביט של ARM
- רמת API מינימלית 16
- נוצר בהתאם לגרסה 21 של NDK
- נוצר בהתאם לגרסה של זמן הריצה של C++ בספרייה משותפת
- הגדרת גרסת build להפצה
הקובץ libpaddleboat_static.a נמצא ישירות בספריית המשנה. הקובץ libpaddleboat.so נמצא בנתיב lib/paddleboat/ בספריית המשנה.
השלבים הבאים
כדי להמשיך לשלב את ספריית בקר המשחק במשחק, אפשר לעיין במדריכים הבאים: