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

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

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

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

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

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

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

एपीआई मैपिंग

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

Google साइन-इन

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

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

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

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

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

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

खरीदारी करें

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

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

खरीदारी का फ़्लो शुरू करना

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

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

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

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

एपीआई वाले समाधान और एसडीके वाले समाधान, दोनों के लिए प्रोसेस एक जैसी होती है:

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

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

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

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

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

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