תחילת השימוש ב-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 לקובץ Gradle build של המודול, שהוא בדרך כלל app/build.gradle:

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

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

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

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

למדריך הזה למפתחים, צריך להוריד את האפליקציה ל-Android לדוגמה של אתגר Type-a-Number.

כדי להוריד ולהגדיר את האפליקציה לדוגמה ב-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 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. בוחרים את הכרטיסייה לוחות הלידרבורד ב-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 Signature APK.
3. מתקינים את חבילת ה-APK החתומה במכשיר הפיזי לבדיקה באמצעות הכלי adb. מידע נוסף על התקנת אפליקציה מופיע במאמר הפעלה במכשיר.