इस दस्तावेज़ में, एसडीके और Google Play Games on PC के लिए पब्लिश करने से जुड़े आम सवालों के जवाब दिए गए हैं.
वीपीएन कैसे जोड़ा जाता है?
अगर डेवलपर को अपने गेम की टेस्टिंग उन इलाकों में करनी है जहां Google Play Games on PC की सुविधा उपलब्ध नहीं है, तो हमारा सुझाव है कि वे वीपीएन का इस्तेमाल करके, ऐसे इलाके का आईपी पता हासिल करें जहां यह सुविधा उपलब्ध है.
पक्का करें कि आपने वीपीएन पर टीयूएन मोड चालू किया हो. टीयूएन मोड चालू करने और फ़ायरवॉल को कॉन्फ़िगर करने के बारे में जानकारी, वीपीएन की सेवा देने वाली कंपनी के ऑपरेटिंग मैन्युअल में मिल सकती है.
टीयूएन मोड चालू होने के बाद, Google Play Games on PC और टेस्टिंग के लिए एम्युलेटर इंस्टॉल करें.
क्या बैकएंड सर्वर के बिना, खरीदारी की प्रोसेस का इस्तेमाल किया जा सकता है?
सुरक्षा के लिहाज़ से, बैकएंड सर्वर के बिना प्रोसेस करने का सुझाव आम तौर पर नहीं दिया जाता.
ज़्यादा जानकारी के लिए, बैकएंड सर्वर के बिना प्रोसेस करना देखें.
Unity या UE Editor में, Google Play Games on PC के लिए डेवलपमेंट कैसे शुरू करें?
- डेवलपर मोड चालू करें और टेस्टिंग जारी रखें.
manifest.xmlऔर.dllफ़ाइलें जोड़ें. ज़्यादा जानकारी के लिए, डेवलपर का दस्तावेज़ देखें.- टेस्टिंग के लिए, सार्वजनिक तौर पर उपलब्ध होने से पहले इस्तेमाल करने का पार्टनर GUID रजिस्टर करें.
Google Play Games ऐप्लिकेशन का इस्तेमाल करके गेम शुरू करने पर, क्या यह आपके Google खाते की जानकारी सिंक करता है
Google Play Games क्लाइंट के ज़रिए गेम लॉन्च करने के बाद, खाता अपने-आप सिंक हो जाता है. इसके बाद, Google की लॉगिन करने की प्रोसेस के ज़रिए फिर से लॉगिन नहीं करना पड़ता.
तीसरे पक्ष के लॉन्चर का इस्तेमाल करके, Windows ऐप्लिकेशन बंडल (WAB) सबमिट करने पर, क्या समीक्षा के लिए गेम पैकेज की ज़रूरत होती है?
आपको सिर्फ़ इंस्टॉलर सबमिट करना होता है. पूरा गेम पैकेज सबमिट करने की ज़रूरत नहीं होती. समीक्षा करने वाला व्यक्ति, इंस्टॉलर का इस्तेमाल करके आपका गेम पैकेज डाउनलोड कर लेता है.
अगर कोई खिलाड़ी Google Play क्लाइंट के बजाय, तीसरे पक्ष के लॉन्चर का इस्तेमाल करता है, तो क्या उसका Play Games की सेवाओं का खाता अपने-आप सिंक हो जाएगा?
एसडीके के फ़ंक्शन को चलाने के लिए, गेम को सीधे Google Play Games क्लाइंट के ज़रिए लॉन्च करना ज़रूरी है. अगर कोई दूसरी प्रोसेस, जैसे कि एक इंस्टॉलर या लॉन्चर ऐप्लिकेशन, गेम शुरू करती है, तो उस प्रोसेस को Google Play Games क्लाइंट से ही लॉन्च किया जाना चाहिए. गेम को क्लाइंट से मिले सभी पैरामीटर, क्लाइंट प्रोसेस को पास करने होंगे.
एसडीके, एक से ज़्यादा इंस्टेंस या खातों के लिए, Google खाते में साइन-इन की सुविधा को कैसे मैनेज करता है?
Google Play Games में हर गेम लॉन्च को "गेम सेशन" माना जाता है. साथ ही, हर "गेम सेशन" से एक खाता जोड़ा जा सकता है. ये खाते अलग-अलग हो सकते हैं. इसलिए, अगर आपने खाता A से गेम लॉन्च किया है और फिर खाता B पर स्विच किया है, तो दोनों खाते एक साथ चल सकते हैं.
क्या WAB (Windows ऐप्लिकेशन बंडल) की फ़ाइल साइज़ पर कोई पाबंदी है?
WAB के लिए, 10 जीबी तक की फ़ाइल अपलोड की जा सकती है.
क्या Google Play Games on PC SDK को इंटिग्रेट करने के बाद, एपीआई पर आधारित मौजूदा पेमेंट सिस्टम इस्तेमाल किए जा सकते हैं?
सभी पेमेंट, Google Play Billing का इस्तेमाल करके, Google Play Games on PC SDK से मैनेज किए जाने चाहिए. एक ही गेम में, एपीआई पर आधारित मौजूदा पेमेंट के तरीके का इस्तेमाल नहीं किया जा सकता.
क्या मोबाइल की तरह, ओपन टेस्टिंग या क्लोज़्ड टेस्टिंग एनवायरमेंट उपलब्ध हैं?
फ़िलहाल, एंड-टू-एंड सैंडबॉक्स उपलब्ध नहीं है. हालांकि, हम समझते हैं कि डेवलपर के लिए, प्रोडक्शन जैसा टेस्टिंग एनवायरमेंट ज़रूरी है. जल्द ही, एक बेहतर समाधान उपलब्ध कराया जाएगा.
क्या हम डेवलपर मोड में शुरू की गई खरीदारी को सही तरीके से इस्तेमाल नहीं कर सकते?
डेवलपर मोड में खरीदारी को तीन मिनट के अंदर इस्तेमाल करना ज़रूरी है. ऐसा न करने पर, हो सकता है कि खरीदारी का रिफ़ंड कर दिया गया हो.
क्या एपीआई (लेगसी) और Google Play Games on PC SDK में कोई अंतर है?
- लेगसी में सिर्फ़ बिलिंग पर फ़ोकस किया गया था
- एसडीके, Google Desktop Service (GDS) और पीसी की सभी सुविधाओं के साथ काम करेगा
- डेवलपर के लिए आसान एसडीके इंटरफ़ेस
- ब्राउज़र पर आधारित Google साइन-इन की ज़रूरत नहीं है
क्या Google Play Games on PC के ज़रिए गेम लॉन्चर का इस्तेमाल किए बिना, सीधे गेम लॉन्चर का इस्तेमाल करके गेम लॉन्च करके एसडीके को शुरू करने का कोई दूसरा तरीका है?
गेम को Google Play Games on PC क्लाइंट के ज़रिए लॉन्च करना होगा. ज़्यादा जानकारी के लिए, डेवलपर का दस्तावेज़ देखें
बार-बार किए जाने वाले पेमेंट या सदस्यताओं की सुविधा उपलब्ध नहीं है. क्या इसे लागू करने की कोई योजना है?
इन-ऐप्लिकेशन खरीदारी के अलावा, खरीदारी के अन्य विकल्प जोड़ने की कोई योजना नहीं है. हालांकि, हम आपसे अनुरोध करते हैं कि आप इस्तेमाल के खास उदाहरणों के साथ अपनी राय दें.
क्या billingerror, खरीदारी की प्रोसेस शुरू करने पर मिलता है या पेमेंट के नतीजे से?
यह पेमेंट के नतीजे का रिस्पॉन्स है. LaunchPurchaseFlow, बिना ब्लॉक किए तुरंत वापस आ जाएगा. हालांकि, आपको यह जानने के लिए कॉलबैक सुनना होगा कि यह कब खत्म हुआ है और नतीजा कैप्चर करना होगा.
क्या गेम को सीधे खोलने के लिए कोई शॉर्टकट बनाया जा सकता है?
गेम को सीधे खोलने के लिए, इस यूआरआई का इस्तेमाल किया जा सकता है:
googleplaygames://launch/?pid=2&id=com.company.gamename
यूआरआई से यह पता लगाया जा सकता है कि Google Play Games on PC क्लाइंट खुला है या नहीं. अगर क्लाइंट खुला नहीं है, तो गेम/लॉन्चर चलने से पहले, Google Play Games क्लाइंट खुल जाता है. एक से ज़्यादा इंस्टेंस को चलने से रोकने के लिए, आपको गेम/लॉन्चर को मैनेज करना होगा.
QueryProductDetails एपीआई के अनुरोध की सीमाएं
QueryProductDetails
एपीआई को एक बार कॉल करके, ज़्यादा से ज़्यादा 50 प्रॉडक्ट के बारे में क्वेरी की जा सकती है. अगर इस सीमा से ज़्यादा प्रॉडक्ट के बारे में क्वेरी करनी है, तो आपको अनुरोध को कई
कॉल में बांटना होगा.
पहला Windows ऐप्लिकेशन बंडल (WAB) अपलोड करने के बाद, मेरा गेम इंस्टॉल क्यों नहीं हो रहा है या दिख नहीं रहा है?
अगर आपका गेम, पीसी के पहले से मौजूद वर्शन के बिना ऑनबोर्ड किया जा रहा है (पहली बार WAB), तो सिस्टम इसे अपने-आप मैनेज किए जाने वाले पब्लिशिंग की होल्डिंग स्थिति में डाल सकता है. ऐसा इसलिए होता है, क्योंकि अपडेट करने के लिए कोई मौजूदा बेसलाइन नहीं होती. WAB को पूरी तरह से रिलीज़ करने और गेम को इंस्टॉल करने के लिए, आपको Google Play Console पर जाना होगा. इसके बाद, पब्लिश करने की ज़रूरी कार्रवाई मैन्युअल तरीके से करनी होगी. उदाहरण के लिए, "बदलाव पब्लिश करें" पर क्लिक करें.
अगर Google Play Games, तीसरे पक्ष का गेम लॉन्चर लॉन्च करता है, तो एसडीके को शुरू करने की प्रोसेस कैसे मैनेज की जाती है?
एसडीके को सीधे अपने लॉन्चर में इंटिग्रेट करना ज़रूरी नहीं है. हालांकि, आपको Google Play Games क्लाइंट से लॉन्चर को मिले सभी कमांड-लाइन आर्ग्युमेंट, सीधे तौर पर स्पॉन की गई चाइल्ड प्रोसेस (गेम एक्ज़ीक्यूटेबल) को पास करने होंगे. अगर एसडीके को शुरू करने में गड़बड़ी होती है (उदाहरण के लिए, kActionRequiredShutdownClientProcess दिखाने पर), तो लॉन्चर समेत सभी प्रोसेस को बंद करना होगा. इससे Google Play Games, गेम को अपने-आप ठीक करके फिर से लॉन्च कर सकता है. ज़्यादा जानकारी के लिए, सेटअप गाइड में पांचवां चरण देखें.
क्या खरीदारी की प्रोसेस के दौरान, पेमेंट किए बिना ब्राउज़र बंद करने पर, टाइम आउट की गड़बड़ी दिखना सामान्य है?
हां, यह एक जानी-मानी समस्या है. साथ ही, ब्राउज़र पर आधारित मौजूदा प्रोसेस में ऐसा होना सामान्य है. Google, खरीदारी की एक ऐसी सुविधा पर काम कर रहा है जो WebView पर आधारित होगी. इससे पेमेंट की प्रोसेस गेम के अंदर ही पूरी की जा सकेगी. साथ ही, टाइम आउट की समस्या भी ठीक हो जाएगी.
क्या नेटिव पीसी एसडीके, सर्टिफ़िकेट फ़ाइल (PEM) में मल्टीबाइट वर्णों के साथ काम करता है?
हां, एसडीके, सर्टिफ़िकेट के लिए मल्टीबाइट वर्णों के साथ काम करता है.
BillingClient::QueryPurchases या BillingClient::LaunchPurchaseFlow को कॉल करते समय, किन पैरामीटर की ज़रूरत होती है?
यह फ़ंक्शन, QueryPurchasesContinuation को स्वीकार करता है. यह
std::function<void(QueryPurchasesResult)> सिग्नेचर वाला फ़ंक्शन कॉलबैक है. कॉलबैक, ProductPurchaseDetails के साथ आपको नतीजा पास करता है. यह जानकारी, includes/billing/models.h फ़ाइल में, एसडीके की हेडर फ़ाइलों में उपलब्ध है.
नतीजे में मिलने वाले launch_purchase_flow_result में, ok() और code() फ़ंक्शन होते हैं.
ok() फ़ंक्शन से पता चलता है कि प्रोसेस पूरी हुई है या नहीं. code() फ़ंक्शन, BillingError enum (includes/billing/enums.h) दिखाता है. इसमें गड़बड़ी की 10 संभावित स्थितियां होती हैं. जैसे, उपयोगकर्ता ने रद्द कर दिया या नेटवर्क में गड़बड़ी.
क्या BillingClient::LaunchPurchaseFlow() को कॉल करके, कस्टम ऑर्डर नंबर पास किया जा सकता है?
एसडीके के मौजूदा डिज़ाइन में, अपना पेलोड पास करने का कोई तरीका नहीं है.
हालांकि, obfuscated_account_id और obfuscated_profile_id का कोई भी कॉम्बिनेशन दिया जा सकता है. इनमें से कोई भी आईडी न दें, सिर्फ़ एक आईडी दें या दोनों आईडी दें.
offer_token फ़ील्ड ज़रूरी है. इससे उस खरीदारी के ऑफ़र के बारे में पता चलता है जिसे उपयोगकर्ता, चेकआउट की प्रोसेस में खरीदने की कोशिश कर रहा है. फ़िलहाल, Google Play पर मौजूद हर एसकेयू के लिए, सिर्फ़ एक ऑफ़र उपलब्ध है. उदाहरण के लिए, 10 डॉलर में एक आइटम खरीदें. आने वाले समय में, Play की बिलिंग टीम एक से ज़्यादा ऑफ़र की सुविधा उपलब्ध कराएगी.
खरीदारी की प्रोसेस में रुकावट आने पर, यह पक्का करने के लिए कि मेटाडेटा जुड़ा हो, खरीदारी का डायलॉग लॉन्च करने से पहले, अपने बैकएंड सर्वर पर मेटाडेटा सेव करें. साथ ही, इसे उपयोगकर्ता के खाते की आईडी, खरीदे जा रहे एसकेयू, और मौजूदा टाइमस्टैंप से जोड़ें. ज़्यादा जानकारी के लिए, खरीदारी को इंटरनल डेटा से जोड़ना देखें.
क्या Play Install Referrer इंटिग्रेशन काम करता है?
एसडीके का नया वर्शन (25.5.409.0 और इसके बाद के वर्शन), Play Install Referrer API के साथ काम करता है. ज़्यादा जानकारी के लिए, Play Install Referrer API देखें.
क्या खरीदारी करने के लिए, हर गेम में अलग से साइन इन करना ज़रूरी है?
Google Play Games में फ़ोरग्राउंड खाते का इस्तेमाल, हर गेम सेशन के लिए किया जाता है. इसलिए, आपको फिर से साइन इन करने की ज़रूरत नहीं है. गेम सेशन शुरू होने पर, Google Play Games में जिस खाते का इस्तेमाल किया जाता है, उसी खाते से एपीआई कॉल किए जाते हैं. ब्राउज़र में खरीदारी की प्रोसेस लॉन्च करने पर, आपको साइन इन करना होगा. साथ ही, उसी खाते का इस्तेमाल करना होगा जिसका इस्तेमाल गेम सेशन के लिए किया जा रहा है. अगर उपयोगकर्ता किसी दूसरे खाते से साइन इन करता है, तो वेब फ़्लो में उसे खाते बदलने के लिए कहा जाता है.
OAuth के साथ Google की बिलिंग से, DLL के साथ Google की नेटिव बिलिंग पर स्विच करने के लिए, ज़रूरी शर्तें क्या हैं?
साइन इन किए गए खाते को मैनेज करने के लिए, गेम, Google के साथ OAuth साइन-इन का इस्तेमाल जारी रख सकते हैं. हालांकि, Google का सुझाव है कि आप बिलिंग के लेगसी REST एपीआई का इस्तेमाल बंद कर दें. REST बिलिंग एपीआई (OAuth2 साइन-इन के साथ) से एसडीके फ़्लो पर स्विच करना, फ़ीचर-फ़्लैग की गई कार्रवाई हो सकती है. इसलिए, गेम के स्विच होने तक, दोनों कुछ समय के लिए साथ-साथ काम कर सकते हैं.
क्या पेमेंट के अनुरोध का एपीआई (LaunchPurchaseFlow), वेब ब्राउज़र के ज़रिए प्रोसेस किया जाता है?
हां, फ़िलहाल इसे ब्राउज़र के ज़रिए प्रोसेस किया जाता है. Google की योजना है कि एसडीके की मदद से, गेम से बाहर निकले बिना पूरी प्रोसेस को पूरा किया जा सके.
क्या एसडीके को शुरू करने के पैरामीटर को एक से ज़्यादा बार इस्तेमाल किया जा सकता है?
ऐसा तब तक किया जा सकता है, जब तक Google Play Games क्लाइंट चल रहा है और लॉगिन की जानकारी मान्य है. हालांकि, गाइड में बताए गए जैसे मामलों में, गेम से लॉन्च की गई सभी प्रोसेस को बंद करना होगा. ऐसा तब करना होगा, जब उपयोगकर्ता गेम बंद कर देता है या एसडीके को शुरू करने में गड़बड़ी की वजह से गेम बंद हो जाता है. जैसे, kActionRequiredShutdownClientProcess.
क्या HKEY_LOCAL_MACHINE के बजाय, HKEY_CURRENT_USER में मौजूद रजिस्ट्री की का इस्तेमाल किया जा सकता है?
आपको रूट हाइव के आधार पर रजिस्ट्री की बनानी चाहिए. अपने मकसद और डेटा के टाइप के हिसाब से, रूट हाइव को HKEY_LOCAL_MACHINE या HKEY_CURRENT_USER के तौर पर सेट किया जा सकता है. दिशा-निर्देशों में, HKEY_LOCAL_MACHINE हाइव का इस्तेमाल उदाहरण के तौर पर किया गया है.
क्या कोई गेम, नेटिव एसडीके और पेमेंट के लेगसी सिस्टम, दोनों के साथ एक ही समय पर काम कर सकता है?
पेमेंट सिस्टम, गेम के बाइनरी वर्शन के आधार पर, डुअल-फ़्लो मॉडल के तहत काम करता है. लेगसी बिल्ड का इस्तेमाल करने वाले लोग, मौजूदा फ़्लो पर बने रहते हैं. वहीं, नए बिल्ड का इस्तेमाल करने वाले लोग, एसडीके पर आधारित पेमेंट पर ट्रांज़िशन करते हैं. ट्रांज़िशन की अवधि के दौरान, दोनों पेमेंट फ़्लो का इस्तेमाल करने वाले लोग साथ-साथ काम कर सकते हैं.
इंटरनल टेस्टिंग के लिए WAB कैसे अपलोड किया जाता है?
अनुमति वाली सूची में शामिल खातों को Google के साथ शेयर करें, ताकि Google उन्हें इंटरनल टेस्टिंग के लिए चालू कर सके. सूची मिलने के बाद, Google यह पक्का करता है कि उन्हें ऑनबोर्डिंग की प्रोसेस में शामिल किया जाए.
नए टेस्टर कहां जोड़े जाते हैं?
Google का आपका पॉइंट ऑफ़ कॉन्टैक्ट, पीसी के हर प्रोजेक्ट के लिए एक ईमेल ग्रुप बनाता है. इसमें टेस्टर के Google खाते जोड़े जाने चाहिए. सिर्फ़ इस ईमेल ग्रुप के सदस्य, Google Play Games में टेस्ट पैकेज डाउनलोड कर सकते हैं.
औपचारिक लॉन्च से पहले, पीसी के ऑफ़िशियल पैकेज को कहां अपलोड किया जाना चाहिए?
WAB पैकेज को, पहले सवाल में बताई गई जगह पर अपलोड किया जा सकता है. हालांकि, इसे मैन्युअल तरीके से पब्लिश नहीं किया जा सकता. आपको Google के बैकएंड स्टाफ़ को सटीक यूटीसी टाइम (घंटे तक) देना होगा. इसके बाद, Google रिलीज़ शेड्यूल कॉन्फ़िगर करता है और यह पक्का करता है कि इसे समय पर पब्लिश किया जाए.
औपचारिक लॉन्च के बाद, अपग्रेड और रखरखाव कैसे मैनेज किए जाते हैं?
इसके बाद के अपग्रेड और रखरखाव, आपके लॉन्चर के ज़रिए लागू किए जाने चाहिए. Google Play Games क्लाइंट, अपडेट फ़ंक्शन के साथ काम नहीं करता. इसलिए, लॉन्चर में गेम और लॉन्चर, दोनों को अपडेट करने की क्षमता होनी चाहिए.
पीसी पैकेज की समीक्षा के लिए, Google की ज़रूरी शर्तें क्या हैं?
पीसी पैकेज की मैलवेयर स्कैनिंग की जाती है. इसके बाद, समीक्षक सिर्फ़ गेम इंस्टॉल करने, गेम के सही तरीके से शुरू होने, और अनइंस्टॉल करने की प्रोसेस की जांच करते हैं.
क्या सभी एपीआई को इंटिग्रेट करना ज़रूरी है?
अन्य एपीआई ज़रूरी नहीं हैं. हालांकि, इनसे अतिरिक्त फ़ायदे मिलते हैं.
इन-ऐप्लिकेशन खरीदारी और डिजिटल कॉन्टेंट बेचने के लिए, google::play::billing ज़रूरी है. रेफ़रल डेटा ट्रैक करने के लिए, google::play::install_referrer ज़रूरी है. इससे आपको यह समझने में मदद मिलती है कि आपके ऐप्लिकेशन को डाउनलोड करने के लिए, सबसे ज़्यादा उपयोगकर्ता किस ट्रैफ़िक सोर्स से आते हैं. संभावित जोखिम वाले डिवाइसों और अज्ञात एम्युलेटर की पहचान करके, अपने ऐप्लिकेशन को गलत लोगों से बचाने के लिए, google::play::games::integrity ज़रूरी है.
Google Play Games क्लाइंट बंद होने पर, कुछ गेम प्रोसेस क्यों बंद हो जाती हैं, जबकि कुछ नहीं होतीं?
Google, चल रहे गेम की सब-प्रोसेस या प्रोसेस को कंट्रोल नहीं करता. यह इस बात पर निर्भर करता है कि गेम, Android का एम्युलेट किया गया गेम है या पीसी का नेटिव गेम. एम्युलेट किए गए गेम, अपने एनवायरमेंट में इंस्टॉल किए जाते हैं. इसलिए, उनका व्यवहार मुख्य रूप से एम्युलेटर को शुरू और बंद करने पर निर्भर करता है.
क्या आपको Google Play Games की अनइंस्टॉल करने की सुविधा का इस्तेमाल करना चाहिए या कस्टम अनइंस्टॉलर का?
Google का सुझाव है कि Google Play Games की अनइंस्टॉल करने की सुविधा का इस्तेमाल करें.
क्या Google Play Games on PC के लिए, क्लाइंट साइड खरीदारी की सुविधा का इस्तेमाल किया जा सकता है?
Google का सुझाव है कि सर्वर साइड खरीदारी और उसकी पुष्टि की प्रोसेस का इस्तेमाल करें. अपने क्लाइंट ऐप्लिकेशन से खरीदारी की प्रोसेस करने के लिए, आपका गेम अनुमति वाली सूची में शामिल होना चाहिए. अगर आपके गेम को ऐक्सेस की ज़रूरत है, तो कृपया अपने Google पार्टनर से संपर्क करें. ज़्यादा जानकारी के लिए, बैकएंड सर्वर के बिना प्रोसेस करना देखें.