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

Dikkat: Bu kılavuz, Play Games Hizmetleri v1 SDK'sının kullanımıyla ilgilidir. En son SDK sürümü hakkında bilgi edinmek için v2 dokümanlarına bakın.

Google Play Oyun 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 sağlar.

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanıza rehberlik eder. "Sayı Yazma Yarışması" örnek uygulaması, başarıları ve lider 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 fazla öğede compileSdkVersion

Oyununuzu Google Play Console'da ayarlama

Google Play Console, oyununuz için Google Play oyun hizmetlerini 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 kurma 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ünüze ekleyin:

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

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

Play Games SDK'sına ait 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 kılavuzu

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanıza rehberlik eder. "Sayı Yazma Yarışması" örnek uygulaması, başarıları ve lider tablolarını oyununuza nasıl entegre edebileceğinizi gösterir.

1. adım: Örnek uygulamayı indirin

Bu geliştirici kılavuzu için Sayı Yazma yarışması örnek Android uygulamasını indirmeniz gerekir.

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

1. Android örneklerini örnek indirme sayfasından indirin.
2. android-basic-samples projesini içe aktarın. Bu projede TypeANumber ve diğer Android oyun örnekleri yer alıyor. Android Studio'da bunu yapmak için:
   1. Dosya > Projeyi İçe Aktar'ı tıklayın.
   2. Geliştirme makinenizde android-basic-samples dosyasını indirdiğiniz dizine gidin. Dosyayı android-basic-samples/build.gradle seçin ve Tamam'ı tıklayın.
3. TypeANumber modülünde AndroidManifest.xml'u açın ve com.google.example.games.tanc olan paket adını kendi belirlediğiniz farklı bir paket adına 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 Oyun 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:

1. Web tarayıcınızı Google Play Console'a yönlendirin ve oturum açın. Daha önce Google Play Console'a kaydolmadıysanız kaydolmanız istenir.
2. Oyununuzu Google Play Console'a eklemek için aşağıdaki talimatları uygulayın.
   1. Uygulamanızda Google API'leri kullanıp kullanmadığınız sorulduğunda Oyunumda henüz Google API'si kullanmıyorum'u seçin.
   2. Bu geliştirici kılavuzu için formu kendi oyun ayrıntılarınızla doldurabilirsiniz. Kolaylık sağlamak için İndirilenler sayfasında bulunan yer tutucu simgeleri ve ekran görüntülerini kullanabilirsiniz.
3. 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, daha önce örnek paketi yeniden adlandırırken kullandığınız paket adını tam olarak belirttiğinizden emin olun.
   2. Henüz yoksa yeni bir anahtar mağazası ve imzalı sertifika oluşturmak için Android Studio'daki İmzalı APK Oluştur Sihirbazı'nı kullanabilirsiniz. İmzalı APK Oluşturma Sihirbazı'nı nasıl çalıştıracağınızı öğrenmek için Android Studio'da Uygulamanızı İmzalama başlıklı makaleyi inceleyin.
4. Aşağıdaki bilgileri daha sonra kullanabileceğiniz için kaydetmeyi unutmayın:
   1. Uygulama kimliğiniz: İstemci kimliğinizin başında yer alan ve 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ı (SHA1 parmak izini sağladığınız sertifika) not edin. Uygulamanızı test ederken veya yayınlarken uygulamanızı imzalamak için aynı sertifikayı kullanmanız gerekir.
5. Sayı Yazma Yarışması için başarıları yapılandırın:
   1. Google Play Console'da Başarıları sekmesini seçin.
   2. 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 bulunun.	Yok
      Kendine güvenme, çocuk	Her iki modda da 9999 puan isteğinde bulunun.	Yok
      OMG U R TEH UBER LEET!	1337 puan alırsınız.	Bu başarıyı gizli hale getirin.
      Sıkılmış	Oyunu 10 kez oynayın.	Bu başarıyı, kilidini açmak için 10 adım içeren artımlı bir başarı haline getirin.
      Çok Sıkılmış	Oyunu 100 kez oynayın.	Bu başarıyı, kilidini açmak için 100 adım içeren artımlı bir başarı haline getirin.

   3. Oluşturduğunuz her başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
   4. Oyununuza uygun başarıları yapılandırın. Daha fazla bilgi edinmek için başarıların temelindeki kavramlar ve Android'de başarıları uygulama başlıklı makaleleri inceleyin.
6. Sayı Yazma Yarışması için skor tablolarını yapılandırın:
   1. Google Play Console'da Sıralama tabloları sekmesini seçin.
   2. İki örnek skor tablosu ekleyin: Biri "Kolay Yüksek Puanlar", diğeri "Zor Yüksek Puanlar". Her iki skor tablosunda da 0 ondalık basamak içeren tam sayı puan biçimlendirmesi ve Daha yüksek puanlar daha iyidir sıralama türü kullanılmalıdır.
   3. Oluşturduğunuz her lider tablosunun kimliklerini (uzun alfanümerik dizeler) kaydedin.
   4. Oyununuza uygun skor tabloları yapılandırın. Daha fazla bilgi edinmek için sıralama tablolarının temel kavramlarını ve Android'de skor tablolarını uygulama konusunu inceleyin.
7. 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. Ancak bir uygulama yayınlandıktan sonra herkes giriş yapabilir.

Uyarı: Test hesabı olarak listelenmemiş bir hesabı kullanarak yayınlanmamış bir oyun için Play Games SDK'sı çağrıları yapmaya çalışırsanız Google Play Games Hizmetleri, oyun yokmuş gibi davranır ve ConnectionResult.SIGN_IN_REQUIRED dönüş kodunu alırsınız. ConnectionResult.startResolutionForResult()'u başlatmaya çalışırsanız GamesActivityResultCodes.RESULT_SIGN_IN_FAILED'e geri dönersiniz.

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 eklemeniz gerekir.

1. res/values/ids.xml dosyasını açın ve yer tutucu kimliklerini değiştirin. Android oyununu sıfırdan 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 başarı kimliğini ilgili achievement_* kaynağında belirtin.
   3. Daha önce oluşturduğunuz her bir liderlik tablosu kimliğini ilgili leaderboard_* kaynağında belirtin.
2. AndroidManifest.xml dosyasını açın ve <manifest> öğesinin package özelliğine paket adınızı girin. Sıfırdan bir Android oyunu oluşturuyorsanız <application> öğesine 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 düzgün çalıştığından emin olmak için uygulamayı Google Play'de yayınlamadan önce test edin.

Not: Fiziksel bir Android cihazda test yapmanız önerilir. Ancak fiziksel bir cihazınız yoksa Android Emulator ile test edebilirsiniz. Bunu yapmak için Android 4.2.2 altında Google Play Hizmetleri'ni içeren emülatör sistem imajını SDK Yöneticisi'nden indirin.

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

1. Uygulamaya giriş yapmak için kullandığınız test hesabını (2. adımda açıklandığı şekilde) oluşturduğunuzdan emin olun.
2. Bir APK dışa aktarın ve Google Play Console'da projeyi oluşturmak için kullandığınız sertifikayla imzalayın. Android Studio'da imzalanmış bir APK'yı dışa aktarmak için Derle > İmzalanmış APK Oluştur'u tıklayın.
3. İmzalı APK'yı adb aracını kullanarak fiziksel test cihazınıza yükleyin. Uygulamaları nasıl yükleyeceğinizi öğrenmek için Cihazlarda çalıştırma başlıklı makaleyi inceleyin.

Uyarı: Uygulamayı doğrudan Android Studio'dan çalıştırdığınızda Android Studio, uygulamayı varsayılan olarak hata ayıklama sertifikanızla imzalar. Uygulamayı Google Play Console'da ayarlarken bu hata ayıklama sertifikasını kullanmadıysanız hata oluşur. Aktardığınız ve Google Play Console'da uygulama kurulumu sırasında kullandığınız sertifikalardan biriyle imzaladığınız bir APK'yı çalıştırdığınızdan emin olun.