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

Android için Play Games Hizmetleri'ni kullanmaya başlama

Google ile Giriş API'sinin desteğinin sonlandırılmasının ardından, 2026'da Games v1 SDK'sını kaldırıyoruz. Şubat 2025'ten sonra games v1 SDK'sıyla yeni entegre edilen oyunları Google Play'de yayınlayamayacaksınız. Bunun yerine games v2 SDK'sını kullanmanızı öneririz.
Önceki Games v1 entegrasyonlarına sahip mevcut uygulamalar birkaç yıl daha çalışmaya devam edecek olsa da Haziran 2025'ten itibaren v2'ye geçiş yapmanız önerilir.
Bu kılavuz, Play Games Hizmetleri v1 SDK'sının kullanımıyla ilgilidir. En son SDK sürümü hakkında bilgi için v2 belgelerine bakın.

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

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

Bu eğitim, Android için örnek bir oyun uygulamasını yüklemenize ve kendi Android oyununuzu hızlı bir şekilde 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ümlerdeki adımları tamamlayın.

Uygulama ön koşulları

Uygulamanızın derleme dosyasında aşağıdaki değerlerin kullanıldığından emin olun:

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

Oyununuzu Google Play Console'da ayarlama

Google Play Console, oyununuz için Google Play Games Hizmetleri'ni yönettiğiniz ve oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırdığınız yerdir. Daha fazla bilgi için Google Play Games Hizmetleri'ni ayarlama başlıklı makaleyi inceleyin.

Uygulamanızı yapılandırma

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

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

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

Play Games SDK 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 olur:

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

Örnek uygulama kılavuzu

1. adım: Örnek uygulamayı indirin

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

Örnek uygulamayı Android Studio'da indirip kurmak için:

Android örneklerini örnek indirme sayfasından indirin.
android-basic-samples projesini içe aktarın. Bu proje TypeANumber ve diğer Android oyun örneklerini içerir. Bu işlemi Android Studio'da yapmak için:
1. Dosya > Projeyi İçe Aktar'ı tıklayın.
2. Geliştirme makinenizde android-basic-samples'yı indirdiğiniz dizine gidin. Dosyayı seçin android-basic-samples/build.gradle ve Tamam'ı tıklayın.
TypeANumber modülünde AndroidManifest.xml dosyasını açın ve paket adını com.google.example.games.tanc yerine kendi farklı 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: Oyunu Google Play Console'da ayarlayın

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

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

Web tarayıcınızda Google Play Console'a gidin ve oturum açın. Daha önce Google Play Console'a kaydolmadıysanız kaydolmanız istenir.
Oyununuzu Google Play Console'a eklemek için bu talimatları uygulayın.
1. Uygulamanızda Google API'leri 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ılavuzu kapsamında, formu kendi oyun ayrıntılarınızla doldurabilirsiniz. Kolaylık sağlaması için İndirilenler sayfasında sağlanan yer tutucu simgeleri ve ekran görüntülerini kullanabilirsiniz.
Android uygulamanız için OAuth 2.0 istemci kimliği oluşturmak üzere aşağıdaki talimatları uygulayın.
1. Android uygulamanızı bağlarken örnek paketi yeniden adlandırırken kullandığınız paket adını tam olarak belirttiğinizden emin olun.
2. Henüz bir anahtar deponuz ve imzalı sertifikanız yoksa Android Studio'daki İmzalı APK Oluşturma Sihirbazı'nı kullanarak yeni bir anahtar deposu ve imzalı sertifika oluşturabilirsiniz. İmzalı APK Oluşturma Sihirbazı'nı çalıştırmayı öğrenmek için Android Studio'da Uygulamanızı İmzalama başlıklı makaleye bakın.
Daha sonra kullanmak üzere aşağıdaki bilgileri kaydettiğinizden emin olun:
1. Uygulama kimliğiniz: Bu, yalnızca rakamlardan oluşan (genellikle 12 veya daha fazla) ve istemci kimliğinizin başında yer alan bir dizedir.
2. İmza sertifikanız: API erişiminizi ayarlarken hangi sertifikayı kullandığınızı not edin (SHA1 dijital parmak izini sağladığınız sertifika). Uygulamanızı test ederken veya yayınlarken uygulamanızı imzalamak için aynı sertifikayı kullanmanız gerekir.

Sayı Yazma Yarışması için başarıları yapılandırın:

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 puan alın.	Yok
Humble	0 puan isteğinde bulunma	Yok
Don't get cocky, kid	İki modda da 9999 puan isteyin.	Yok
OMG U R TEH UBER LEET!	1337 puanı alma	Bunu gizli bir başarı haline getirin.
Sıkılmış	Oyunu 10 kez oynayın.	Bunu, kilidini açmak için 10 adım gereken artımlı bir başarı haline getir.
Really Really Bored	Oyunu 100 kez oynayın.	Bu başarıyı, kilidini açmak için 100 adım gereken artımlı bir başarı haline getirin.

Oluşturduğunuz her 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 Android'de başarıları uygulama başlıklı makaleleri inceleyin.

Type-a-Number Challenge için skor tablolarını yapılandırın:
1. Google Play Console'da Skor tabloları sekmesini seçin.
2. Biri "Kolay Yüksek Puanlar", diğeri "Zor Yüksek Puanlar" adlı iki örnek skor tablosu ekleyin. Her iki skor tablosu da 0 ondalık basamaklı tam sayı puan biçimlendirmesini ve Daha büyük daha iyidir sıralama türünü kullanmalıdır.
3. Oluşturduğunuz her skor tablosunun kimliklerini (uzun alfanümerik dizeler) kaydedin.
4. Oyununuza uygun skor tabloları yapılandırın. Daha fazla bilgi edinmek için skor tablolarının arkasındaki kavramlar ve Android'de skor tablolarını uygulama sayfalarını inceleyin.
Oyununuz için test hesapları ekleyin. Bu adım yalnızca Google Play Console'da henüz yayınlanmamış uygulamalar için gereklidir. Uygulama yayınlanmadan önce yalnızca Google Play Console'da listelenen test hesapları giriş yapabilir. Ancak bir uygulama yayınlandıktan sonra herkes giriş yapabilir.

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

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

res/values/ids.xml dosyasını 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. Uygulama kimliğinizi app_id kaynağında belirtin.
2. Daha önce oluşturduğunuz her başarı kimliğini ilgili achievement_* kaynağında belirtin.
3. Daha önce oluşturduğunuz her skor tablosu kimliğini ilgili leaderboard_* kaynağında belirtin.
AndroidManifest.xml dosyasını açın ve package özelliğine paketinizin adını girin.manifest Android oyununu sıfırdan oluşturuyorsanız <application> öğesinin içine aşağıdaki 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 Games Hizmetleri'nin oyununuzda doğru şekilde çalıştığından emin olmak için uygulamayı Google Play'de yayınlamadan önce test edin.

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

Uygulamaya giriş yapmak için kullandığınız test hesabını (2. adımda açıklandığı gibi) oluşturduğunuzu doğrulayın.
APK'yı dışa aktarın ve Google Play Console'da projeyi oluşturmak için kullandığınız sertifikayla imzalayın. Android Studio'da imzalı bir APK'yı dışa aktarmak için Build (Derle) > Generate Signed APK'yı (İmzalı APK Oluştur) tıklayın.
adb aracını kullanarak imzalı APK'yı fiziksel test cihazınıza yükleyin. Uygulama yüklemeyi öğrenmek için Cihazda çalıştırma başlıklı makaleyi inceleyin.