परिचय

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 को शामिल करें：

html

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

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

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

javascript

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 के तरीके से कॉल किया जा सकता है：

javascript

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 जानकारी को न चूकें, क्योंकि इसमें आपके द्वारा उपयोग किए जा रहे गेम इंजन के बारे में महत्वपूर्ण जानकारी शामिल है:

यदि आप खिलाड़ी के डिवाइस प्रकार के आधार पर नियंत्रण इंटरफ़ेस को स्वचालित रूप से अनुकूलित करना चाहते हैं, तो deviceType फ़ील्ड का उपयोग करें।
यदि आप इवेंट की निष्पक्षता सुनिश्चित करने के लिए सर्वर समय को गतिशील रूप से सिंक करना चाहते हैं, तो serverTime फ़ील्ड का उपयोग करें।
यदि आप खिलाड़ी की भाषा सेटिंग के आधार पर स्थानीयकरण पाठ को स्वचालित रूप से स्विच करना चाहते हैं, तो language फ़ील्ड का उपयोग करें।
यदि आप बैनर विज्ञापनों की प्रदर्शन आवृत्ति को लचीले ढंग से नियंत्रित करना चाहते हैं, तो bannerIntervalTime फ़ील्ड का उपयोग करें।
यदि आप मल्टीप्लेयर गेम दृश्यों में प्लेटफ़ॉर्म मित्रों को आमंत्रित करने की कार्यक्षमता लागू करना चाहते हैं, तो invateArgs फ़ील्ड का उपयोग करें।
यदि आप विभिन्न OS संस्करणों के लिए अनुकूलता प्रदर्शन को अनुकूलित करना चाहते हैं, तो os फ़ील्ड का उपयोग करें।

javascript

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;//गेम के मध्य में इंटरस्टीशियल विज्ञापन अंतराल प्रदर्शन समय
    "gamePrice": number;//गेम का एक बार खरीद मूल्य
    "invateArgs": number;// निमंत्रण पैरामीटर
}

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

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

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

परिचय ​

शुरुआत ​

SysInfo जानकारी ​

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

परिचय

शुरुआत

SysInfo जानकारी

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