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

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

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

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

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

למדריך הזה למפתחים, צריך להוריד את הדוגמה של אתגר Type-a-Number אפליקציה ל-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 למשחק שלך. הגדרת מטא-נתונים לאישור ולאימות של המשחק.

כדי להגדיר את המשחק לדוגמה ב-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. אפשר להשתמש באשף 'יצירת APK חתום' ב-Android Studio כדי: ליצור מאגר מפתחות חדש ואישור חתום, אם אין לכם עדיין אחד. כדי ללמוד כיצד: הפעילו את אשף Generate [יצירת APK חתום]. חתימת האפליקציה ב-Android Studio.
4. הקפידו לתעד את הפרטים הבאים לשימוש מאוחר יותר:
   1. מזהה האפליקציה שלך: זו מחרוזת שהוא כולל רק ספרות (בדרך כלל 12 או יותר) בתחילת מזהה הלקוח.
   2. אישור החתימה שלך: יש לשים לב באיזה אישור השתמשת כשהגדרת את את הגישה שלכם ל-API (האישור שנתתם לו טביעת אצבע SHA1). שלך צריך להשתמש באותו אישור כדי לחתום את האפליקציה במהלך בדיקה או פרסום של האפליקציה אפליקציה.
5. הגדרת הישגים באתגר מסוג מספר:
   1. בוחרים בכרטיסייה הישגים ב-Google Play Console.
   2. הוספת ההישגים הבאים לדוגמה:

      שם	תיאור	הוראות מיוחדות
      Prime	מקבלים ניקוד שהוא מספר ראשוני.	ללא
      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. מוסיפים שתי לוחות לידרבורד לדוגמה: אחת בשם 'תוצאות גבוהות קלות' ואחת שנקרא 'תוצאות גבוהות כבדות'. בשני לוחות הלידרבורד צריך להשתמש בפורמט ניקוד מספר שלם עם 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 וחתימה עם אותו האישור שבו השתמשתם כדי להגדיר את ה-APK את הפרויקט ב-Google Play Console. כדי לייצא APK חתום ב-Android Studio, לוחצים על Build > יוצרים APK חתום.
3. מתקינים את ה-APK החתום במכשיר הבדיקה הפיזי באמצעות הכלי adb. לקבלת מידע על התקנת אפליקציה: ריצה במכשיר.