परिचय

JOGOS_SDK को एकीकृत करने से पहले，हमारी आवश्यकताओं का पालन अवश्य करें。 यह आपको JOGOS_SDK को最佳 तरीके से उपयोग करने में मदद करेगा，और तकनीकी、गेम सामग्री、विज्ञापन और खाता एकीकरण आवश्यकताओं के संबंध में आपको मार्गदर्शन प्रदान करेगा। Unity और Cocos के अलावा जो विशेष SDK का उपयोग कर सकते हैं，आपके अन्य इंजन HTML5 संस्करण के माध्यम से इन कार्यक्षमताओं को एकीकृत कर सकते हैं，क्योंकि अधिकांश WebGL का समर्थन करने वाले गेम इंजन ब्राउज़र में चलते समय JavaScript के साथ इंटरैक्ट करने के तरीके रखते हैं।

JOGOS_SDK में निम्नलिखित मॉड्यूल शामिल हैं：

मॉड्यूल	说明	SDK समर्थन	एकीकरण सुझाव
JOGOS_SDK.init	SDK को आरंभ करें	🟩 पूरी तरह से समर्थित	☑️आवश्यक एकीकरण，नीचे विस्तार से说明
JOGOS_SDK.game	गेम व्यवहार	🟩 पूरी तरह से समर्थित	☑️ आवश्यक，हमें बताइए कि आपका गेम लोड हो रहा है、शुरू हो रहा है या रुका हुआ है
JOGOS_SDK.user	लॉग इन किए गए उपयोगकर्ता के साथ इंटरैक्ट करना	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि उपयोगकर्ता सिस्टम का उपयोग करते हैं तो आवश्यक है
JOGOS_SDK.banner	गेम内 बैनर विज्ञापन	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि आपके गेम内 बैनर विज्ञापन हैं
JOGOS_SDK.ad	प्रोत्साहित वीडियो और इंटरस्टिशियल	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि आपके गेम内 वीडियो विज्ञापन हैं
JOGOS_SDK.data	क्लाउड स्टोरेज	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि आपको Jogos क्लाउड स्टोरेज का उपयोग करने की आवश्यकता है
JOGOS_SDK.friend	मित्र और समूह	🟦 जल्द ही लॉन्च होगा	🔳अनिवार्य नहीं，यदि आपके गेम内 खिलाड़ी इंटरैक्शन सिस्टम का उपयोग करने की आवश्यकता है
JOGOS_SDK.payment	इन-ऐप खरीद और买断制	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि आपके गेम内 इन-ऐप खरीद या买断制 है
JOGOS_SDK.active	उपलब्धियां और रैंकिंग पट्टी	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि Jogos की उपलब्धियों और रैंकिंग पट्टी सिस्टम का उपयोग करने की आवश्यकता है
JOGOS_SDK.cdkey	रिडीम कोड फ़ंक्शन	🟩 पूरी तरह से समर्थित	🔳अनिवार्य नहीं，यदि आपके लिए Jogos द्वारा CDkey का प्रबंधन करने की आवश्यकता है
JOGOS_SDK.gameItem	आइटम और दुकान	🟩 पूरी तरह से समर्थित	🔳सिंगल-प्लेयर में Jogos द्वारा आइटम प्रबंधन और भुगतान हेतु अनावश्यक
JOGOS_SDK.room	युद्ध कक्ष	🟨 अस्थायी रूप से समर्थित नहीं	🔳LAN मल्टीप्लेयर समर्थित और प्लेटफ़ॉर्म द्वारा ऑनलाइन कमरे प्रदान होने पर अनावश्यक

शुरुआत

यह खंड बताता है कि इंजन में JOGOS_SDK को कैसे शुरू और चलाया जाए।

कृपया गेम की index.html फ़ाइल के body के अंदर निम्नलिखित स्क्रिप्ट को जोड़कर JOGOS_SDK को शामिल करें：

<script src="https://www.jogos.com/sdk/jogos-sdk-v1.js"></script>

मैन्युअल आरंभीकरण

JOGOS_SDK का उपयोग करने के लिए इसे पहले आरंभीकृत करना आवश्यक है। JOGOS_SDK.init विधि को कॉल करके आरंभीकरण पूरा करें：

let systemInfo = await window.JOGOS_SDK.init();

JOGOS_SDK.init विधि असिंक्रोनस है，और JOGOS_SDK.init विधि के सफलतापूर्वक निष्पादन से पहले कोई अन्य विधि उपलब्ध नहीं होगी। हम आपको गेम शुरू होने से पहले यह कार्य करने की强烈 सलाह देते हैं।

यदि JOGOS_SDK.init विधि को सफलतापूर्वक कॉल करने से पहले कोई अन्य विधि को कॉल किया जाता है，तो यह अपवाद फेंक देगा "460 Can only be called after the successful call of the JOGOS_SDK.init method"

Promise

JOGOS_SDK में अधिकांश विधियां असिंक्रोनस हैं，जिन्हें await के तरीके से कॉल किया जा सकता है：

try {
const user = await JogosSDK.getUser();
console.log(user);
} catch (err) {
console.log('उपयोगकर्ता प्राप्त करने में विफलता：', err);
}
//समान Promise कॉलिंग विधि：
JogosSDK
.getUser()
.then((user) => console.log(user))
.catch((err) => console.log('उपयोगकर्ता प्राप्त करने में विफलता：', err));

उदाहरण परिदृश्य संदर्भ के लिए डाउनलोड करें：HTML5_Demo.zip

SysInfo जानकारी

जब आरंभीकरण सफलतापूर्वक कॉलबैक करता है，तो आप SysInfo जानकारी प्राप्त कर सकते हैं，कृपया इस भाग को न छोड़ें，जिसमें आपके द्वारा उपयोग किए जा रहे गेम इंजन के बारे में महत्वपूर्ण जानकारी शामिल है；आप प्लेटफॉर्म उपयोगकर्ता द्वारा वर्तमान में उपयोग किए जा रहे भाषा प्रकार को प्राप्त कर सकते हैं；खिलाड़ियों को आपके गेम में प्रवेश करने के समय स्वचालित रूप से स्थानीयकृत भाषा से मेल खाने दें。 अपने गेम内 वास्तविक सर्वर समय को अपडेट करें आदि।

SysInfo{
    "gameId": number；//गेम Id
    "hasGameGroup":bool；//क्या ग्रुप चैट सक्षम है
    "deviceType": "desktop" ；// possible values: "desktop", "tablet", "mobile"
    "language": string；//भाषा प्रकार
    "os":"Windows 10"；//सिस्टम और संस्करण
    "browser":"Chrome 10.0"；//ब्राउज़र और संस्करण
    "serverTime": number；//वर्तमान सर्वर समय
    "bannerIntervalTime": number;//गेम बैनर विज्ञापन अंतराल प्रदर्शन समय
    "MidgameIntervalTime": number;//गेम के मध्य में इंटरस्टीशियल विज्ञापन अंतराल प्रदर्शन समय
}

विकास और परीक्षण

विकास प्रक्रिया में，आप विभिन्न वातावरणों में JOGOS_SDK को निष्पादित करेंगे：

• localhost स्थानीय डिबगिंग विकास के समय，JOGOS_SDK वीडियो विज्ञापन/बैनर और अन्य व्यवहारों का अनुकरण करने का प्रयास करेगा，और यह सेवा के साथ इंटरैक्ट नहीं करेगा या वास्तविक विज्ञापन लोड नहीं करेगा।
• प्रीव्यू टूल हमारे QA वातावरण में वास्तविक प्रीव्यू और डिटेक्शन फ़ंक्शन प्रदान करता है। गेम JOGOS_SDK को एकीकृत करने के बाद，डेवलपर पोर्टल पर नया गेम बनाकर और संबंधित गेम संसाधन फ़ाइलें अपलोड करने के बाद，आप अपने गेम का प्रीव्यू देख सकते हैं।