अपने खाता सिस्टम का इस्तेमाल जारी रखते हुए, उपयोगकर्ताओं को अपने गेम में आसानी से साइन इन कराएं. Play Games Services के 'खाता याद रखें' एपीआई की मदद से, इन-गेम खातों को Google Play Games Services खाते से लिंक किया जा सकता है. इसके बाद, जब कोई उपयोगकर्ता अलग-अलग डिवाइसों पर आपका गेम खेलता है (या गेम को फिर से इंस्टॉल करने के बाद उसी डिवाइस पर खेलता है), तो लिंक किए गए इन-गेम खाते से क्वेरी की जाती है और साइन-इन फ़्लो को आसान बनाया जाता है.
अगर आपने Android रीकॉल एपीआई के साथ इंटिग्रेट किया है, तो आपको ये रीकॉल एपीआई दिखने चाहिए. Play Games Services के Recall के साथ किए गए किसी भी सर्वर-साइड इंटिग्रेशन का फिर से इस्तेमाल, पीसी गेम के लिए किया जा सकता है. ऐसा इसलिए, क्योंकि ये इंटिग्रेशन Android और पीसी, दोनों के लिए एक जैसे होते हैं.
ज़रूरी शर्तें
SDK टूल सेटअप पूरा करें.
Play Games services के रीकॉल एपीआई की खास जानकारी पढ़ें.
Play Console में, Google Play Games Services का सेटअप पूरा करें.
पहला चरण: मेनिफ़ेस्ट में अपना Play Games Services प्रोजेक्ट आईडी जोड़ना
Play Console में Play Games की सेवाओं का सेटअप पूरा करने के बाद, आपके गेम के लिए अब Play Games की सेवाओं का प्रोजेक्ट आईडी जुड़ा होगा. इस प्रोजेक्ट आईडी का इस्तेमाल करके, अपने गेम का manifest.xml अपडेट करें. यह आईडी, Play Console में Play Games की सेवाओं के कॉन्फ़िगरेशन पेज पर मौजूद होता है.
manifest.xml कॉन्टेंट का उदाहरण:
<?xml version="1.0" encoding="utf-8"?>
<Manifest version="1">
<Application>
<PackageName>com.example.package</PackageName>
<PlayGamesServices>
<ProjectId>123456789</ProjectId>
</PlayGamesServices>
</Application>
</Manifest>
दूसरा चरण: साइन इन करते समय, खाते का ऐक्सेस वापस पाने का अनुरोध करना
जब आपका गेम साइन-इन फ़्लो को मैनेज कर रहा हो, जैसे कि गेम में खाता जोड़ना, तो GamesRecallClient::RequestRecallAccess() का इस्तेमाल करके, खाते को वापस पाने का अनुरोध करें.
इस कॉल से एक सेशन आईडी मिलता है. इसका इस्तेमाल आपके बैकएंड में, Google को सर्वर-साइड कॉल करने के लिए किया जाता है. इससे, गेम में मौजूद खातों को Play Games Services के उपयोगकर्ता के खाते से लिंक और अनलिंक किया जा सकता है.
auto promise = std::make_shared<std::promise<RecallAccessResult>>();
games_recall_client.RequestRecallAccess(params, [promise](RecallAccessResult result) {
promise->set_value(std::move(result));
});
auto recall_access_result = promise->get_future().get();
if (recall_access_result.ok()) {
auto recall_session_id = recall_access_result.value().recall_session_id;
// Pass the recall session ID to your backend game server so it can query
// for an existing linked in-game account.
// - If you discover an existing linked in-game account, continue to sign-in
// the in-game account. This provides a seamless cross-device sign-in
// experience.
// - If there is not an existing linked in-game account, when the user
// completes the sign-in using your in-game account system record the
// account linking with Play Games Services Recall. This helps to provide
// a seamless cross-device sign-in experience when the user returns on a
// different device or after re-installing your game on the same device.
} else {
// Handle the error
}
तीसरा चरण: रीकॉल सेशन आईडी को प्रोसेस करना
जब आपके गेम में रीकॉल सेशन आईडी हो और आपने उसे अपने बैकएंड गेम सर्वर को पास कर दिया हो, तो Play Games के सर्वर-साइड REST API का इस्तेमाल करके:
recall.retrieveTokensका इस्तेमाल करके, लिंक किए गए मौजूदा इन-गेम खातों के बारे में क्वेरी करनाrecall.linkPersonaका इस्तेमाल करके, लिंक किए गए इन-गेम खाते जोड़ना या अपडेट करनाrecall.unlinkPersonaका इस्तेमाल करके, गेम में लिंक किए गए खाते मिटाना
सर्वर साइड इंटिग्रेशन के बारे में ज़्यादा जानकारी के लिए, अपने गेम सर्वर में Recall API का इस्तेमाल करने के तरीके के बारे में बताने वाला दस्तावेज़ देखें.