Android गेम के लिए गेम के आंकड़े

इस गाइड में, Android ऐप्लिकेशन में गेम के आंकड़ों वाले एपीआई इस्तेमाल करने का तरीका बताया गया है. इससे आपके गेम में गेम के आंकड़े अनलॉक और दिखाए जा सकते हैं. इन एपीआई को com.google.android.gms.games और com.google.android.gms.games.playergameevent पैकेज में देखा जा सकता है.

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

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

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

  • Google Play services SDK टूल सेट अप करें गाइड में दिए गए निर्देशों का पालन करके, Google Play की गेम सेवाओं का इस्तेमाल करने के लिए, अपना ऐप्लिकेशन इंस्टॉल और सेट अप करें.

  • Google Play Console गाइड में दिए गए निर्देशों का पालन करके, उन गेम के आंकड़ों को तय करें जिन्हें आपको अपने गेम में अनलॉक या दिखाना है.

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

गेम के आंकड़े दिखाने वाले एपीआई का इस्तेमाल शुरू करने के लिए, आपके गेम को सबसे पहले GameStatsClient ऑब्जेक्ट पाना होगा. इसके लिए, Games.getGameStatsClient() तरीके का इस्तेमाल करें और गतिविधि से जुड़ी जानकारी उपलब्ध कराएं.

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

क्लाइंट साइड इंटिग्रेशन के लिए, आपको ट्रिगर पॉइंट पर Java SDK में इवेंट ऑब्जेक्ट बनाना होगा. साथ ही, SDK की ओर से उपलब्ध कराई गई अपलोड फ़ंक्शन का इस्तेमाल करके उन्हें भेजना होगा.PlayerGameEvent

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

इवेंट

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

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

Java


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("matchCompleted")
  .addProperty("matchId", "Match_A")
  .addProperty("gameMode", "Battle_B")
  .addProperty("mapId", "Location_XYZ")
  .addProperty("isWinner", true)
  .addProperty("playerElimination", 2)
  .build();

List events = new ArrayList<>();
// ... populate list ...

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

Java


// Build the PlayerGameEvent
PlayerGameEvent event = new PlayerGameEvent.Builder("progressUpdate")
  .addProperty("currentProgress", 52)
  // Add other properties if needed
  .build();

List events = new ArrayList<>();
// ... populate list ...

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

Java


// Buffers the event locally.
client.recordEvent(event);

// Buffers the events locally, (List version)
client.recordEvents(events);

// This submits the events to PGS
client.requestEventsUpload();