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

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

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

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

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

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

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

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

• minSdkVersion של 19 גבוה יותר
• compileSdkVersion של 28 ומעלה

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

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

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

בקובץ 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. האפליקציה לדוגמה של אתגר מסוג מספר מדגימה איך אפשר לשלב הישגים ולוחות לידרבורד במשחק שלכם.

שלב 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 עבור המשחק, ומגדירים מטא-נתונים לאישור ולאימות של המשחק.

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

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

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

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

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

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