Google Play Oyun Hizmetleri'ne Sunucu Tarafı Erişimi Etkinleştirme

Oyuncuların kimliğini doğrulamanızı ve oynatıcının kimliğini arka uç sunucusuna güvenli bir şekilde iletmenizi öneririz. Bu, oyununuzun cihaz üzerinden geçerken olası izinsiz değişikliklere maruz kalmadan oyuncunun kimliğini ve diğer verileri güvenli bir şekilde almasını sağlar.

Bu senaryoda, oyuncu başarılı bir şekilde oturum açtıktan sonra Play Games Hizmetleri v2 SDK'sından istemcinin sunucuya ilettiği özel tek kullanımlık kod (sunucu kimlik doğrulama kodu denir) isteyebilirsiniz. Ardından, sunucudaki sunucu kimlik doğrulama kodunu, sunucunun Google Play Games Services API'ye çağrı yapmak için kullanabileceği bir OAuth 2.0 jetonuyla değiştirin.

Oyunlarınıza oturum açma ekleme hakkında daha fazla bilgi için Android Oyunlarında oturum açma bölümüne göz atın.

Çevrimdışı erişim için aşağıdaki adımlar gerekir:

  1. Google Play Console'da: Oyun sunucunuz için bir kimlik bilgisi oluşturun. Kimlik bilgisinin OAuth istemci türü "web" olur.
  2. Android uygulamasında: Oturum açma kapsamında, sunucunuzun kimlik bilgisi için bir sunucu yetkilendirme kodu isteyin ve bu kodu sunucunuza iletin.
  3. Oyun sunucunuzda: Google yetkilendirme hizmetlerini kullanarak bir OAuth erişim jetonu için sunucu kimlik doğrulama kodunu değiştirin ve ardından bu oyunu, Play Oyun Hizmetleri REST API'lerini çağırmak için kullanın.

Başlamadan önce

Öncelikle Google Play Oyun Hizmetleri'ni kurma bölümünde açıklandığı gibi oyununuzu Google Play Console'a eklemeniz ve Play Games Hizmetleri İçin Oturum Açma özelliğini oyununuza entegre etmeniz gerekir.

Oyununuz için ilişkili bir sunucu tarafı web uygulaması oluşturun

Google Play Games hizmetleri Web oyunları için arka uç desteği sağlamaz. Ancak, Android oyununuzun sunucusu için arka uç sunucu desteği sağlar.

Sunucu taraflı uygulamanızda Google Play Games hizmetleri için REST API'lerini kullanmak istiyorsanız aşağıdaki adımları uygulayın:

  1. Google Play Console'daki oyununuzdan Play Games Hizmetleri > Kurulum ve yönetim > Yapılandırma'ya gidin.
  2. Kimlik bilgisi ekle sayfasına yönlendirilmek için Kimlik bilgisi ekle'yi seçin. Kimlik bilgisi türü olarak Oyun sunucusu'nu seçin ve Yetkilendirme bölümüne gidin.
    1. Oyun sunucunuzda zaten bir OAuth istemci kimliği varsa açılır menüden bu istemciyi seçin. Değişikliklerinizi kaydettikten sonra sonraki bölüme geçin.
    2. Oyun sunucunuz için mevcut bir OAuth istemci kimliğiniz yoksa bir tane oluşturabilirsiniz.
      1. OAuth istemcisi oluştur'u tıklayın ve OAuth İstemci Kimliği Oluştur bağlantısını izleyin.
      2. Bu işlem, oyununuzla ilişkili Cloud Platform projesi için Google Cloud Platform'daki OAuth İstemci Kimliği Oluşturma sayfasını gösterir.
      3. Sayfanın formunu doldurun ve oluştur'u tıklayın. Uygulama türünü Web uygulaması olarak ayarladığınızdan emin olun.
      4. Kimlik bilgisi sayfasının Yetkilendirmesini Ekle bölümüne dönün, yeni oluşturulan OAuth istemcisini seçin ve değişikliklerinizi kaydedin.

Sunucu yetkilendirme kodunu alma

Oyununuzun arka uç sunucunuzdaki erişim jetonları için kullanabileceği bir sunucu kimlik doğrulama kodu almak üzere:

  1. Müşteriyi requestServerSideAccess numarasından arayın.

    1. Android uygulamanızın OAuth istemci kimliğini değil, oyun sunucunuz için kayıtlı OAuth istemci kimliğini kullandığınızdan emin olun.
    2. (İsteğe bağlı) Oyun sunucunuz Play Games Hizmetleri'ne çevrimdışı erişim (yenileme jetonu kullanarak uzun süreli erişim) gerektiriyorsa forceRefreshToken parametresini true olarak ayarlayabilirsiniz.
    GamesSignInClient gamesSignInClient = PlayGames.getGamesSignInClient(this);
    gamesSignInClient
      .requestServerSideAccess(OAUTH_2_WEB_CLIENT_ID, /* forceRefreshToken= */ false)
      .addOnCompleteListener( task -> {
        if (task.isSuccessful()) {
          String serverAuthToken = task.getResult();
          // Send authentication code to the backend game server to be
          // exchanged for an access token and used to verify the player
          // via the Play Games Services REST APIs.
        } else {
          // Failed to retrieve authentication code.
        }
    });
    
  2. OAuth kimlik doğrulama jetonunu, arka uç sunucunuza göndererek jetonla değiştirin, Player kimliğini Play Games Hizmetleri REST API'lerine göre doğrulayın ve ardından oyununuzun kimliğini doğrulayın.

Sunucudaki bir erişim jetonu için sunucu yetkilendirme kodunu değiştirme

Erişim ve yenileme jetonlarını değiştirmek için sunucu kimlik doğrulama kodunu arka uç sunucunuza gönderin. Oynatıcı adına Google Play Games Hizmetleri API'sini çağırmak için erişim jetonunu kullanın ve isteğe bağlı olarak, erişim jetonunun süresi dolduğunda yeni bir erişim jetonu almak için yenileme jetonunu depolayın.

Aşağıdaki kod snippet'i, erişim jetonları için sunucu kimlik doğrulama kodunu değiştirmek üzere Java programlama dilinde sunucu tarafı kodunu nasıl uygulayabileceğinizi gösterir. clientserverskeleton örnek uygulamasını kullanır:

/**
 * 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;
}

Sunucudan REST API'lerini çağırın

Mevcut API çağrılarının tam açıklaması için Google Play Games hizmetleri için REST API'lerine bakın.

Faydalı bulabileceğiniz REST API çağrılarına örnekler:

Oyuncu

  • Oturum açmış oyuncuların kimliğini ve profil verilerini almak ister misiniz? Kimlik olarak 'me' ile Players.get'i arayın.

Arkadaşlar

Arkadaşlarınızı daha ayrıntılı bir şekilde açıklayan Arkadaşlar kılavuzunu incelediğinizden emin olun.

Başarılar

Başarıları daha ayrıntılı olarak açıklayan Başarılar kılavuzunu incelediğinizden emin olun.

  • Mevcut başarıların listesini almak ister misiniz? AchievementDefinitions.list için arama yapabilirsiniz.
  • Bunları, Achievements.list çağrısıyla birleştirerek oyuncunun hangi kilidi açtığını öğrenebilirsiniz.
  • Oyuncu başarılı oldu mu? Kilidi açmak için Achievements.unlock bağlantısını kullanın.
  • Oyuncu kısmi bir başarıya ulaştı mı? İlerlemeyi bildirmek (ve oyuncunun kilidi açıp açmadığını öğrenmek) için Achievements.increment özelliğini kullanın.
  • Henüz üretimde olmayan bir oyunda hata ayıklama mı yapıyorsunuz? Başarıları orijinal durumlarına sıfırlamak için Yönetim API'lerinden Achievements.reset veya Achievements.resetAll komutunu çağırmayı deneyin.

Skor tabloları

Skor tablolarını daha ayrıntılı olarak açıklayan Skor tabloları kılavuzunu incelediğinizden emin olun.

  • Oyundaki tüm skor tablolarının listesini almak ister misiniz? Leaderboards.list'e çağrı yapın.
  • Oyuncu bir oyunu bitirdi mi? Puanlarını Scores.submit’a gönderebilir ve bunun yeni bir yüksek puan olup olmadığını öğrenebilirsiniz.
  • Skor tablosunu görüntülemek ister misiniz? Scores.list verilerinden veri alın ve kullanıcıya gösterin.
  • Kullanıcının en yüksek puanına yakın bir puan yelpazesini bulmak için Scores.listWindow metriğini kullanın.
  • Belirli bir skor tablosunda oyuncunun skoru hakkında daha fazla bilgi edinmek için (örneğin, oyuncu tüm oyuncuların ilk% 12'lik dilimindeyse) Scores.get'i arayın.
  • Bir oyunda hata ayıklama mı yapıyorsunuz? Belirli bir skor tablosunda o oyuncuya ait tüm skorları sıfırlamak için Management API'lerinden Scores.reset çağrısı yapmayı deneyin.