अपने गेम में इवेंट जोड़ें

Google साइन-इन एपीआई के बंद होने के बाद, हम 2026 में Games v1 SDK टूल को हटा रहे हैं. फ़रवरी 2025 के बाद, Google Play पर ऐसे टाइटल पब्लिश नहीं किए जा सकेंगे जिन्हें हाल ही में games v1 SDK टूल के साथ इंटिग्रेट किया गया है. हमारा सुझाव है कि आप इसके बजाय, games v2 SDK टूल का इस्तेमाल करें.
पिछले गेम के v1 इंटिग्रेशन वाले मौजूदा टाइटल कुछ साल तक काम करते रहेंगे. हालांकि, हमारा सुझाव है कि आप जून 2025 से v2 पर माइग्रेट करें.
यह गाइड, Play Games Services v1 SDK टूल का इस्तेमाल करने के लिए है. Play Games Services v2 के लिए, C++ SDK टूल अभी उपलब्ध नहीं है.

इस गाइड में, C++ ऐप्लिकेशन में इवेंट सेवा का इस्तेमाल करने का तरीका बताया गया है.

शुरू करने से पहले

अगर आपने अब तक ऐसा नहीं किया है, तो इवेंट गेम के कॉन्सेप्ट की समीक्षा करना आपके लिए मददगार हो सकता है.

Events सेवा का इस्तेमाल करने के लिए, अपना C++ डेवलपमेंट एनवायरमेंट सेट अप करने के लिए, C++ के लिए शुरुआती जानकारी गाइड में दिए गए निर्देशों का पालन करें. SDK टूल के डाउनलोड पेज से, Play Games services C++ SDK टूल डाउनलोड किया जा सकता है.

आपका गेम इवेंट ऐक्सेस कर सके, इसके लिए आपको पहले Google Play Console में इवेंट तय करने होंगे.

इवेंट सबमिट करना

अपने गेम में कोड जोड़कर, इवेंट सेवा को सूचना दी जा सकती है, ताकि जब भी आपके गेम में कोई दिलचस्प इवेंट होता है, तो वह सेवा को सूचना दे सके. गेम में कैप्चर किए जा सकने वाले इवेंट के उदाहरण: दुश्मनों को मारना, गेम के अलग-अलग इलाकों को एक्सप्लोर करना या उनमें वापस आना या गेम में आइटम हासिल करना. आम तौर पर, जब भी खिलाड़ी इवेंट से जुड़ी कोई कार्रवाई करता है, तो इवेंट की गिनती को एक बढ़ाने के लिए, इवेंट मैनेजर पर Increment तरीका इस्तेमाल किया जाता है. उदाहरण के लिए, “एक मॉन्स्टर को मारना”.

यहां दिए गए उदाहरण में, इवेंट की सेवा में अपडेट किए गए इवेंट की संख्या सबमिट करने का तरीका बताया गया है.

  // Increment the event count when player performs the 'Attack blue
  // monster' action.
  game_services_->Events().Increment(BLUE_MONSTER_EVENT_ID);

इवेंट वापस लाना

किसी खास इवेंट के लिए, Google के सर्वर में सेव की गई मौजूदा गिनती की वैल्यू को वापस पाने के लिए, Fetch* में से किसी एक तरीके को कॉल करें. उदाहरण के लिए, अगर आपको अपने गेम में किसी कस्टम यूज़र इंटरफ़ेस (यूआई) से, गेम में किसी खिलाड़ी के आंकड़े या उसकी प्रोग्रेस दिखानी है, तो ऐसा किया जा सकता है.

नीचे दिए गए उदाहरण में बताया गया है कि अपने गेम में इवेंट डेटा को कैसे वापस पाया और लॉग किया जा सकता है.

  // Log Events details.
  LogI("---- Showing Event Counts -----");
  gpg::EventManager::FetchAllCallback callback =
      [](gpg::EventManager::FetchAllResponse const &response) {
    for (auto i : response.data) {
      gpg::Event const &event = i.second;
      LogI("Event name: %s  count: %d", event.Name().c_str(),
           event.Count());
    }
  };
  game_services_->Events().FetchAll(callback);