अपने ऐप्लिकेशन में Play Games Services के Recall को इंटिग्रेट करना

अपने खाते के सिस्टम का इस्तेमाल जारी रखते हुए, लोगों को अपने गेम में आसानी से साइन इन करने की सुविधा दें. Play Games की सेवाओं के Recall API की मदद से, गेम में मौजूद खातों को Google Play की गेम सेवाओं के खाते से लिंक किया जा सकता है. इसके बाद, जब कोई व्यक्ति अलग-अलग डिवाइसों पर आपका गेम खेलता है (या गेम को फिर से इंस्टॉल करने के बाद, उसी डिवाइस पर खेलता है), तो लिंक किए गए गेम में मौजूद खाते के बारे में क्वेरी की जाती है. साथ ही, साइन-इन की प्रोसेस को आसान बनाया जाता है.

अगर आपने Android के Recall API को इंटिग्रेट किया है, तो ये Recall API आपको जाने-पहचाने लगेंगे. Play Games की सेवाओं के Recall के साथ, सर्वर-साइड इंटिग्रेशन को पीसी के टाइटल के लिए फिर से इस्तेमाल किया जा सकता है. ऐसा इसलिए, क्योंकि ये Android और पीसी, दोनों के लिए एक जैसे होते हैं.

ज़रूरी शर्तें

पहला चरण: मेनिफ़ेस्ट में, Play Games की सेवाओं के प्रोजेक्ट का आईडी जोड़ना

Play Console में, Play की गेम सेवाओं का सेटअप पूरा करने के बाद, आपके गेम से Play की गेम सेवाओं का प्रोजेक्ट आईडी जुड़ जाता है. इस प्रोजेक्ट आईडी का इस्तेमाल करके, अपने गेम के 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>

दूसरा चरण: साइन-इन करते समय, Recall का ऐक्सेस पाने का अनुरोध करना

जब आपका गेम, साइन-इन की प्रोसेस को मैनेज कर रहा हो, जैसे कि गेम में मौजूद खाता जोड़ना, तो Recall का ऐक्सेस पाने का अनुरोध करने के लिए GamesRecallClient::RequestRecallAccess() का इस्तेमाल करें.

इस कॉल से एक सेशन आईडी मिलता है. इसका इस्तेमाल, आपका बैकएंड, Google को सर्वर-साइड कॉल करने के लिए करता है. इससे, गेम में मौजूद खातों को Play Games की सेवाओं के उपयोगकर्ता के साथ लिंक और अनलिंक किया जा सकता है.

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
}

तीसरा चरण: Recall के सेशन आईडी को प्रोसेस करना

जब आपके गेम के पास Recall का सेशन आईडी हो और उसने इसे आपके बैकएंड गेम सर्वर को पास कर दिया हो, तो Play Games के सर्वर-साइड REST API का इस्तेमाल करके ये काम करें:

  • मौजूदा लिंक किए गए गेम में मौजूद खातों के बारे में क्वेरी करना recall.retrieveTokens
  • recall.linkPersona का इस्तेमाल करके, लिंक किए गए गेम में मौजूद खातों को जोड़ना या अपडेट करना
  • `recall.unlinkPersona` का इस्तेमाल करके, लिंक किए गए गेम में मौजूद खातों को मिटाना recall.unlinkPersona

सर्वर-साइड इंटिग्रेशन के बारे में ज़्यादा जानकारी पाने के लिए, वह दस्तावेज़ देखें जिसमें बताया गया है कि अपने गेम सर्वर में, Recall API का इस्तेमाल कैसे करें.