Google Play की गेम सेवाओं के लिए सर्वर-साइड ऐक्सेस की सुविधा चालू करना

अगर आपके गेम में बैकएंड सर्वर का इस्तेमाल होता है, तो हमारा सुझाव है कि आप Google साइन-इन का इस्तेमाल, खिलाड़ियों की पुष्टि करने के लिए करें. साथ ही, बैकएंड सर्वर पर खिलाड़ी की पहचान सुरक्षित तरीके से पास करें. इस सुविधा की मदद से, आपका गेम डिवाइस की स्क्रीन या वीडियो के बीच से छेड़छाड़ करते हुए, खिलाड़ी की पहचान और दूसरे डेटा सुरक्षित तरीके से हासिल किया जा सकता है.

इस स्थिति में, आपके गेम में खिलाड़ी को Google Play की गेम सेवाओं में साइन इन करने के लिए सामान्य तरीके से कहा जाता है. जब प्लेयर साइन इन कर लेता है, तब GoogleSignInAccount ऑब्जेक्ट में एक खास सिंगल-यूज़ कोड होता है, जिसे क्लाइंट सर्वर से भेजता है. इसे सर्वर ऑथराइज़ेशन कोड कहा जाता है. इसके बाद, सर्वर पर OAuth 2.0 टोकन के लिए सर्वर की पुष्टि करने वाला कोड बदलें. सर्वर इसका इस्तेमाल, Google Play की गेम सेवाओं के एपीआई को कॉल करने के लिए कर सकता है.

अपने गेम में साइन इन करने से जुड़ी ज़्यादा जानकारी के लिए, Android गेम में साइन इन करना पर जाएं.

खिलाड़ियों की पुष्टि करने के लिए, 'Google साइन-इन' का इस्तेमाल करने का तरीका जानने के लिए, GitHub पर clientserverskeleton सैंपल देखें.

ऑफ़लाइन ऐक्सेस के लिए यह तरीका अपनाएं:

  1. Google Play Console में: अपने गेम सर्वर के लिए क्रेडेंशियल बनाएं. OAuth क्रेडेंशियल का टाइप "web" होगा.
  2. Android ऐप्लिकेशन में: साइन इन करने के दौरान अपने सर्वर के क्रेडेंशियल के लिए सर्वर ऑथराइज़ेशन कोड का अनुरोध करें और उसे अपने सर्वर को पास करें.
  3. अपने गेम सर्वर पर: Google की पुष्टि करने वाली सेवाओं का इस्तेमाल करके OAuth ऐक्सेस टोकन के लिए, सर्वर से पुष्टि करने वाले कोड का लेन-देन करें. इसके बाद, Play की गेम सेवाओं के REST API को कॉल करने के लिए, इसका इस्तेमाल करें.

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

'Google साइन इन' को अपने गेम में इंटिग्रेट करने से पहले, आपको Google Play Console में अपना गेम जोड़ना होगा. इस बारे में, Google Play की गेम सेवाएं सेट अप करना में बताए गए तरीके से बताया गया है.

अपने गेम के लिए, वेब सर्वर से जुड़ा वेब ऐप्लिकेशन बनाएं

Google Play गेम सेवाएं, वेब गेम के लिए एंड-एंड समर्थन नहीं देती हैं. हालांकि, यह आपके Android गेम के सर्वर के लिए, बैक-एंड सर्वर की सुविधा देता है.

अगर आपको अपने सर्वर साइड ऐप्लिकेशन में Google Play की गेम सेवाओं के लिए REST API का इस्तेमाल करना है, तो यह तरीका अपनाएं:

  1. Google Play Console के लिंक किए गए ऐप्लिकेशन सेक्शन में जाकर, अपने गेम से जुड़ा वेब ऐप्लिकेशन बनाएं. ध्यान दें कि launch_url का इस्तेमाल इस फ़्लो के लिए नहीं किया जाता है. इसे खाली छोड़ा जा सकता है.
  2. अपने ऐप्लिकेशन की क्रेडेंशियल जानकारी पाने के लिए, यह तरीका अपनाएं:
    1. Google Play Console में मौजूद अपने गेम में, गेम की जानकारी पर क्लिक करें.
    2. नीचे एपीआई कंसोल प्रोजेक्ट सेक्शन तक स्क्रोल करें और एपीआई कंसोल प्रोजेक्ट के लिंक पर क्लिक करें.
    3. Google API (एपीआई) कंसोल में एपीआई और सेवाएं & gt; क्रेडेंशियल स्क्रीन से, अपने वेब ऐप्लिकेशन के लिए client_secret.json फ़ाइल डाउनलोड करें और उसे ऐसी जगह पर सेव करें जिसे आपका सर्वर ऐक्सेस कर सके. बाद के संदर्भ के लिए क्रेडेंशियल का क्लाइंट आईडी रिकॉर्ड करें.
  3. अपना सर्वर-साइड ऐप्लिकेशन रीस्टार्ट करें, ताकि वह आपके गेम वाले क्लाइंट ऐप्लिकेशन से अनुरोध स्वीकार करने के लिए तैयार हो जाए.

क्लाइंट खाते में साइन इन करना

GoogleSignInClient क्लास, साइन इन करने वाले मौजूदा प्लेयर का खाता वापस पाने और प्लेयर में साइन इन करने के लिए एक मुख्य एंट्री पॉइंट है. हालांकि, यह ज़रूरी है कि प्लेयर में उपयोगकर्ता ने पहले आपके ऐप्लिकेशन पर ऐसा न किया हो.

साइन इन क्लाइंट बनाने के लिए, यह तरीका अपनाएं:

  1. GoogleSignInOptions ऑब्जेक्ट के ज़रिए, साइन-इन क्लाइंट बनाएं. अपने साइन इन को कॉन्फ़िगर करने के लिए, GoogleSignInOptions.Builder में, GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN के बारे में बताएं.
  2. आपको यह भी बताना होगा कि आपके गेम को आपके बैकएंड सर्वर के लिए, पुष्टि करने वाले कोड की ज़रूरत है. इसके लिए, सर्वर के क्लाइंट आईडी वाले पैरामीटर GoogleSignInOptions.Builder.requestServerAuthCode() को पैरामीटर के तौर पर कॉल किया जाता है. आपको अपने बैकएंड सर्वर पर ऐक्सेस टोकन के लिए, पुष्टि करने वाला कोड बाद में मिलेगा. इसके बारे में सर्वर ऑथराइज़ेशन कोड में बताया गया है.
  3. GoogleSignIn.getClient() वाले तरीके पर कॉल करें और उन विकल्पों को पास करें जो आपने पहले कॉन्फ़िगर किए थे. अगर कॉल पूरा हो जाता है, तो 'Google साइन-इन एपीआई', GoogleSignInClient का एक इंस्टेंस दिखाता है.
  4. जैसे ही आप GoogleSignInClient इंस्टेंस पाना शुरू कर लेते हैं, वैसे ही आपको गतिविधि की onResume() में खिलाड़ी को बिना सूचना दिए साइन करना चाहिए, जैसा कि बिना आवाज़ के साइन इन करना में बताया गया है.

यहां उदाहरण देखें:

private static final int RC_SIGN_IN = 9001;
private GoogleSignInClient mGoogleSignInClient;

private void startSignInForAuthCode() {

  // Client ID for your backend server.
  String webClientId = getString(R.string.webclient_id);

  GoogleSignInOptions signInOption = new
      GoogleSignInOptions.Builder(GoogleSignInOptions.DEFAULT_GAMES_SIGN_IN)
      .requestServerAuthCode(webClientId)
      .build();

  GoogleSignInClient signInClient = GoogleSignIn.getClient(this, signInOption);
  Intent intent = signInClient.getSignInIntent();
  startActivityForResult(intent, RC_SIGN_IN);
}

सर्वर ऑथराइज़ेशन कोड पाएं

अपने बैकएंड सर्वर पर ऐक्सेस टोकन के लिए इस्तेमाल किया जा सकने वाला सर्वर ऑथराइज़ेशन कोड पाने के लिए, GoogleSignInAccount ऑब्जेक्ट पर getServerAuthCode() का इस्तेमाल करें, ताकि 'Google साइन इन' सही प्लेयर पर साइन इन करे.

यहां उदाहरण देखें:


// Auth code to send to backend server.
private String mServerAuthCode;

@Override
protected void onActivityResult(int requestCode, int resultCode, Intent data) {
  super.onActivityResult(requestCode, resultCode, data);
  if (requestCode == RC_SIGN_IN) {
    GoogleSignInResult result = Auth.GoogleSignInApi.getSignInResultFromIntent(data);
    if (result.isSuccess()) {
      mServerAuthCode = result.getSignInAccount().getServerAuthCode();
    } else {
      String message = result.getStatus().getStatusMessage();
      if (message == null || message.isEmpty()) {
        message = getString(R.string.signin_other_error);
      }
      new AlertDialog.Builder(this).setMessage(message)
          .setNeutralButton(android.R.string.ok, null).show();
    }
  }
}

सर्वर पर ऐक्सेस टोकन के लिए सर्वर ऑथराइज़ेशन कोड बदलें

ऐक्सेस देने और टोकन रीफ़्रेश करने के लिए, सर्वर ऑथराइज़ेशन कोड अपने बैकएंड सर्वर को भेजें. प्लेयर की ओर से Google Play Games Services API को कॉल करने के लिए ऐक्सेस टोकन का इस्तेमाल करें. इसके अलावा, ऐक्सेस टोकन की समयसीमा खत्म होने पर नया टोकन जनरेट करने के लिए, रीफ़्रेश टोकन सेव करें.

यहां दिए गए कोड स्निपेट से यह पता चलता है कि ऐक्सेस टोकन के लिए सर्वर ऑथ कोड को एक्सचेंज करने के लिए, Java प्रोग्रामिंग लैंग्वेज में सर्वर साइड कोड को कैसे लागू किया जा सकता है. इसमें clientserverskeleton सैंपल ऐप्लिकेशन का इस्तेमाल किया जाता है:

/**
 * Exchanges the authcode for an access token credential.  The credential
 * is the associated with the given player.
 *
 * @param authCode - the non-null authcode passed from the client.
 * @param player   - the player object which the given authcode is
 *                 associated with.
 * @return the HTTP response code indicating the outcome of the exchange.
 */
private int exchangeAuthCode(String authCode, Player player) {
try {

    // The client_secret.json file is downloaded from the Google API
    // console.  This is used to identify your web application.  The
    // contents of this file should not be shared.
    //
    File secretFile = new File("client_secret.json");

    // If we don't have the file, we can't access any APIs, so return
    // an error.
    if (!secretFile.exists()) {
        log("Secret file : " + secretFile
                .getAbsolutePath() + "  does not exist!");
        return HttpServletResponse.SC_FORBIDDEN;
    }

    GoogleClientSecrets clientSecrets = GoogleClientSecrets.load(
            JacksonFactory.getDefaultInstance(), new
            FileReader(secretFile));

    // Extract the application id of the game from the client id.
    String applicationId = extractApplicationId(clientSecrets
            .getDetails().getClientId());

    GoogleTokenResponse tokenResponse =
            new GoogleAuthorizationCodeTokenRequest(
            HTTPTransport,
            JacksonFactory.getDefaultInstance(),
            "https://oauth2.googleapis.com/token",
            clientSecrets.getDetails().getClientId(),
            clientSecrets.getDetails().getClientSecret(),
            authCode,
            "")
            .execute();

    log("hasRefresh == " + (tokenResponse.getRefreshToken() != null));
    log("Exchanging authCode: " + authCode + " for token");
    Credential credential = new Credential
            .Builder(BearerToken.authorizationHeaderAccessMethod())
            .setJsonFactory(JacksonFactory.getDefaultInstance())
            .setTransport(HTTPTransport)
            .setTokenServerEncodedUrl("https://www.googleapis.com/oauth2/v4/token")
            .setClientAuthentication(new HttpExecuteInterceptor() {
                @Override
                public void intercept(HttpRequest request)
                        throws IOException {
                        }
            })
            .build()
            .setFromTokenResponse(tokenResponse);

    player.setCredential(credential);

    // Now that we have a credential, we can access the Games API.
    PlayGamesAPI api = new PlayGamesAPI(player, applicationId,
            HTTPTransport, JacksonFactory.getDefaultInstance());

    // Call the verify method, which checks that the access token has
    // access to the Games API, and that the player id used by the
    // client matches the playerId associated with the accessToken.
    boolean ok = api.verifyPlayer();

    // Call a Games API on the server.
    if (ok) {
        ok = api.updatePlayerInfo();
        if (ok) {
            // persist the player.
            savePlayer(api.getPlayer());
        }
    }

    return ok ? HttpServletResponse.SC_OK :
            HttpServletResponse.SC_INTERNAL_SERVER_ERROR;

  } catch (IOException e) {
    e.printStackTrace();
  }
  return HttpServletResponse.SC_INTERNAL_SERVER_ERROR;
}

साइन इन किए हुए प्लेयर की ओर से बैकएंड सर्वर से Google API को ऐक्सेस करने के बारे में ज़्यादा जानने के लिए, सर्वर-साइड ऐक्सेस चालू करना देखें.

प्लेयर से साइन आउट करने की प्रक्रिया को मैनेज करें

खिलाड़ियों को अपने गेम से साइन आउट करने के लिए, GoogleSignInClient पर signOut() वाले तरीके को कॉल करें. उदाहरण के तौर पर दिए गए कोड स्निपेट के लिए, प्लेयर से साइन आउट करना देखें.

REST API को सर्वर से कॉल करें

उपलब्ध एपीआई कॉल की पूरी जानकारी के लिए, Google Play की गेम सेवाओं के लिए REST API का इस्तेमाल करें.

आपके लिए REST API का इस्तेमाल करने के उदाहरण नीचे दिए गए हैं:

खिलाड़ी

  • साइन इन किए हुए प्लेयर का आईडी और प्रोफ़ाइल डेटा पाना चाहते हैं? 'me' के साथ आईडी के रूप में Players.get पर कॉल करें.

दोस्त

दोस्त गाइड देखना न भूलें. इस गाइड में दोस्तों को ज़्यादा जानकारी मिलती है.

  • खिलाड़ी की दोस्तों की सूची फिर से पाना चाहते हैं? 'friends_all' के collection के तौर पर Players.list पर कॉल करें.
  • देखें कि क्या आपके पास दोस्तों की सूची का ऐक्सेस है? me के लिए, Players.get पर कॉल करें और जवाब में profileSettings.friendsListVisibility फ़ील्ड देखें.

उपलब्धियां

उपलब्धियों वाली गाइड ज़रूर पढ़ें. इस गाइड में, उपलब्धियों के बारे में ज़्यादा जानकारी दी गई है.

  • मौजूदा उपलब्धियों की सूची पाना चाहते हैं? आपके पास उपलब्धियों की सूची में कॉल करने का विकल्प है.
  • यह पता करने के लिए कि खिलाड़ी ने कौन-कौन से खिलाड़ियों के अनलॉक किए हैं, उपलब्धियों.की सूची के साथ कॉल करें.
  • क्या खिलाड़ी को कोई उपलब्धि मिली है? इसे अनलॉक करने के लिए, उपलब्धियों को अनलॉक करें का इस्तेमाल करें!
  • क्या खिलाड़ी ने कुछ हद तक उपलब्धि हासिल की है? गेम में मिली बढ़त का स्टेटस देखने और रिपोर्ट पाने के लिए, उपलब्धियों में बढ़ोतरी करें.
  • क्या आपने कोई ऐसा गेम डीबग किया है जो अभी तक प्रोडक्शन में नहीं है? उपलब्धियों को उनकी मूल स्थिति पर रीसेट करने के लिए, मैनेजमेंट एपीआई से उपलब्धियों.reset या उपलब्धियों.resetAll को कॉल करने की कोशिश करें.

लीडरबोर्ड

लीडरबोर्ड गाइड की समीक्षा करना न भूलें. इस गाइड में लीडरबोर्ड के बारे में ज़्यादा जानकारी दी गई है.

  • गेम में मौजूद सभी स्कोरबोर्ड की सूची पाना चाहते हैं? लीडरबोर्ड.सूची को कॉल करें.
  • क्या खिलाड़ी ने गेम पूरा कर लिया है? उनका स्कोर Scores.submit पर सबमिट किया जा सकता है. साथ ही, यह भी पता लगाया जा सकता है कि यह स्कोर ज़्यादा है या नहीं.
  • क्या आपको लीडरबोर्ड दिखाना है? Scores.list से डेटा पाएं और उसे उपयोगकर्ता को दिखाएं.
  • Scores.listविंडो का इस्तेमाल करके, उपयोगकर्ता के ऊंचे स्कोर से मिलते-जुलते स्कोर का पता लगाएं.
  • किसी खास लीडरबोर्ड में खिलाड़ी के स्कोर के बारे में ज़्यादा जानकारी पाने के लिए (उदाहरण के लिए, अगर खिलाड़ी सभी खिलाड़ियों के टॉप 12% में है), तो Scores.get पर कॉल करें.
  • क्या आप किसी गेम को डीबग कर रहे हैं? किसी विशेष लीडरबोर्ड से उस प्लेयर के सभी स्कोर रीसेट करने के लिए प्रबंधन API से Scores.reset को कॉल करने की कोशिश करें