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 को लोड करना ज़रूरी है. इससे, गेम में कुछ फ़ंक्शन तुरंत उपलब्ध कराने के लिए, दोबारा इस्तेमाल किया जा सकने वाला सैंडबॉक्स वाला एनवायरमेंट बनता है. पब्लिश करने के दौरान इसकी पुष्टि की जाती है. गेम सबमिट करने से पहले, टेस्ट सुइट गाइड का पालन करके इसकी पुष्टि की जा सकती है.

जब आपका गेम स्थानीय तौर पर दिखाया जाता है, तब SDK टूल बिना किसी काम के चलता है. 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 टाइप डेफ़िनिशन

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

गेम के सैंपल

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

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

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