सेटअप और उपयोग
Yandex Games SDK एक लायब्रेरी है जिसका उपयोग आप तृतीय-पक्ष डेवलपर द्वारा बनाए गए गेम को आसानी से Yandex Games प्लेटफ़ॉर्म में एकीकृत करने के लिए कर सकते हैं।
मॉडेरेशन पास करने के लिए SDK जोड़ना एक आवश्यक शर्त है।
SDK से आप निम्नलिखित चीज़ें कर सकते हैं:
- विज्ञापन देना एकीकृत करें।
- फ़ुल स्क्रीन पर अपने आप स्विच करना।
- गेम के दौरान स्क्रीन ओरिएंटेशन सेट करना और डिवाइस की दिशा घुमाने का सुझाव जोड़ना।
इंस्टॉल करें
प्रतिबंध
यांडेक्स के गेम स्टीडियो का लिंक https://yandex.ru/games/sdk/v2
पुराना हो गया है। जिससे आपका खेल सफलतापूर्वक मॉडरेशन पारित कर सके, सीडीके यांडेक्स गेम्स को कनेक्ट करने के लिए वास्तविक लिंक उपयोग करें, प्लेसमेंट मेथड के आधार पर
-
यदि आप अपने गेम का आर्काइव डेवलपर कंसोल में अपलोड कर रहे हैं, तो रिलेटिव पथ दर्ज करें। यह सुझाए गए विकल्प है।
-
यदि आप
iframe
के माध्यम से एक्सटेंशन का उपयोग कर रहे हैं, तो एब्सोल्यूट पथ दर्ज करें।
आप Yandex Games SDK को सिंक्रोनस रूप से या एसिंक्रोनस रूप से जोड़ सकते हैं। दोनों विकल्प बराबर हैं। हालांकि, सिंक्रोनस विधि से आप कॉलबैक प्रकार्य के साथ इंस्टॉलेशन को नियंत्रित कर सकते हैं। वह विधि चुनें जो आपकी आवश्यकता सबसे अच्छे ढंग से पूरी करती हो।
Yandex का सर्वर
नोट
विकास के दौरान /sdk.js
की प्रॉक्सी के लिए लोकल सर्वर का उपयोग करें।
HTML-पेज के head
शीर्षक में निम्नलिखित प्रकार की पंक्ति जोड़ें:
<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>
इस विधि में स्क्रिप्ट के लिए async
, defer
और onload
गुण का उपयोग किया जा सकता है। उदाहरण के लिए:
<script async src="/sdk.js" onload="initSDK()"></script>
HTML-पेज पर निम्न कोड जोड़ें:
<!-- Yandex Games SDK -->
<script>
(function(d) {
var s = d.createElement('script');
s.src = '/sdk.js';
s.async = true;
s.onload = initSDK;
d.body.append(s);
})(document);
</script>
अपना डोमेन
अपने HTML पेज के head
टैग पर निम्नलिखित स्ट्रिंग जोड़ें:
<!-- Yandex Games SDK -->
<script src="https://sdk.games.s3.yandex.net/sdk.js"></script>
HTML पेज पर निम्नलिखित कोड जोड़ें:
<!-- Yandex Games SDK -->
<script>
(function(d) {
var s = d.createElement('script');
s.src = "https://sdk.games.s3.yandex.net/sdk.js";
s.async = true;
s.onload = initSDK;
d.body.append(s);
})(document);
</script>
उपयोग करें
शुरू करने के लिए, YaGames
ऑब्जेक्ट की init
विधि का उपयोग करके SDK को आरंभ करें।
प्रतिबंध
YaGames.init()
और ysdk.getPayments() में आप वैकल्पिक पैरामीटर signed: boolean
पास कर सकते हैं, जो फ्रॉड सुरक्षा के लिए है। इस पैरामीटर का मूल्य इस बात पर निर्भर करता है कि भुगतान कहाँ प्रोसेस किए जाते हैं:
-
अगर क्लाइंट साइड पर — तो इस पैरामीटर के बिना या
signed: false
पास करके मेथड को कॉल करें। भुगतान मेथड्स डेटा को ओपन फॉर्मेट में रिटर्न करेंगे। -
अगर सर्वर साइड पर — तो
signed: true
पास करें। इस स्थिति में payments.getPurchases() और payments.purchase() मेथड्स के प्रतिक्रिया में सभी डेटा सिर्फ एन्क्रिप्टेड फॉर्मेट में signature पैरामीटर में रिटर्न होगा।
डिफ़ॉल्ट पैरामीटर के साथ इनिशियलाइज़ेशन (signed: false
)।
YaGames
.init()
.then(ysdk => {
console.log('Yandex SDK initialized');
window.ysdk = ysdk;
});
signed: true
पैरामीटर के साथ इनिशियलाइज़ेशन।
YaGames
.init({ signed: true })
.then(ysdk => {
console.log('Yandex SDK initialized');
window.ysdk = ysdk;
});
संभावित समस्याएँ
अज्ञात ReferenceError: YaGames स्पष्ट नहीं है
sdk
स्क्रिप्ट कनेक्शन के क्रम पर ध्यान दें: आपके द्वारा YaGames.init()
निष्पादित किए जाने से पहले इसे कनेक्ट होना चाहिए।
अज्ञात ReferenceError: ysdk स्पष्ट नहीं है
आपने SDK के आरंभ होने (Yandex SDK initialized
संदेश कंसोल में दिखना चाहिए) से पहले SDK विधियों (विज्ञापनों या खरीदारियों जैसी चीज़ों के लिए) का उपयोग करने का प्रयास किया था।
यदि आप कॉल क्रम की गारंटी देने का तरीका नहीं जानते, तो SDK उपयोग स्थानों को फिर से लिखें। ऐसा करने के लिए, लाइन को बदलें:
ysdk.adv.showFullscreenAdv()
इसके साथ:
YaGames.init().then(ysdk => ysdk.adv.showFullscreenAdv())
SDK इंस्टॉलेशन उदाहरण
<!-- Yandex Games SDK -->
<script src="/sdk.js"></script>
<script>
YaGames.init().then(ysdk => {
// ...
});
</script>
नोट
टीम सपोर्ट के कर्मचारी यंडेक्स गेम्स प्लेटफॉर्म पर तैयार खेल को डालने में मदद करते हैं। डेवलपमेंट और परीक्षण के संबंध में आवेदनिक प्रश्नों का उत्तर अन्य डेवलपर्स देंगे Discord चैनल।
यदि आप किसी समस्या का सामना कर रहे हैं या Yandex Games SDK के इस्तेमाल के बारे में आपका कोई प्रश्न है, तो कृपया समर्थन से संपर्क करें: