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

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

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

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

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

Events सेवा का इस्तेमाल करने के लिए, C++ डेवलपमेंट एनवायरमेंट सेट अप करने के लिए, C++ के लिए शुरुआत करना गाइड में दिए गए निर्देशों का पालन करें. Play की गेम सेवाओं वाले 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);