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

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

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

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

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

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

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

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 को लॉग से जुड़ी समस्याएं भेजें.

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

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

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

सैंपल गेम

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

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

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