एपीआई से एसडीके पर माइग्रेट करना

अगर पीसी के लिए Google Play Games पर उपलब्ध आपके नेटिव गेम, सीधे तौर पर Play Billing API को कॉल करते हैं, तो आपको अपने गेम को पीसी एसडीके का इस्तेमाल करने के लिए माइग्रेट करना होगा.

आपके पास इस्तेमाल किए जा रहे गेम इंजन के हिसाब से, C++ SDK या C# SDK को इंटिग्रेट करने का विकल्प होता है. सैंपल प्रोजेक्ट देखें. इनमें ऐसे उदाहरण दिए गए हैं जिनका इस्तेमाल करके, अपने नेटिव गेम को एसडीके टूल पर माइग्रेट किया जा सकता है.

सेटअप और तैयारी

इस सेक्शन में, एपीआई पर आधारित समाधान से Google Play Games on PC के नेटिव एसडीके पर माइग्रेट करने का तरीका बताया गया है.

कमांड-लाइन आर्ग्युमेंट

पीसी के लिए Google Play Games का नेटिव SDK, उपयोगकर्ताओं की पुष्टि करने के लिए, गेम प्रोसेस के स्टार्टअप के दौरान पास किए गए कुछ कमांड-लाइन आर्ग्युमेंट पर निर्भर करता है. इन आर्ग्युमेंट को उस प्रोसेस में पास करना होगा जो InitializeSDK को कॉल करती है. अगर आपके गेम को शुरू करने में एक से ज़्यादा प्रोसेस शामिल हैं, तो आपको यह पुष्टि करनी होगी कि सभी आर्ग्युमेंट उस प्रोसेस को पास किए गए हैं जो आखिर में एसडीके टूल का इस्तेमाल करती है. सेटअप के एक से ज़्यादा गेम प्रोसेस के साथ काम करने की सुविधा वाला चरण देखें.

एपीआई मैपिंग

माइग्रेशन पूरा करने के लिए, आपको Play सर्वर को किए गए सभी डायरेक्ट एपीआई कॉल हटाने होंगे. SDK में, इसी तरह के फ़ंक्शन कॉल मौजूद होते हैं, ताकि एक जैसी सुविधाएं मिल सकें. इस सेक्शन में, हर सुविधा के लिए मैपिंग दी गई है.

Google साइन-इन

Google साइन-इन को Google से साइन इन करें के नाम से भी जाना जाता है. यह OAuth की पुष्टि करने का एक तरीका है. इससे उपयोगकर्ताओं को अपने Google खाते से, एक क्लिक में पुष्टि करने का विकल्प मिलता है. एपीआई पर आधारित प्रोजेक्ट में, किसी खिलाड़ी के खाते को उसकी खरीदारी से जोड़ा जाता है. एसडीके पर आधारित समाधानों के लिए, इस तरह के जुड़ाव की ज़रूरत नहीं होती.

एसडीके पर आधारित समाधान, Google Play Games क्लाइंट के उस Google खाते का इस्तेमाल करते हैं जो पहले से ही खिलाड़ी की गेमर प्रोफ़ाइल और एनटाइटलमेंट से जुड़ा होता है. इससे खिलाड़ियों को बेहतर अनुभव मिलता है. साथ ही, डेवलपर के लिए ज़्यादा सुरक्षित माहौल मिलता है, क्योंकि एसडीके, आईपीसी के ज़रिए Google Play Games क्लाइंट के साथ सुरक्षित तरीके से कम्यूनिकेट कर सकता है.

Google से साइन इन करने के बजाय, InitializeSDK को जल्द से जल्द कॉल करें. अपने गेम के रनटाइम के लिए सुरक्षित माहौल उपलब्ध कराने के लिए, गड़बड़ी कोड के हिसाब से कार्रवाई करें.

प्रॉडक्ट की सूची पाना

एपीआई समाधान में, आपका बैकएंड सर्वर Play Developer API inappproduct.gets एंडपॉइंट का इस्तेमाल करके, प्रॉडक्ट की सूची को फिर से हासिल करता है.

एसडीके में, QueryProductDetails फ़ंक्शन का इस्तेमाल करके, ऐप्लिकेशन में मौजूद प्रॉडक्ट की सूची को सीधे तौर पर क्लाइंट पर पाएं.

खरीदारी करना

एपीआई के समाधान में, आपका बैकएंड सर्वर, Play डेवलपर एपीआई purchases.products.get एंडपॉइंट का इस्तेमाल करके, उपयोगकर्ता की खरीदारी की जानकारी वापस पाता है.

एसडीके में, QueryPurchases फ़ंक्शन का इस्तेमाल सीधे तौर पर अपने गेम क्लाइंट से करें.

परचेज़ फ़्लो लॉन्च करना

एपीआई समाधान में, खरीदारी का फ़्लो लॉन्च करने के लिए, सेटअप करने और ज़रूरी टोकन पाने के लिए कई एंडपॉइंट को कॉल करना पड़ता है.

एसडीके में, BillingClient के LaunchPurchaseFlow फ़ंक्शन को कॉल करके प्रोसेस लॉन्च करें. एसडीके, सभी ज़रूरी काम करता है.

खरीदारी की प्रोसेस पूरी करना

उपयोगकर्ता की खरीदारी को प्रोसेस करने का मतलब है कि खरीदारी की पुष्टि करने के बाद, उसे स्वीकार किया जाए और उसका इस्तेमाल किया जाए. एपीआई और एसडीके, दोनों समाधानों में सुरक्षा के लिए, बैकएंड से पूरे किए जाने वाले चरणों के बारे में सुझाव दिए जाते हैं.

एपीआई और एसडीके, दोनों के लिए यह प्रोसेस एक जैसी है:

खरीदारी से purchaseToken पाने के बाद, जैसे कि एपीआई समाधान में ProductPurchase.purchaseToken या एसडीके समाधान में ProductPurchaseDetails का purchase_token, इसे पुष्टि के लिए अपने बैकएंड पर भेजें.

पुष्टि हो जाने के बाद, आपका बैकएंड सुरक्षित तरीके से खरीदारी की पुष्टि कर सकता है या एनटाइटलमेंट देने के बाद खरीदारी का इस्तेमाल कर सकता है.

टेस्टिंग के लिए सबमिट करना

अपने गेम को टेस्टिंग के लिए सबमिट करने के लिए, यह तरीका अपनाएं.

सबमिट करने के लिए पैकेज

एसडीके का इस्तेमाल करने वाले गेम को Windows ऐप्लिकेशन बंडल फ़ॉर्मैट में पैक किया जाना चाहिए. साथ ही, उन्हें Play Console के ज़रिए अपलोड किया जाना चाहिए. अपने गेम को Windows ऐप्लिकेशन बंडल में पैकेज करने के लिए, दस्तावेज़ देखें. यह दस्तावेज़ इनके लिए है: