YouTube Playables SDK टूल - शुरू करें

YouTube Playables SDK, वेब गेम को YouTube के एनवायरमेंट से कनेक्ट करने के लिए एक वेब एसडीके है. इस एसडीके में एक मज़बूत एपीआई होता है, जो YouTube पर गेमिंग का बेहतरीन अनुभव देने के लिए, अलग-अलग तरीकों से गेम को सपोर्ट करता है.

अपने गेम में Playables SDK जोड़ना

किसी गेम की रूट डायरेक्ट्री में index.html फ़ाइल होनी चाहिए. YouTube Playables SDK को इंपोर्ट करें. इसके लिए, अपने गेम कोड से पहले यह लाइन जोड़ें:

<script src="https://www.youtube.com/game_api/v1"></script>

अहम जानकारी: एसडीके को आपके गेम कोड से पहले लोड किया जाना ज़रूरी है. इससे एक ऐसा सैंडबॉक्स एनवायरमेंट बनता है जिसे फिर से बनाया जा सकता है. साथ ही, गेम के लिए कुछ फ़ंक्शन तुरंत उपलब्ध हो जाते हैं. पब्लिश करने के दौरान इसकी पुष्टि की जाती है. गेम सबमिट करने से पहले पुष्टि करने के लिए, टेस्ट सुइट गाइड का पालन किया जा सकता है.

जब आपका गेम स्थानीय तौर पर उपलब्ध कराया जाता है, तब एसडीके टूल कोई कार्रवाई नहीं करता. एसडीके टूल के इंटिग्रेशन की पुष्टि करने के लिए, टेस्ट सुइट गाइड का इस्तेमाल करें.

Playables SDK के साथ इंटिग्रेट करना

Playables SDK के साथ कई ज़रूरी और वैकल्पिक इंटिग्रेशन होते हैं.

ज़रूरी इंटिग्रेशन

पब्लिश करने से जुड़ी सभी ज़रूरी शर्तों को पढ़ें. साथ ही, इंटिग्रेशन से जुड़ी ज़रूरी शर्तों पर खास तौर से ध्यान दें. लागू करने के बारे में ज़्यादा जानकारी के लिए, Playables SDK टूल का रेफ़रंस देखें.

उदाहरण के लिए:

• ytgame.game.firstFrameReady()
• ytgame.game.gameReady()
• ytgame.IN_PLAYABLES_ENV
• ytgame.system.isAudioEnabled()
• ytgame.system.onAudioEnabledChange((isAudioEnabled) => {})
• ytgame.system.onPause(() => {})
• ytgame.system.onResume(() => {})
• ytgame.game.loadData()
• ytgame.game.saveData(data)

सुझाए गए इंटिग्रेशन

ज़रूरी इंटिग्रेशन के अलावा, लोगों की दिलचस्पी बढ़ाने के लिए कई अन्य फ़ंक्शन उपलब्ध हैं. उदाहरण के लिए:

• ytgame.system.getLanguage() - इसका इस्तेमाल, उपयोगकर्ता की मौजूदा स्थान-भाषा की सेटिंग को वापस पाने के लिए करें. भाषा को क्लाउड में सेव करने या अन्य फ़ंक्शन का इस्तेमाल न करें, क्योंकि इसमें कभी भी बदलाव हो सकता है.
• ytgame.engagement.sendScore({ value: newScore }) - YouTube पर दिखाने के लिए, सबसे अच्छा स्कोर भेजें.
• ytgame.engagement.openYTContent({ id: videoID }) - YouTube वीडियो खोलें.
• ytgame.health.logError() और ytgame.health.logWarning() - YouTube को समस्याओं की जानकारी दें.
• ytgame.ads.requestInterstitialAd() और requestRewardedAd(rewardId: string) - अपने गेम में विज्ञापन दिखाने की सुविधाएं जोड़ें.

लागू करने से जुड़ी जानकारी और अन्य फ़ंक्शन के लिए, Playables SDK का रेफ़रंस देखें.

टाइपस्क्रिप्ट टाइप डेफ़िनिशन

TypeScript का इस्तेमाल करने वाले गेम के लिए, टाइप डेफ़िनिशन डाउनलोड करें.

सैंपल गेम

सैंपल उपलब्ध हैं. इनसे पता चलता है कि YouTube Playables SDK के साथ इंटिग्रेट कैसे किया जाता है. इनमें सादा JavaScript, Flutter web, Godot, और Unity शामिल हैं.

टेस्ट सुइट की मदद से अपने गेम को टेस्ट करना

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