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

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

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

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

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

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

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

एपीआई मैपिंग

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

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 ऐप्लिकेशन बंडल में पैक करने के लिए, दस्तावेज़ देखें. ऐसा इन प्लैटफ़ॉर्म के लिए किया जा सकता है: