שאלות נפוצות

במאמר הזה ריכזנו תשובות לשאלות נפוצות לגבי ערכות SDK ופרסום ב-Google Play Games במחשב.

מונטיזציה

1. למה תהליך הרכישה שלי נכשל עם קוד השגיאה 6 אחרי שהוספתי מפתח חדש לחיוב או לרישיון?

   למפתחות רישיון חדשים שנוצרו ב-Google Play Console יש עיכוב של כמה שעות בשמירה במטמון ובהפצה ב-backend של המסחר, לפני שהמטמון הפנימי של Google Play מסתנכרן בכל סביבות ההצגה. גם אם לקוח המשחק יכול לשלוח שאילתות לגבי פרטי המוצר בהצלחה, בקשות הרכישה ייכשלו עם קוד השגיאה 6 עד שהסנכרון יושלם. אחרי שמעלים או מעדכנים את מפתח הרישיון, צריך לחכות כמה שעות לפני שבודקים את הרכישות.

2. האם אפשר להשתמש בתהליך הרכישה בלי שרת קצה עורפי?

   מבחינת אבטחה, Google ממליצה להשתמש בשרת קצה עורפי.

   מידע נוסף זמין במאמר בנושא תהליך ללא שרת קצה עורפי.

   הערה: כדי לעבד רכישות בלי שרת קצה עורפי, צריך הרשאות מיוחדות. אם המשחק שלכם דורש את ההרשאות האלה, עליכם לפנות ל-Google Partner.

3. האם מותר להשתמש במערכות תשלום קיימות שמבוססות על API אחרי שמשלבים את Google Play Games SDK למחשב?

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

4. איך אפשר להשתמש ברכישות במצב פיתוח?

   צריך להשלים את הרכישה במצב פיתוח תוך 3 דקות, אחרת יתבצע החזר כספי על הרכישה.

5. האם יש תמיכה בתשלומים קבועים או במינויים?

   לא בעתיד הקרוב, אבל אתם מוזמנים לספק לנו תרחישים ספציפיים לשימוש כדי שנוסיף אותם לתוכנית שלנו לעתיד.

6. What is the Billing Error in my purchase calls?

   ‫BillingError היא התגובה של תוצאת התשלום. השיטה LaunchPurchaseFlow תחזיר ערך באופן מיידי בלי לחסום, אבל צריך להאזין לקריאה החוזרת כדי לדעת מתי היא הסתיימה ולתעד את התוצאה.

7. איך משתמשים באימות רכישות בצד הלקוח

   מומלץ להשתמש ברכישה בצד השרת ובתהליך האימות שלה. כדי לעבד רכישות מאפליקציית הלקוח, המשחק צריך להיות ברשימת ההיתרים. אם המשחק שלכם דורש גישה, אתם יכולים לפנות ל-Google Partner שלכם. מידע נוסף זמין במאמר בנושא תהליך ללא שרת קצה עורפי.

8. מהן מגבלות ה-API לשליחת שאילתות לגבי פרטי מוצרים?

   המספר המקסימלי של מוצרים שאפשר לשלוח לגביהם שאילתה בקריאה אחת ל-API‏ QueryProductDetails הוא 50. אם חורגים מהמגבלה הזו, צריך לפצל את הבקשה לכמה קריאות.

9. אילו פרמטרים נדרשים כשמפעילים את הפונקציות Query Purchases או Launch Purchase Flow ב-Billing Client?

   הפונקציה מקבלת את QueryPurchasesContinuation, שהיא קריאה חוזרת של פונקציה עם החתימה std::function<void(QueryPurchasesResult)>. הקריאה החוזרת מעבירה לכם את התוצאה עם כל ה-ProductPurchaseDetails. המידע הזה זמין בקובצי הכותרת של ה-SDK בקובץ includes/billing/models.h.

   הערך בשדה launch_purchase_flow_result שמתקבל מכיל את הפונקציות ok() ו-code(). הפונקציה ok() מחזירה את התוצאה של התהליך. הפונקציה code() מחזירה את הערך BillingError enum (includes/billing/enums.h), שיש לו 10 מקרים אפשריים של שגיאות, כמו ביטול על ידי המשתמש או שגיאת רשת.

10. האם יש תמיכה בהזמנה בהתאמה אישית בתהליך הרכישה של Launch ב-BillingClient?

    במבנה הנוכחי של ה-SDK, אין אפשרות להעביר מטען ייעודי משלכם. עם זאת, אפשר לספק כל שילוב של obfuscated_account_id ו-obfuscated_profile_id. אתם יכולים לא לספק אף אחת מהאפשרויות, לספק רק אחת מהן או לספק את שתיהן.

    השדה offer_token הוא שדה חובה, והוא מציין את מבצע הרכישה שהמשתמש מנסה לקנות בתהליך התשלום. בשלב הזה, לכל מק"ט ב-Google Play יש בדיוק מבצע אחד (לדוגמה, קונים פריט אחד ב-10$). בעתיד, צוות החיוב של Play יספק תמיכה בכמה מבצעים.

    כדי לוודא שהמטא-נתונים ישויכו במקרה של שיבושים בתהליך הרכישה, צריך לאחסן את המטא-נתונים בשרת הבק-אנד לפני שמפעילים את תיבת הדו-שיח של הרכישה, ולשייך אותם למזהה החשבון של המשתמש, למק"ט שנרכש ולחותמת הזמן הנוכחית. מידע נוסף זמין במאמר בנושא שיוך רכישה לנתונים פנימיים.

11. מהן הדרישות המוקדמות למעבר מחיוב דרך Google עם OAuth לחיוב דרך Google שמבוסס על DLL?

    משחקים יכולים להמשיך להשתמש בכניסה באמצעות OAuth עם חשבון Google כדי לנהל את החשבון שאליו נכנסים, אבל Google ממליצה להפסיק להשתמש בממשקי ה-API הקודמים של REST לחיוב. המעבר מממשקי ה-API של REST לחיוב (עם כניסה באמצעות OAuth2) לזרימת העבודה של ה-SDK יכול להיות פעולה עם דגל תכונה, כך ששניהם יכולים להתקיים יחד למשך תקופה מסוימת בזמן שהמשחק עובר לממשקי ה-API החדשים.

12. האם קריאה ל-API של Launch Purchase Flow מעובדת דרך דפדפן אינטרנט?

    לא, תהליך הרכישה מתבצע עכשיו באופן מלא בתוך המשחק באמצעות שכבת-על חלקה של WebView, בלי לצאת מלקוח המשחק.

13. האם משתמש צריך להיכנס בנפרד לכל משחק כדי לבצע רכישה?

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

14. האם משחק יכול לתמוך גם ב-SDK למחשב וגם במערכות תשלום מדור קודם בו-זמנית?

    מערכת התשלומים פועלת לפי מודל זרימה כפולה, בהתאם לגרסה הבינארית של המשחק. משתמשים בגרסאות קודמות ממשיכים בתהליך הקיים, ומשתמשים בגרסאות חדשות עוברים לתשלומים שמבוססים על SDK. משתמשים בשני תהליכי התשלום יכולים להתקיים במקביל במהלך תקופת המעבר.

‫Windows App Bundle

1. כששולחים WAB באמצעות מפעיל של צד שלישי, האם חבילת המשחק נדרשת לבדיקה?

   אפשר לשלוח רק את קובץ ההתקנה, ולא צריך לשלוח את חבילת המשחק כולה. הבודק יוכל להוריד את חבילת המשחק באמצעות קובץ ההתקנה.

   הערה: ההנחיות האלה מיועדות במיוחד למפתחים שמשתמשים בלאנצ'ר של צד שלישי כדי להפעיל את המשחק שלהם.

2. האם יש מגבלות על גודל קובץ ה-WAB?

   בפרסום באמצעות כלי ההתקנה, אפשר להעלות קובץ WAB בגודל של עד 10GB. בפרסום מנוהל ב-Play, הגודל המקסימלי של קובץ WAB הוא 200GB.

3. למה המשחק שלי לא מותקן או לא מופיע אחרי שהעליתי את קובץ ה-WAB?

   אם המשחק שלכם מצורף לתוכנית בלי שיש לו גרסה קיימת למחשב (WAB בפעם הראשונה), יכול להיות שהמערכת תעביר אותו אוטומטית למצב המתנה של פרסום בניהול. הסיבה לכך היא שאין בסיס קיים לעדכון. כדי להשיק את חבילת ה-WAB באופן מלא ולהפוך את המשחק לזמין להתקנה, צריך לעבור אל Google Play Console ולהפעיל באופן ידני את פעולת הפרסום הנדרשת (לדוגמה, ללחוץ על 'פרסום שינויים').

4. איך מעלים את קובץ ה-WAB לבדיקות פנימיות?

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

5. לאן צריך להעלות את חבילת ה-WAB?

   אפשר להעלות את חבילת ה-WAB למיקום שצוין בשאלה הראשונה. עם זאת, אי אפשר לפרסם אותו באופן ידני. עליכם לספק לצוות ה-Backend של Google שעת UTC מדויקת (עד לרמת השעה). לאחר מכן, Google מגדירה את לוח הזמנים לפרסום ומוודאת שהאפליקציה תפורסם בזמן.

PC SDK

1. מה ההבדלים בין Legacy API לבין Google Play Games במחשב SDK?

   • הגרסה הקודמת של ה-API מציעה רק פונקציונליות שקשורה לחיוב.
   • ערכת ה-SDK למחשב תומכת בשירות Google למחשב (GDS) ובתכונות מלאות למחשב.
   • אין צורך בכניסה לחשבון Google דרך הדפדפן באמצעות PC SDK.

2. האם יש דרך חלופית לאתחל את ה-SDK על ידי הפעלת המשחק ישירות באמצעות מרכז המשחקים, בלי לעבור דרך Google Play Games במחשב?

   המשחק צריך להיות מופעל דרך לקוח Google Play Games במחשב. פרטים נוספים מופיעים במאמר הזה למפתחים.

3. האם ה-SDK למחשב תומך בתווים מרובי-בייט בקובץ אישור ה-PEM?

   כן, ערכת ה-SDK תומכת בתווים מרובי-בייט לצורך אימות.

4. איך ה-SDK מטפל בכניסה לחשבון Google עבור כמה מקרים או חשבונות?

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

5. האם שילוב Play Install Referrer פועל עם ה-SDK למחשב?

   ערכת ה-SDK למחשב (גרסה 25.5.409.0 ואילך) תומכת ב-Play Install Referrer API. מידע נוסף זמין במאמר בנושא Play Install Referrer API.

מרכז האפליקציות

1. אם שחקן משתמש ב-launcher של צד שלישי במקום בלקוח Google Play, האם החשבון שלו ב-Play Games Services יסונכרן אוטומטית?

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

2. איך מטפלים באתחול אם Google Play Games מפעיל משגר משחקים של צד שלישי?

   אתם לא נדרשים לשלב את ה-SDK ישירות במרכז האפליקציות. עם זאת, אתם חייבים להעביר את כל הארגומנטים של שורת הפקודה שהמשגר מקבל מלקוח Google Play Games ישירות לתהליך הצאצא שנוצר (קובץ ההפעלה של המשחק). אם האתחול נכשל (לדוגמה, אם מוחזרת השגיאה kActionRequiredShutdownClientProcess), צריך להפסיק את כל התהליכים, כולל את תהליך ההפעלה, כדי שמערכת Google Play Games תוכל לנסות לשחזר את המשחק ולהפעיל אותו מחדש באופן אוטומטי. פרטים נוספים מופיעים בשלב 5 במדריך ההגדרה.

3. איך אפשר לטפל בעדכונים ובתחזוקה של המשחק ושל מרכז ההפעלה אחרי שהוא עובר לשלב הייצור?

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

4. איך כלי ההתקנה מקבל את טוקן הסשן של GPG להפעלה אוטומטית?

   ‫GPG מעביר את טוקן הסשן באמצעות ארגומנט שורת הפקודה --g_session_token=<token> למתקין. כדי להפעיל את ההגדרה הזו, צריך להגדיר את acceptsCommandLineArguments="true" ב-play_publishing_config.xml.

   התוכנה להתקנת המשחק אחראית לחילוץ הטוקן הזה ולשימוש בו כדי להפעיל את המשחק. אם יצירת האסימון נכשלת, GPG מפעיל את קובץ ההתקנה ללא האסימון (חזרה למצב קודם).

אתחול

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

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

2. האם אפשר לעשות שימוש חוזר בפרמטרים של ההפעלה כמה פעמים?

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

3. יש דרך ליצור קיצור דרך כדי לפתוח את המשחק ישירות?

   כדי לפתוח את המשחק ישירות, אפשר להשתמש ב-URI הבא:

   googleplaygames://launch/?pid=2&id=com.company.gamename

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

4. יש דרך לאמת את ההתקנה של Google Play Games במחשב בלי להשתמש ב-SDK?

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

   HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

   הנוכחות של המפתח הזה מציינת ששירותי Google Play Games (שנדרשים להפעלת משחקים במחשב) מותקנים במחשב. אם המפתח חסר, צריך להפנות את המשתמש אל דף ההתקנה של Google Play Games במחשב כדי להוריד ולהתקין את הלקוח.

בדיקה

1. האם יש סביבות בדיקה פתוחות או סגורות שדומות לנייד?

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

2. איך מוסיפים בודקים חדשים?

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

שונות

1. האם אפשר להשתמש ב-VPN?

   למפתחים שצריכים לבדוק את המשחק שלהם באזורים שבהם אין תמיכה ב-Google Play Games במחשב, אנחנו ממליצים להשתמש ב-VPN כדי לקבל כתובת IP מאזור נתמך.

   מוודאים שהפעלתם מצב TUN ב-VPN. הוראות להפעלת מצב TUN ולהגדרת חומת האש מופיעות במדריך למשתמש של ספק ה-VPN.

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

2. איך אפשר להתחיל לפתח משחקים ל-Google Play Games במחשב ב-Unity או ב-UE Editor?

   • מפעילים את מצב פיתוח וממשיכים בבדיקה.
   • מוסיפים את הקבצים manifest.xml ו-.dll. מידע נוסף מופיע במסמכי התיעוד למפתחים.
   • לרשום מזהה GUID של שותף עם גישה מוקדמת למטרות בדיקה.

3. איך משתמשים במפתחות רישום בצורה נכונה?

   צריך ליצור מפתחות רישום על סמך כוורת הבסיס. אפשר להגדיר את hive הבסיסי כ-HKEY_LOCAL_MACHINE או כ-HKEY_CURRENT_USER, בהתאם למטרה ולסוג הנתונים. הכלי HKEY_LOCAL_MACHINE hive משמש כדוגמה בהנחיות.

4. מהן הדרישות לבדיקה של חבילות למחשב על ידי Google?

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

5. האם צריך לשלב את כל ממשקי ה-API?

   לא נדרשים ממשקי API אחרים, אבל הם מציעים יתרונות נוספים. google::play::billing נדרש לרכישות מתוך האפליקציה ולמכירת תוכן דיגיטלי. ‫google::play::install_referrer נדרשת כדי לעקוב אחרי נתוני הפניות ולעזור לכם להבין אילו מקורות תנועה שולחים הכי הרבה משתמשים להורדת האפליקציה. google::play::games::integrity נדרשת כדי להגן על האפליקציה מפני גורמים זדוניים על ידי זיהוי מכשירים שעלולים להיות מסוכנים ואמולטורים לא ידועים.

6. למה חלק מתהליכי המשחק מסתיימים כשסוגרים את לקוח Google Play Games, ואחרים לא?

   ‫Google לא שולטת בתהליכי המשנה או בתהליכים של המשחק שפועל. ההתנהגות תלויה בשאלה אם המשחק הוא משחק Android שמופעל באמצעות אמולטור או משחק למחשב. משחקים שמופעלים באמצעות אמולטור מותקנים בסביבה משלהם, ולכן ההתנהגות שלהם תלויה במידה רבה בהפעלה ובהשבתה של האמולטור.

7. כדאי להשתמש ביכולת ההסרה של Google Play Games או בכלי הסרה מותאם אישית?

   מומלץ להשתמש ביכולת ההסרה של Google Play Games.

עזרה נוספת

אם אתם זקוקים לעזרה נוספת שלא מופיעה בשאלות הנפוצות האלה, אתם יכולים לפנות לכתובת [e-mail]