एसडीके विधाएं

आवश्यकता का बिंदु 1.19

यांडेक्स गेम्स SDK का प्रारंभिकीकरण और इसकी विधियों का उपयोग सख्ती से दस्तावेज़ीकरण और खेल के लिए निर्धारित आवश्यकताओं के अनुसार किया जाता है:

  1. SDK का प्रारंभिकीकरण सख्ती से उस पृष्ठ पर बताए अनुसार किया जाता है जो SDK की स्थापना और उपयोग है।

  2. जिस क्षण से उपयोगकर्ता खेलने का आरंभ कर सकता है, gameReadyAPI से ready() विधि को बुलाया जाना चाहिए।

  3. GameplayAPI का उपयोग वैकल्पिक होता है, इसके साथ ही यदि खेल में GameplayAPI की विधियों का उपयोग किया जाता है, तो start() और stop() संदेश भेजने के क्षण सख्ती से गेमप्ले अनुभाग में वर्णित के अनुसार होने चाहिए।

  4. game_api_pause और game_api_resume संबंधित घटनाओं की ट्रैकिंग वैकल्पिक है, फिर भी यदि गेम में ysdk.on() और ysdk.off() मेथड्स का उपयोग किया जा रहा है, तो घटनाओं की प्रोसेसिंग लॉजिक सीधे पौज़ और गेम फिर से शुरू की घटनाएं अनुभाग में वर्णित अनुसार होती है।

SDK का प्रारंभिकीकरण

1.19.1. SDK का प्रारंभिकीकरण सख्ती से उस पृष्ठ पर बताए अनुसार किया जाता है जो SDK की स्थापना और उपयोग है। इस आवश्यकता को पूरा माना जाता है, तब जब वर्तमान लोडर का उपयोग किया जाता है।

लोडर की वर्तमानता की जाँच

  1. गेम को डीबग-पैनल के साथ प्रारंभ करें।

    1. यांडेक्स गेम्स कंसोल खोलें.
    2. आवश्यक गेम चुनें।
    3. बायें ऊपरी कोने में Open with debug panel पर क्लिक करें।
    1. आवश्यक गेम खोलें।
    2. ब्राउज़र के पते की पट्टी के अंत में &debug-mode=16 जोड़ें।

  2. डीबग-पैनल पर बाएँ तरफ, Game Ready संकेतक के पास, दो अक्षर खोजें:

    • IF (init false) — खेल पुराने लोडर का समर्थन करता है। IF पर कर्सर ले जाने पर Is loader: false लिखा हुआ दिखाई देगा।

    • IT (init true) — खेल नया लोडर समर्थन करता है। जब IT पर कर्सर ले जाया जाता है, तब Is loader: true का लेबल दिखाई देता है।

उदाहरण

लोडर

टिप्पणी

पुराना लोडर। डिबग पैनल पर IF दिखाई देता है।

पुराना लोडर। डिबग पैनल पर IF दिखाई देता है।

नया लोडर। डिबग पैनल पर IT दिखाई देता है।

नया लोडर। डिबग पैनल पर IT दिखाई देता है।

Game Ready

1.19.2. जब उपयोगकर्ता खेल शुरू करने के लिए तैयार हो, Game Ready से LoadingAPI.ready() मेथड को कॉल करें।

मेथड LoadingAPI.ready() को कॉल करने पर ही इस आवश्यकता को पूरा माना जाएगा, यह सही समय पर किया जाना चाहिए।

Game Ready की जाँच तर्क

तैयारी

  1. डिबग पैनल के साथ खेल शुरू करें।

    1. यांडेक्स गेम्स कंसोल खोलें.
    2. आवश्यक गेम चुनें।
    3. बायें ऊपरी कोने में Open with debug panel पर क्लिक करें।
    1. आवश्यक गेम खोलें।
    2. ब्राउज़र के पते की पट्टी के अंत में &debug-mode=16 जोड़ें।

  2. डिबग पैनल पर Game Ready इंडिकेटर ढूँढें .

सत्यापन का सामान्य सिद्धांत

  1. जांचें कि नीला संकेतक 90 सेकंड के भीतर हरे रंग में बदल गया है या नहीं।
  2. गेम को पुनः आरंभ करें।
  3. फिर से जांचें कि संकेतक किस क्षण रंग बदलता है।

Game Ready सही तरीके से काम कर रहा है

नीला संकेतक हरे रंग में उस समय बदल गया जब:

  • मेन्यू उपलब्ध होता है;

  • जब खेल संवाद के लिए उपलब्ध होता है (प्रारंभिक एनिमेशन सहित)।

Game Ready

कमेंट

मेन्यू उपलब्ध होने के समय हरा संकेतक प्रकट होता है।

मेन्यू उपलब्ध होने के समय हरा संकेतक प्रकट होता है।

मेन्यू उपलब्ध होने के समय हरा संकेतक प्रकट होता है।

हरा इंडिकेटर उस समय दिखाई देता है जब खेल इंटरेक्शन के लिए उपलब्ध होता है।

हरा इंडिकेटर उस समय दिखाई देता है जब खेल इंटरेक्शन के लिए उपलब्ध होता है।

हरा इंडिकेटर उस समय दिखाई देता है जब खेल इंटरेक्शन के लिए उपलब्ध होता है।

Game Ready सही ढंग से काम नहीं कर रहा

नीला संकेतक हरे रंग में बदल गया :

  • जब तक खेल इंटरैक्शन के लिए उपलब्ध नहीं होता (प्रगति पट्टी, घूमते हुए रिंग्स, काला स्क्रीन आदि);

  • चंद सेकंड बाद, जब खेल इंटरैक्शन के लिए तैयार हो गया था।

Game Ready

टिप्पणी

हरा इंडिकेटर उस समय दिखाई देता है जब खेल संवाद के लिए उपलब्ध होता है।

हरा इंडिकेटर उस समय दिखाई देता है जब खेल संवाद के लिए उपलब्ध होता है।

हरा इंडिकेटर उस समय दिखाई देता है जब खेल संवाद के लिए उपलब्ध होता है।

हरा इंडिकेटर केवल एक कुछ सेकंड के बाद ही दिखाई देने लगा, जब खेल इंटरैक्शन के लिए उपलब्ध हो गया।

हरा इंडिकेटर केवल एक कुछ सेकंड के बाद ही दिखाई देने लगा, जब खेल इंटरैक्शन के लिए उपलब्ध हो गया।

Game Ready इंटीग्रेट नहीं किया गया है

90 सेकंड के बाद इंडिकेटर लाल हो गया ।

Game Ready

टिप्पणी

इंडिकेटर लाल हो गया — Game Ready इंटीग्रेट नहीं किया गया है।

गेमप्ले का मार्कअप

1.19.3. मेथड्स GameplayAPI.start() और GameplayAPI.stop() गेमिंग प्रक्रिया की शुरुआत और रोक को चिन्हित करने के लिए अनुमति देते हैं। यदि इनका उपयोग गेम में किया जाता है, तो इवेंट्स के भेजे जाने के क्षण सख्ती से उस विवरण के अनुसार होते हैं जो गेमप्ले खंड में वर्णित है।

गेमप्ले मार्कअप की जांच

तैयारी

  1. गेम को डीबग-पैनल के साथ शुरू करें।

    1. यांडेक्स गेम्स कंसोल खोलें.
    2. आवश्यक गेम चुनें।
    3. बायें ऊपरी कोने में Open with debug panel पर क्लिक करें।
    1. आवश्यक गेम खोलें।
    2. ब्राउज़र के पते की पट्टी के अंत में &debug-mode=16 जोड़ें।

  2. डीबग-पैनल पर गेमपैड का बटन 🎮 खोजें।

जांच का सामान्य सिद्धांत

कार्रवाई के आधार पर गेमप्ले इंडिकेटर की स्थिति की निगरानी करें:

  • जब खिलाड़ी गेमिंग प्रक्रिया को शुरू करता है या पॉज़ के बाद उसे फिर से शुरू करता है, तब GameplayAPI.start() मेथड को कॉल किया जाना चाहिए। गेमप्ले इंडिकेटर हरा हो जाना चाहिए — गेमप्ले प्रक्रिया में है।

  • जब खिलाड़ी गेमिंग प्रक्रिया को समाप्त करता है या उसे रोकता है, तब GameplayAPI.stop() मेथड को कॉल किया जाना चाहिए। गेमप्ले इंडिकेटर लाल हो जाना चाहिए — गेमप्ले पॉज़ पर है।

जांच के दौरान उल्लेखित स्थितियाँ:

  • लेवल की शुरुआत और समाप्ति।

  • गेम मेन्यू को खोलना और बंद करना।

  • खरीदारी मेन्यू को खोलना और बंद करना।

  • विज्ञापन की शुरुआत और बंद करना।

  • गेम से फोकस खोना और गेम में वापस आना (ब्राउज़र के दूसरे टैब में जाना या दूसरी विंडो में जाना)।

सुझाव

यह जानने के लिए कि फोकस (खेल पर या किसी अन्य विंडो पर) कहाँ है, घटनाओं game_api_resume और game_api_pause का ट्रैक रखें।

गेमप्ले सही ढंग से चिह्नित

इंडिकेटर का रंग परिदृश्य के अनुसार बदलता है।

खेल

टिप्पणी

नए स्तर की शुरुआत पर इंडिकेटर हरा होता है।

स्तर समाप्त होने पर, इंडिकेटर लाल हो जाता है।

मेन्यू में जाने और फिर गेम प्रक्रिया में वापस आने पर इंडिकेटर बदलता है।

मेन्यू में जाने और फिर गेम प्रक्रिया में वापस आने पर इंडिकेटर बदलता है।

खरीदारी मेन्यू में जाने और फिर गेम प्रक्रिया में वापस आने पर इंडिकेटर बदलता है।

विज्ञापन बंद हो गया, इंडिकेटर का रंग लाल से हरे में बदल गया।

ब्राउज़र टैब से फोकस को दूसरी विंडो में स्थानांतरित करने और फिर गेम प्रक्रिया में वापस आने पर इंडिकेटर का रंग बदलता है।

गेमप्ले गलत तरीके से चिह्नित

इंडिकेटर का रंग परिदृश्य के अनुसार नहीं बदलता है।

खेल

टिप्पणी

स्तर समाप्त हो गया है, परन्तु संकेतक का रंग हरे से लाल में नहीं बदला है

मेन्यू में प्रवेश करते समय संकेतक का रंग हरे से लाल में नहीं बदला है

विज्ञापन बंद हो गया है, परन्तु संकेतक का रंग लाल से हरे में नहीं बदला है

ब्राउज़र टैब से फोकस दूसरी विंडो में जाने पर संकेतक का रंग नहीं बदलता है

मॉडरेशन से संपर्क करें

यदि आप मानते हैं कि आप SDK के तरीकों का सही उपयोग कर रहे हैं और आपका गेम गलती से प्रकाशन से हटा दिया गया है या प्रकाशन के लिए स्वीकृत नहीं किया गया है — नीचे दिए गए फॉर्म को भरें।

मॉडरेशन क्वालिटी कंट्रोल सर्विस निर्णय की पुन: जाँच करेगी और यदि गेम को अनुचित रूप से ब्लॉक किया गया था तो वापस कर देगी।

फॉर्म खोलें
Previous
बेसिक उल्लंघन
Next
गेम मैकेनिक्स