ספריית בקרי משחקים חלק מ-Android Game Development Kit.

ספריית בקר המשחקים, שנקראת גם Paddleboat, עוזרת להטמיע תמיכה יעילה לשלט לגיימינג. הספרייה מספקת את הפריטים הבאים:

  • קריאות חוזרות (callback) לזיהוי חיבורים וניתוקים של שלט רחוק
  • מידע מהמכשירים של השלט רחוק, כולל הסגנון והפריסה של הלחצנים
  • נתוני קלט של הבקר, כתקן קבוע סביב בקר דו-כיווני מודרני עיצובים
  • תכונות מורחבות בבקרים נתמכים, כולל רטט, אורות נתונים של צירי התנועה וסטטוס הסוללה
  • יכולת לקרוא קלט ממכשירי עכבר וירטואליים ופיזיים
  • יכולת לציין נתוני מיפוי מותאמים אישית לבקרה על מכשירים מסוימים

דרישות תאימות

ספריית בקרי המשחקים כוללת דרישות תאימות מינימליות של:

  • Android 4.4 (רמת API 19) ואילך
  • Android NDK בגרסה 21 ואילך

שילוב

ספריית בקר המשחקים מופצת בשני פורמטים: כ-Jetpack לספרייה למשחקים באמצעות מערכת build המבוססת על Gradle (כולל Android Studio), ובתור קבצים נפרדים למשחקים באמצעות מערכות build מותאמות אישית.

כדי לראות דוגמה שמשלבת את הספרייה של בקר המשחקים, אפשר לעיין למאגר לדוגמה של משחקים

ספריית Jetpack

בדף Jetpack משחקים ל-Android יש הוראות השילוב כדי להוסיף את התלות של ספריית בקר המשחקים בקובץ build.gradle של המשחק.

הגרסה של ספריית Jetpack של בקר המשחקים היא סטטית נבנה אל הספרייה המשותפת של סביבת זמן הריצה של C++.

לאחר עדכון קובץ build.gradle, יהיה עליך להוסיף את הפרטים הבאים שורה לקובץ CMakeLists.txt הראשי של המשחק:

find_package(games-controller REQUIRED CONFIG)

בנוסף צריך להוסיף את הערך הבא לרשימת הספריות בפקודה target_link_libraries במשחק הראשי המשותף ספרייה:

games-controller::paddleboat_static

קבצים נפרדים

הפצת הארכיון .zip של ערכת פיתוח המשחקים של Android כוללת את קובצי הכותרת והספרייה בספרייה של בקר המשחקים. הקבצים הבאים חייבים להיכלל בפרויקט כדי להשתמש בספרייה של בקר המשחקים:

  • הקובץ 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 מכיל קובצי ספרייה עבור:

  • ARM 64-ביט
  • רמת API מינימלית: 16
  • נוצר בהתאם לגרסה 21 של NDK
  • נוצר בהתאם לגרסת הספרייה המשותפת של סביבת זמן הריצה של C++
  • השקה של תצורת build

הקובץ libpaddleboat_static.a נמצא ישירות בספריית המשנה. קובץ libpaddleboat.so נמצא ב-lib/paddleboat/ בספריית המשנה.

השלבים הבאים

כדי להמשיך בשילוב של הספרייה של בקר המשחקים במשחק, יש לעיין במדריכים הבאים: