गेम के आंकड़े

इस दस्तावेज़ में, C++ गेम में Google Play की गेम सेवाओं के गेम के आंकड़े का इस्तेमाल करने का तरीका बताया गया है. इस दस्तावेज़ में यह माना गया है कि आपने Google Play की गेम सेवाओं को सेट अप करना लेख में बताए गए तरीके से अपना प्रोजेक्ट सेट अप कर लिया है. PgsGameStatsClient में, गेम के आंकड़े API देखा जा सकता है.

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

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

गेम के आंकड़े API का इस्तेमाल करके कोडिंग शुरू करने से पहले:

• Google Play की गेम सेवाओं को सेट अप करना लेख में दिए गए निर्देशों के मुताबिक, Play Games Services का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन को इंस्टॉल और सेट अप करें.

• Google Play Console की गाइड में दिए गए निर्देशों के मुताबिक, अपने गेम के लिए गेम के आंकड़े तय करें.

गेम के आंकड़े क्लाइंट पाएं

अचीवमेंट एपीआई का इस्तेमाल शुरू करने के लिए, आपके गेम को सबसे पहले PgsGameStatsClient ऑब्जेक्ट पाना होगा. इसके लिए, PgsPlayerGameEvent_create तरीके का इस्तेमाल करें और गतिविधि से जुड़ी जानकारी उपलब्ध कराएं.

क्लाइंट साइड इंटिग्रेशन

PlayerGameEvent के लिए क्लाइंट साइड इंटिग्रेशन में, आपको C++ SDK टूल में ट्रिगर पॉइंट पर इवेंट ऑब्जेक्ट बनाना होगा. इसके बाद, SDK टूल में दिए गए अपलोड फ़ंक्शन का इस्तेमाल करके, उन्हें भेजना होगा.

इसी तरह, progressUpdate इवेंट के लिए, अपडेट की गई प्रोग्रेस को currentProgress प्रॉपर्टी का इस्तेमाल करके रिकॉर्ड करें. इसके साथ ही, तय की गई अन्य प्रॉपर्टी भी रिकॉर्ड करें. इसके बाद, SDK टूल में दिए गए अपलोड फ़ंक्शन का इस्तेमाल करके, उन्हें भेजें.

इवेंट

PlayerGameEvent के लिए क्लाइंट साइड इंटिग्रेशन ये हैं:

प्लेयर गेम इवेंट बनाएं

// Build the PlayerGameEvent
PgsPlayerGameEvent* player_event = PgsPlayerGameEvent_create("matchCompleted");
if (player_event != nullptr) {
   PgsPlayerGameEvent_putString(player_event, "matchId", "Match_A");
   PgsPlayerGameEvent_putString(player_event, "gameMode", "Battle_B");
   PgsPlayerGameEvent_putString(player_event, "mapId", "Location_XYZ");
   PgsPlayerGameEvent_putBoolean(player_event, "isWinner", true);
   PgsPlayerGameEvent_putLong(player_event, "playerElimination", 2);
}

progressUpdate प्लेयर गेम इवेंट बनाएं

PgsPlayerGameEvent* progress_event = PgsPlayerGameEvent_create("progressUpdate");
if (progress_event != nullptr) {
   PgsPlayerGameEvent_putLong(progress_event, "currentProgress", 52);
}

इवेंट रिकॉर्ड करें और अपलोड करें

// Record the event
PgsGameStatsClient_recordEvent(client, player_event);

// This submits the events to PGS
PgsGameStatsClient_requestEventsUpload(client);

// Clean up handle to avoid leaks
PgsPlayerGameEvent_destroy(player_event);

// Clean up client handle when PGS operations are finished
PgsGameStatsClient_destroy(client);