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

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

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

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

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

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

आपका गेम इवेंट को ऐक्सेस कर सके, इसलिए आपको सबसे पहले उन इवेंट को Google Play Console में कॉन्फ़िगर करना होगा.

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

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

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

  // 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);