Bu sayfa, Cloud Translation API ile çevrilmiştir.

Android için Play Oyun Hizmetleri'ni Kullanmaya Başlayın

Google Play Games Hizmetleri ile Android oyun geliştirmeye hoş geldiniz!

Play Games SDK'sı, başarılar, skor tabloları ve Kaydedilmiş Oyunlar gibi popüler oyun özelliklerini tabletinizde ve mobil oyunlarınıza kolayca entegre etmenizi sağlayan, platformlar arası Google Play oyun hizmetleri sağlar.

Bu eğitim, Android için örnek bir oyun uygulamasını yüklemenize ve hemen kendi Android oyununuzu oluşturmaya başlamanıza yardımcı olacaktır. Type-a-Number Challenge örnek uygulaması, başarıları ve skor tablolarını oyununuza nasıl entegre edebileceğinizi gösterir.

Başlamadan önce

Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan adımları tamamlayın.

Uygulama ön koşulları

Uygulamanızın derleme dosyasının aşağıdaki değerleri kullandığından emin olun:

minSdkVersion/19 daha yüksek
28 veya daha yüksek bir compileSdkVersion

Google Play Console'da oyununuzu ayarlayın

Google Play Console, oyununuz için Google Play Games hizmetlerini yönettiğiniz, oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırdığınız yerdir. Daha fazla bilgi için Google Play Oyun Hizmetleri'ni Kurma bölümüne bakın.

Uygulamanızı yapılandırma

Proje düzeyindeki build.gradle dosyanıza, hem buildscript hem de allprojects bölümlerinize Google'ın Maven deposunu ve Maven merkezi deposunu ekleyin:

  buildscript {
    repositories {
      google()
      mavenCentral()
    }
  }

  allprojects {
    repositories {
      google()
      mavenCentral()
    }
  }

Play Games SDK'sı için Google Play Hizmetleri bağımlılığını modülünüzün Gradle derleme dosyasına ekleyin. Bu dosya genellikle app/build.gradle:

  dependencies {
    implementation 'com.google.android.gms:play-services-games:23.2.0'
  }

Örnek Uygulama Rehberi

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve hemen kendi Android oyununuzu oluşturmaya başlamanıza yardımcı olacaktır. Type-a-Number Challenge örnek uygulaması, başarıları ve skor tablolarını oyununuza nasıl entegre edebileceğinizi gösterir.

1. Adım: Örnek uygulamayı indirin

Bu geliştirici kılavuzu için Type-a-Number Challenge örneğini indirmeniz gerekir. Android uygulaması

Android Studio'da örnek uygulamayı indirmek ve ayarlamak için:

Örnek indirme sayfasından Android örneklerini indirin.
android-basic-samples projesini içe aktarın. Bu proje, TypeANumber ve diğer Android oyun örneklerini içerir. Bunu Android Studio'da yapmak için:
1. Dosya > Projeyi İçe Aktar'ı tıklayın.
2. Geliştirme makinenize android-basic-samples indirdiğiniz dizine gidin. android-basic-samples/build.gradle dosyasını seçin ve Tamam'ı tıklayın.
TypeANumber modülünde, AndroidManifest.xml öğesini açın ve com.google.example.games.tanc olan paket adını kendi paket adınızla değiştirin. Yeni paket adı com.google, com.example veya com.android ile başlamamalıdır.

2. Adım: Google Play Console'da oyunu ayarlayın

Google Play Console, oyununuz için Google Play Games hizmetlerini yönettiğiniz, oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırdığınız yerdir.

Google Play Console'da örnek oyunu ayarlamak için:

Web tarayıcınızı Google Play Console'a yönlendirin ve oturum açın. Google Play Console'a daha önce kaydolmadıysanız bunu yapmanız istenir.
Oyununuzu Google Play Console'a eklemek için bu talimatları uygulayın.
1. Uygulamanızda Google API'lerini kullanıp kullanmadığınız sorulduğunda Oyunumda henüz herhangi bir Google API'si kullanmıyorum'u seçin.
2. Bu geliştirici kılavuzunun amacı doğrultusunda, formu kendi oyun bilgilerinizle doldurabilirsiniz. Kolaylık olması için İndirilenler sayfasında sağlanan yer tutucu simgelerini ve ekran görüntülerini kullanabilirsiniz.
Android uygulamanız için OAuth 2.0 istemci kimliği oluşturmak üzere bu talimatları uygulayın.
1. Android uygulamanızı bağlarken örnek paketi yeniden adlandırırken daha önce kullandığınız paket adını tam olarak belirttiğinizden emin olun.
2. Henüz yoksa yeni bir anahtar deposu ve imzalı sertifika oluşturmak için Android Studio'da İmzalanmış APK Oluşturma Sihirbazı'nı kullanabilirsiniz. İmzalanmış APK Oluşturma Sihirbazı'nı nasıl çalıştıracağınızı öğrenmek için Uygulamanızı Android Studio'da İmzalama bölümüne bakın.
Daha sonrası için aşağıdaki bilgileri kaydettiğinizden emin olun:
1. Uygulama kimliğiniz: Bu, istemci kimliğinizin başında yalnızca rakamlardan (genellikle 12 veya daha fazla) oluşan bir dizedir.
2. İmzalama sertifikanız: API erişiminizi ayarlarken hangi sertifikayı kullandığınızı not edin (SHA1 parmak izini sağladığınız sertifika). Uygulamanızı test ederken veya yayınlarken aynı sertifikayı imzalamak için de aynı sertifikayı kullanmanız gerekir.

Type-a-Number Görevi için başarıları yapılandırma:

Google Play Console'da Başarılar sekmesini seçin.

Aşağıdaki örnek başarıları ekleyin:

Ad	Açıklama	Özel Talimatlar
Prime	Asal sayı olan bir skor alın.	Yok
Alçak	0 puan isteyin.	Yok
Çekinmeyin evlat	Her iki modda da 9.999 puan isteyin.	Yok
Merhaba U R TEH UBER LEET!	1337 puan alın.	Bunu gizli başarı yap.
Sıkılmış	Oyunu 10 kez oynayın.	Kilidi açmak için 10 adımla bunu artımlı başarı haline getirin.
Çok Sıkıldım	Oyunu 100 kez oynayın.	Kilidi açmak için 100 adımla bunu artımlı bir başarı haline getirin.

Oluşturduğunuz her bir başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
Oyununuza uygun başarıları yapılandırın. Daha fazla bilgi edinmek için başarıların arkasındaki kavramları ve başarıların Android'de nasıl uygulanacağını inceleyin.

Type-a-Number Görevi için skor tablolarını yapılandırma:
1. Google Play Console'da Skor Tabloları sekmesini seçin.
2. Biri "Kolay Yüksek Puanlar" ve diğeri "Hard Resmî Puanlar" adlı iki örnek skor tablosu ekleyin. Her iki skor tablosu da 0 ondalık basamak içeren Tamsayı biçimlendirmesi ve Büyük rekorlar daha iyidir şeklinde sıralama türünü kullanmalıdır.
3. Oluşturduğunuz her skor tablosunun kimliklerini (uzun alfanümerik dizeleri) kaydedin.
4. Oyununuz için uygun skor tabloları yapılandırın. Daha fazla bilgi edinmek için skor tablolarının arkasındaki kavramları ve skor tablolarını Android'de nasıl uygulayacağınızı inceleyin.
Oyununuz için test hesapları ekleyin. Bu adım yalnızca henüz Google Play Console'da yayınlanmamış uygulamalar için gereklidir. Uygulama yayınlanmadan önce yalnızca Google Play Console'da listelenen test hesapları giriş yapabilir. Bununla birlikte, bir uygulama yayınlandıktan sonra herkesin giriş yapmasına izin verilir.

3. Adım: Kodunuzu değiştirin

Oyunu çalıştırmak için Android projenizde uygulama kimliğini kaynak olarak yapılandırmanız gerekir. Ayrıca, oyunlar meta verilerini AndroidManifest.xml dosyasına eklemeniz gerekir.

res/values/ids.xml öğesini açın ve yer tutucu kimliklerini değiştirin. Sıfırdan bir Android oyunu oluşturuyorsanız önce bu dosyayı oluşturmanız gerekir.
1. app_id kaynağında uygulama kimliğinizi belirtin.
2. Daha önce oluşturduğunuz her bir başarı kimliğini ilgili achievement_* kaynağında belirtin.
3. İlgili leaderboard_* kaynağında daha önce oluşturduğunuz her bir skor tablosu kimliğini belirtin.
AndroidManifest.xml öğesini açın ve paketinizin adını <manifest> öğesinin package özelliğine girin. Sıfırdan bir Android oyunu oluşturuyorsanız <application> öğesinin içine şu kodu da eklediğinizden emin olun:
```
<meta-data android:name="com.google.android.gms.games.APP_ID"
    android:value="@string/app_id" />
<meta-data android:name="com.google.android.gms.version"
   android:value="@integer/google_play_services_version"/>
```

4. Adım: Oyununuzu test edin

Google Play oyun hizmetlerinin oyununuzda doğru bir şekilde çalıştığından emin olmak için Google Play'de yayınlamadan önce uygulamayı test edin.

Oyununuzu fiziksel test cihazınızda çalıştırmak için:

Uygulamaya giriş yapmak için kullandığınız test hesabını oluşturduğunuzu doğrulayın (2. Adım'da açıklandığı şekilde).
Bir APK'yı dışa aktarın ve Google Play Console'da projeyi oluşturmak için kullandığınız sertifikayla imzalayın. İmzalanmış bir APK'yı Android Studio'da dışa aktarmak için Derleme > İmzalanmış APK Oluştur'u tıklayın.
İmzalanmış APK'yı, adb aracını kullanarak fiziksel test cihazınıza yükleyin. Bir uygulamanın nasıl yükleneceğini öğrenmek için Cihazda Çalışma bölümüne bakın.