מיגרציה מ-API ל-SDK

אם המשחקים המקוריים שלכם ב-Google Play Games במחשב קוראים ישירות ל-Play Billing APIs, אתם צריכים להעביר את המשחק לשימוש ב-PC SDK.

בהתאם למנוע המשחקים שבו אתם משתמשים, אתם יכולים לשלב את C++ SDK או את C# SDK. אפשר לעיין בפרויקטים לדוגמה שמציגים דוגמאות שאפשר להשתמש בהן כדי להעביר את המשחק המקורי ל-SDK.

הגדרה והכנה

בקטע הזה מוסבר איך לבצע העברה מפתרון מבוסס-API אל Google Play Games on PC Native SDK.

ארגומנטים בשורת הפקודה

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

מיפוי API

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

כניסה באמצעות חשבון Google

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

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

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

קבלת רשימת מוצרים

בפתרון ה-API, שרת הקצה העורפי מאחזר את רשימת המוצרים באמצעות נקודת הקצה inappproduct.gets של Play Developer API.

ב-SDK, מאחזרים את רשימת המוצרים מתוך האפליקציה ישירות בלקוח באמצעות הפונקציה QueryProductDetails.

רכישות

בפתרון ה-API, שרת הקצה העורפי מאחזר רכישות של משתמשים באמצעות נקודת הקצה של Play Developer API‏ purchases.products.get.

ב-SDK, משתמשים בפונקציה QueryPurchases ישירות מלקוח המשחק.

הפעלת תהליך הרכישה

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

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

איך מעבדים את הרכישה

עיבוד הרכישה של המשתמש כולל אישור ושימוש ברכישה אחרי אימות מוצלח של הרכישה. גם בפתרון מבוסס-API וגם בפתרון מבוסס-SDK מומלץ לבצע את השלבים מהקצה העורפי מטעמי אבטחה.

התהליך דומה גם לפתרון מבוסס API וגם לפתרון מבוסס SDK:

אחרי שמחלצים את purchaseToken מהרכישה, כמו ProductPurchase.purchaseToken בפתרון ה-API או ProductPurchaseDetails's purchase_token בפתרון ה-SDK, שולחים אותו לשרת העורפי לצורך אימות.

אחרי האימות, ה-backend יכול לאשר או לנצל את הרכישה באופן מאובטח אחרי מתן ההרשאה.

שליחה לבדיקה

כדי לשלוח את המשחק לבדיקה, פועלים לפי השלבים הבאים.

חבילה לשליחה

משחקים שמשתמשים ב-SDK צריכים להיות ארוזים בפורמט Windows App Bundle ולהיות מועלים דרך Play Console. בתיעוד מוסבר איך לארוז את המשחק ב-Windows App Bundle עבור: