Oyuncuların kimliklerini doğrulamanızı ve Oynatıcının kimliğini arka uç sunucusuna güvenli bir şekilde iletmelidir. Bu durumda, oyuncunun kimliğini ve diğer verilerini güvenli bir şekilde almak için oyununuza Cihazdan geçerken olası kurcalamalara maruz kalma.
Bu senaryoda, oyuncu başarıyla oturum açtığında tek kullanımlık özel bir kod isteyebilirsiniz (sunucu kimlik doğrulama kodu olarak adlandırılır) ve istemcinin sunucuya ilettiği Play Games Hizmetleri v2 SDK'sından. Ardından sunucuda Sunucunun Google Play Games Hizmetleri API'si.
Oyunlarınıza oturum açma özelliği ekleme hakkında daha fazla bilgi için şuraya bakın: Android Games'de oturum açın.
Çevrimdışı erişim için aşağıdaki adımlar gereklidir:
- Google Play Console'da: Oyun sunucunuz için bir kimlik bilgisi oluşturun. İlgili içeriği oluşturmak için kullanılan Kimlik bilgisinin OAuth istemci türü "web" olur.
- Android uygulamasında: Oturum açma işleminin bir parçası olarak ve sunucunuza iletmeniz gerekir.
- Oyun sunucunuzda: Sunucu yetkilendirme kodunu OAuth erişimi için değiştirin ve ardından bu anahtarı kullanarak Play Oyun Hizmetleri REST API'leri.
Başlamadan önce
Öncelikle oyununuzu Google Play Console, Google Play Oyun Hizmetleri'ni kurun ve Play Games Hizmetleri Oturum Açma'yı oyununuzla entegre edin.
Oyununuz için ilişkilendirilmiş bir sunucu tarafı web uygulaması oluşturun
Google Play Oyun Hizmetleri arka uç sağlamaz Web oyunları desteği. Ancak arka uç sunucu desteği sunar. kullanabilirsiniz.
Bir web sitesini ziyaret etmek için Google Play Games hizmetleri için REST API'ler sunucu tarafı uygulamanızda şu adımları uygulayın:
- Google Play Console'daki oyununuzdan Play Games Hizmetleri > Kurulum ve yönetim > Yapılandırma.
- Kimlik bilgisi ekleme 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 geçin.
- Oyun sunucunuzun zaten bir OAuth istemci kimliği varsa açılır menüden bunu seçin. Değişikliklerinizi kaydettikten sonra bir sonraki bölüme geçin.
- Oyun sunucunuz için mevcut bir OAuth istemci kimliğiniz yoksa oluşturabilirsiniz.
- OAuth istemcisi oluştur'u tıklayın ve OAuth istemci kimliği oluştur bağlantısındaki talimatları uygulayın.
- Bu işlem sizi, oyununuzun ilişkili Cloud Platform projesi için Google Cloud Platform'da OAuth İstemci Kimliği Oluşturma sayfasına yönlendirir.
- Sayfanın formunu doldurun ve Oluştur'u tıklayın. Uygulama türünü Web uygulaması olarak ayarladığınızdan emin olun.
- Add Credential page's Authorization (Kimlik bilgisi ekleme sayfasının Yetkilendirme) bölümüne dönün, yeni oluşturulan OAuth istemcisini seçin ve değişikliklerinizi kaydedin.
Sunucu kimlik doğrulama kodunu alma
Oyununuzun arka uç sunucunuzdaki erişim jetonları için kullanabileceği bir sunucu kimlik doğrulama kodu almak için:
Müşteriden
requestServerSideAccessadlı kişiyi ara.- Android uygulamanızın OAuth İstemci Kimliği'ni değil, oyun sunucunuz için kayıtlı OAuth İstemci Kimliği'ni kullandığınızdan emin olun.
- (İsteğe bağlı) Oyun sunucunuz, Play Games Hizmetleri'ne çevrimdışı erişim (yenileme jetonu kullanarak uzun ömürlü 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. } });Değiştirilmesi için OAuth kimlik doğrulama kodu jetonunu arka uç sunucunuza gönderin, oyuncu kimliği Play Games Hizmetleri REST API'lerine göre doğrulandıktan sonra oyununuzla kimliği doğrulanır.
Sunucudaki erişim jetonu için sunucu kimlik doğrulama kodunu değiştirin
Erişim ve yenileme jetonları almak için sunucu yetkilendirme 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 depolamanız gerekir.
Aşağıdaki kod snippet'i, Java'da sunucu tarafı kodu nasıl uygulayabileceğinizi sunucu yetkilendirme kodunu erişim jetonlarıyla değiştirecek programlama dili Evet her bir arama terimi için clientserverskeleton örnek uygulaması:
/**
* 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'leri çağırma
Google Play Games hizmetleri için REST API'ler başlıklı makaleyi inceleyin. mevcut API çağrılarının tam açıklamasını görebilirsiniz.
Yararlı bulabileceğiniz REST API çağrısı örnekleri:
Oyuncu
- Oturum açmış oyuncunun kimliğini ve profil verilerini almak ister misiniz? Players.get dosyasını arayın
kimlik
'me'ile başlar.
Arkadaşlar
Arkadaşlar hakkında daha ayrıntılı bilgi içeren Arkadaşlar kılavuzunu incelediğinizden emin olun.
- Oyuncunun arkadaş listesini almak ister misiniz? Players.list öğesini şu uygulamayla arayın:
collectionolarak'friends_all'. - Arkadaş listesine erişiminiz olup olmadığını kontrol edin.
meiçin Players.get kodunu arayın ve yanıttakiprofileSettings.friendsListVisibilityalanına bakın.
Başarılar
Başarıların açıklandığı Başarılar kılavuzunu incelediğinizden emin olun ayrıntılı olarak inceleyelim.
- Mevcut başarıların listesini almak ister misiniz? AchievementDefinitions.list sayfasına çağrı yapabilirsiniz.
- Oynatıcının kilidini hangi başarıların kilidini açtığını öğrenmek için bunu Achievements.list çağrısıyla birleştirin.
- Oyuncu bir başarı kazandı mı? Achievements.unlock kilidini kullanarak kilidini açın!
- Oyuncu kısmi bir başarıya doğru ilerleme kaydetti mi? Achievements.increment'ı kullanarak ilerleme durumunu raporlayabilir (ve oynatıcının kilidi açıp açmadığını öğrenebilir).
- Henüz üretimde olmayan bir oyunda hata ayıklıyor musunuz? Aramayı deneyin Yönetim API'lerinden Achievements.reset veya Achievements.resetAll başarıları orijinal hallerine sıfırlayın.
Skor tabloları
Skor tabloları hakkında daha ayrıntılı bilgi veren 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.
- Oyuncunun oyunu bitirdi mi? Puanlarını Scores.submit adresine gönderebilir ve bu yeni bir rekor.
- Skor tablosu görüntülemek ister misiniz? Scores.list'ten alınan verileri alın ve kullanıcıya gösterin.
- Kullanıcının rekoruna yakın çeşitli puanları bulmak için Scores.listWindow'u kullanın.
- Oyuncunun belirli bir skor tablosunda skoruyla ilgili daha fazla bilgi almak için (örneğin, tüm oyuncular arasında ilk% 12'lik dilimdedir) Scores.get dosyasını çağırın.
- Bir oyunda hata ayıklıyor musunuz? Yönetim'den Scores.reset işlevini çağırmayı deneyin Belirli bir skor tablosunda ilgili oyuncunun tüm skorlarını sıfırlayan API'ler