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

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ının aşağıdaki değerleri kullandığından emin olun:

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

Google Play Console'da oyununuzu ayarlayın

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. android-basic-samples/build.gradle dosyasını 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 Games Hizmetleri'ni yönettiğiniz, 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 bu 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 ö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. İ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. Daha sonrası için aşağıdaki bilgileri kaydettiğinizden emin olun:
    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 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
      Alçak 0 puan isteğinde bulunun. Yok
      Kendine güvenme, çocuk Her iki modda da 9.999 puan isteyin. Yok
      MERHABA 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. Kilidi açmak için 100 adımla bunu 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.

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 bir 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> öğ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 düzgün ç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:

  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. İmzalanmış 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.