שאלות נפוצות

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

מונטיזציה

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

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

  2. האם אפשר להשתמש בתהליך הרכישה בלי שרת בק-אנד?

    מבחינת אבטחה, Google ממליצה להשתמש בשרת בק-אנד.

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

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

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

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

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

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

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

  6. מהי שגיאת החיוב בקריאות לרכישה?

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

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

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

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

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

  9. למה שאילתות של מוצרים או תהליכי רכישה נכשלים עם שגיאות פנימיות כשמנסים לטעון הרבה מק"טים של מוצרים?

    שליחת שאילתות לגבי יותר מדי מק"טים של מוצרים בבת אחת, או קריאה ל-QueryProductDetails ב-C++‎ או ל-QueryProductDetailsAsync ב-Unity ברצף יותר מדי פעמים בפרק זמן קצר (לדוגמה, שליחת עשרות קריאות באצווה בלולאה הדוקה או יצירת מכונה חדשה של BillingClient לכל אצווה) עלולה להעמיס על חיבורי ה-IPC המקומיים והקצה העורפי. כשהחיבורים האלה מתאפסים, שאילתות לגבי פרטי המוצר נכשלות והמשחק לא יכול לקבל את אסימוני המבצעים שנדרשים כדי להפעיל תהליך רכישה.

    כדי למנוע את השגיאות האלה כשאתם טוענים את הקטלוג, כדאי לפעול לפי השיטות הבאות:

    • הקפידו על מספר המוצרים הנתמך לכל קריאה: אל תשלחו שאילתות לגבי יותר מ-50 מוצרים בקריאה אחת של QueryProductDetails או QueryProductDetailsAsync, ושמרו במטמון את ה-ProductDetails שמוחזר בזיכרון במקום לשלוח שוב ושוב שאילתות לגבי הקטלוג המלא. למידע נוסף על המגבלות של קבוצות נתונים נתמכות ועל שליחת שאילתות לגבי פרטי מוצרים, עיינו בשאלה הקודמת בנושא מגבלות ה-API, במאמר הצגת מוצרים שזמינים לרכישה ל-C++‎ ובמאמר שליחת שאילתות לגבי פרטי מוצרים ל-Unity.
    • אל תשלחו יותר מדי קריאות ל-API ברצף בפרק זמן קצר: אל תשלחו כמה קבוצות של שאילתות מוצרים בו-זמנית או ברצף בלי הפסקות. אפשר להשתמש שוב במכונה אחת של BillingClient, להפוך בקשות לסדרתיות או להגביל את מספר הקריאות בו-זמנית לשתיים או שלוש קריאות בכל פעם, ולהוסיף השהיה קצרה בין קבוצות עוקבות.
    • עדכון לגרסה האחרונה של ה-SDK: כדי לוודא שהלקוח כולל את השיפורים האחרונים בחיוב וביציבות של ה-IPC, צריך לעדכן את השילוב לגרסה האחרונה של Google Play Games on PC SDK, גרסה 26.9.261.0 ל-C++‎ או 26.9.261.0 ל-Unity, מדף ההורדות של Play Games PC SDK.
  10. אילו פרמטרים נדרשים כששולחים קריאה ל-Query Purchases או ל-Launch Purchase Flow ב-Billing Client?

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

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

  11. האם אפשר להגדיר סדר מותאם אישית להפעלת תהליך הרכישה ב-Billing Client?

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

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

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

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

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

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

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

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

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

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

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

‫Windows App Bundle‏ (WAB)

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

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

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

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

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

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

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

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

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

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

PC SDK

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

    • ה-API הקודם מציע רק פונקציונליות של חיוב.
    • ערכת ה-SDK למחשב תומכת ב-Google Desktop Service‏ (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 פועל עם PC SDK?

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

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

  1. אם שחקן משתמש במרכז אפליקציות של צד שלישי במקום בלקוח של 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?

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

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

  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 ממליצה להשתמש ביכולת ההסרה של Google Play Games.

עזרה נוספת

אם אתם צריכים עזרה נוספת שלא מופיעה בשאלות הנפוצות האלה, אתם יכולים לפנות אל google-play-games-pc@google.com