תחילת השימוש ב-Play Games Services ל-Android

ברוכים הבאים לפיתוח משחקים ל-Android באמצעות Google Play Games Services!

Play Games SDK מספק שירותי Google Play Games בפלטפורמות שונות, שמאפשרים לשלב בקלות תכונות גיימינג פופולריות כמו הישגים, לידרבורד ומשחקים שמורים במשחקים בטאבלט ובנייד.

במדריך הזה תלמדו איך להתקין אפליקציית משחק לדוגמה ל-Android, ואיך להתחיל ליצור משחק משלכם ל-Android במהירות. באפליקציית הדוגמה Type-a-Number Challenge מוסבר איך לשלב במשחק הישגים וטבלאות מנהיגות.

לפני שמתחילים

כדי להכין את האפליקציה, מבצעים את השלבים שמפורטים בקטעים הבאים.

דרישות מוקדמות להתקנת האפליקציה

מוודאים שבקובץ ה-build של האפליקציה נעשה שימוש בערכים הבאים:

• minSdkVersion של 19 או יותר
• compileSdkVersion של 28 או יותר

הגדרת המשחק ב-Google Play Console

ב-Google Play Console מנהלים את שירותי המשחקים של Google Play במשחק, ומגדירים את המטא-נתונים להרשאה ולאימות של המשחק. למידע נוסף, קראו את המאמר הגדרת שירותי המשחקים של Play.

הגדרת האפליקציה

בקובץ build.gradle ברמת הפרויקט, צריך לכלול את מאגר Maven של Google ואת מאגר Maven המרכזי גם בקטע buildscript וגם בקטע allprojects:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

מוסיפים את התלות של Google Play Services ב-Play Games SDK לקובץ ה-build של Gradle של המודול, שבדרך כלל הוא app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

מדריך לאפליקציה לדוגמה

במדריך הזה תלמדו איך להתקין אפליקציית משחק לדוגמה ל-Android, ואיך להתחיל ליצור משחק משלכם ל-Android במהירות. באפליקציית הדוגמה Type-a-Number Challenge מוסבר איך לשלב במשחק הישגים וטבלאות מנהיגות.

שלב 1: מורידים את האפליקציה לדוגמה

במדריך למפתחים הזה תצטרכו להוריד את האפליקציה לדוגמה ל-Android של האתגר 'הקלדה של מספר'.

כדי להוריד ולהגדיר את האפליקציה לדוגמה ב-Android Studio:

1. מורידים את הדוגמאות ל-Android מדף ההורדות של הדוגמאות.
2. מייבאים את הפרויקט android-basic-samples. הפרויקט הזה כולל את TypeANumber ודוגמאות נוספות למשחקים ל-Android. כדי לעשות זאת ב-Android Studio:
   1. לוחצים על קובץ > ייבוא פרויקט.
   2. עוברים לספרייה שבה הורדתם את android-basic-samples במכונה לפיתוח. בוחרים את הקובץ android-basic-samples/build.gradle ולוחצים על אישור.
3. במודול TypeANumber, פותחים את AndroidManifest.xml ומשנים את שם החבילה מ-com.google.example.games.tanc לשם אחר לבחירתכם. שם החבילה החדשה לא יכול להתחיל ב-com.google, ב-com.example או ב-com.android.

שלב 2: מגדירים את המשחק ב-Google Play Console

ב-Google Play Console מנהלים את Google Play Games Services במשחק, ומגדירים את המטא-נתונים להרשאה ולאימות של המשחק.

כדי להגדיר את המשחק לדוגמה ב-Google Play Console:

1. פותחים את דפדפן האינטרנט ומפנים אותו אל Google Play Console, ונכנסים לחשבון. אם עדיין לא נרשמתם ל-Google Play Console, תתבקשו לעשות זאת.
2. פועלים לפי ההוראות האלה כדי להוסיף את המשחק ל-Google Play Console.
   1. כשמתבקשים לציין אם משתמשים ב-Google APIs באפליקציה, בוחרים באפשרות עדיין לא משתמשים ב-Google APIs במשחק שלי.
   2. לצורך מדריך המפתחים הזה, אפשר למלא את הטופס עם פרטי המשחק שלכם. לנוחותכם, תוכלו להשתמש בסמלי ה-placeholder ובצילומי המסך שמוצגים בדף הורדות.
3. כדי ליצור מזהה לקוח ב-OAuth 2.0 לאפליקציה ל-Android, פועלים לפי ההוראות הבאות.
   1. כשמקשרים את אפליקציית Android, חשוב לציין את שם החבילה המדויק שבו השתמשתם קודם כששיניתם את השם של חבילת הדוגמה.
   2. אם עדיין אין לכם מאגר מפתחות ואישור חתום, תוכלו להשתמש באשף Generate Signed APK ב-Android Studio כדי ליצור אותם. במאמר חתימה על האפליקציה ב-Android Studio מוסבר איך מפעילים את האשף ליצירת קובץ APK חתום.
4. חשוב לתעד את הפרטים הבאים לשימוש מאוחר יותר:
   1. מזהה האפליקציה: מחרוזת שמכילה רק ספרות (בדרך כלל 12 ספרות או יותר) שמופיעה בתחילת מזהה הלקוח.
   2. אישור החתימה: שימו לב לאישור שבו השתמשתם כשהגדרתם את הגישה ל-API (האישור שסיפקתם את טביעת האצבע שלו מסוג SHA1). מומלץ להשתמש באותו אישור לחתימה על האפליקציה בזמן הבדיקה או השקת האפליקציה.
5. מגדירים את ההישגים של האתגר 'הקלדה של מספר':
   1. בוחרים את הכרטיסייה הישגים ב-Google Play Console.
   2. מוסיפים את ההישגים לדוגמה הבאים:

      שם	תיאור	הוראות מיוחדות
      Prime	מקבלים ציון שהוא מספר ראשוני.	ללא
      צנוע	מבקשים ניקוד של 0.	ללא
      אל תתגאה בעצמך, ילד	מבקשים ציון של 9999 בכל אחד מהמצבים.	ללא
      OMG U R TEH UBER LEET!	מקבלים ציון של 1337.	להגדיר את ההישג הזה כמוסתר.
      שעמום	משחקים במשחק 10 פעמים.	אפשר להגדיר את ההישג הזה כמצטבר עם 10 שלבים לביטול הנעילה.
      Really Really Bored	משחקים במשחק 100 פעמים.	מגדירים את ההישג הזה כמצטבר עם 100 שלבים לביטול הנעילה.

   3. מתעדים את המזהים (מחרוזות אלפאנומריות ארוכות) של כל הישג שיצרתם.
   4. מגדירים הישגים שמתאימים למשחק. למידע נוסף, קראו את המאמרים המושגים שמאחורי ההישגים ואיך מטמיעים הישגים ב-Android.
6. מגדירים את לוחות הלידארבורד של האתגר 'הקלדה של מספר':
   1. לוחצים על הכרטיסייה Leaderboards (רשימות מובילים) ב-Google Play Console.
   2. מוסיפים שני לוחות לידרבורד לדוגמה: אחד בשם 'ציונים גבוהים בקלות' והשני בשם 'ציונים גבוהים בקושי'. בשני לוחות הלידרבורד צריך להשתמש בפורמט של ציונים שלמים עם 0 ספרות עשרוניות, ובסוג סדר של גדול יותר עדיף.
   3. מתעדים את המזהים (מחרוזות ארוכות של תווים אלפאנומריים) של כל לידרבורד שיצרתם.
   4. מגדירים לוחות לידרבורד שמתאימים למשחק. למידע נוסף, תוכלו לקרוא על המושגים שמאחורי לוחות מנהיגות ועל הטמעת לוחות מנהיגות ב-Android.
7. מוסיפים חשבונות בדיקה למשחק. השלב הזה נדרש רק לאפליקציות שעדיין לא פורסמו ב-Google Play Console. לפני פרסום האפליקציה, רק חשבונות הבדיקה שמפורטים ב-Google Play Console יכולים להתחבר. עם זאת, אחרי שמפרסמים אפליקציה, כל אחד יכול להתחבר אליה.

שלב 3: משנים את הקוד

כדי להריץ את המשחק, צריך להגדיר את מזהה האפליקציה כמשאב בפרויקט Android. תצטרכו גם להוסיף מטא-נתונים של משחקים בקובץ AndroidManifest.xml.

1. פותחים את הקובץ res/values/ids.xml ומחליפים את מזהי ה-placeholder. אם אתם יוצרים משחק ל-Android מאפס, תצטרכו ליצור את הקובץ הזה קודם.
   1. מציינים את מזהה האפליקציה במשאב app_id.
   2. מציינים את כל מזהי ההישגים שיצרתם מקודם במשאב achievement_* המתאים.
   3. מציינים את כל מזהי לוחות הדירוג שיצרתם קודם במשאב leaderboard_* המתאים.
2. פותחים את AndroidManifest.xml ומזינים את שם החבילה במאפיין package של הרכיב <manifest>. אם אתם יוצרים משחק ל-Android מאפס, חשוב להוסיף גם את הקוד הבא בתוך האלמנט <application>:

   <meta-data android:name="com.google.android.gms.games.APP_ID"
       android:value="@string/app_id" />
   <meta-data android:name="com.google.android.gms.version"
      android:value="@integer/google_play_services_version"/>
   

שלב 4: בודקים את המשחק

כדי לוודא ששירותי Google Play Games פועלים כראוי במשחק, כדאי לבדוק את האפליקציה לפני שמפרסמים אותה ב-Google Play.

כדי להריץ את המשחק במכשיר הפיזי לבדיקה:

1. מוודאים שהגדרתם את חשבון הבדיקה שבו אתם משתמשים כדי להתחבר לאפליקציה (כפי שמתואר בשלב 2).
2. מייצאים קובץ APK וחותמים עליו באמצעות אותו אישור שבו השתמשתם כדי להגדיר את הפרויקט ב-Google Play Console. כדי לייצא קובץ APK חתום ב-Android Studio, לוחצים על Build (פיתוח) > Generate Signed APK (יצירת קובץ APK חתום).
3. מתקינים את חבילת ה-APK החתומה במכשיר הפיזי לבדיקה באמצעות הכלי adb. במאמר הפעלה במכשיר מוסבר איך להתקין אפליקציה.