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

Dikkat: Bu kılavuz, Play Games Hizmetleri v1 SDK'sını kullanmak içindir. En yeni SDK hakkında bilgi için Play Games Service v2 dokümanlarına bakın.

Google Play oyun hizmetleriyle Android oyun geliştirmeye hoş geldiniz!

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

Bu eğitim, Android için örnek bir oyun uygulaması yüklemeniz ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanız için size yol gösterir. 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 verilen 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 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 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 deposu ile 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.1.0'
  }

Örnek Uygulama Kılavuzu

Bu eğitim, Android için örnek oyun uygulamasını yüklemeniz ve kendi Android oyununuzu hızlı bir şekilde oluşturmaya başlamanız için size yol gösterir. 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 Yarışması örnek Android uygulamasını indirmeniz gerekir.

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

1. Örnekleri indirme sayfasından Android örneklerini indirin.
2. 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 uygulaması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 uygulamasını açın ve com.google.example.games.tanc olan paket adını kendi farklı bir paket adıyla 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 kurun

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.

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

1. Web tarayıcınızı Google Play Console'a doğrultun ve oturum açın. Daha önce Google Play Console'a kaydolmadıysanız bunu yapmanı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 herhangi bir Google API'si kullanmıyorum'u seçin.
   2. Bu geliştirici kılavuzu için 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.
3. Android uygulamanız için OAuth 2.0 istemci kimliği oluşturmak üzere buradaki talimatları uygulayın.
   1. Android uygulamanızı bağlarken daha önce örnek paketi yeniden adlandırırken kullandığınız tam paket adını 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ın nasıl çalıştırılacağını öğrenmek için Android Studio'da Uygulamanızı İmzalama bölümüne bakın.
4. Daha sonra kullanmak üzere aşağıdaki bilgileri kaydettiğinizden emin olun:
   1. Uygulama kimliğiniz: İstemci kimliğinizin başında yalnızca rakamlardan (genellikle 12 veya daha fazla) oluşan bir dizedir.
   2. İmzalama sertifikanız: API erişiminizi (SHA1 parmak izini sağladığınız sertifika) ayarlarken hangi sertifikayı kullandığınıza dikkat edin. Uygulamanızı test ederken veya yayınlarken imzalamak için aynı sertifikayı kullanmanız gerekir.
5. Type-a-Number 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 elde edin.	Yok
      Mütevazı	0 puan isteyin.	Yok
      Bu sinirlenme çocuk.	Her iki modda da 9.999 puan isteyin.	Yok
      MÜKEMMEL!	1337 puan alın.	Bunu gizli bir başarı yap.
      Sıkılmış	Oyunu 10 kez oynamanız gerekir.	Kilidi açmak için 10 adımla bu oyunu artımlı bir başarı haline getirin.
      Çok Sıkıldım	Oyunu 100 kez oynayın.	Kilidi açmak için 100 adım içeren bu oyunu artımlı bir başarı haline getirin.

   3. Oluşturduğunuz her bir başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
   4. Başarıları oyununuza uygun olacak şekilde yapılandırın. Daha fazla bilgi edinmek için başarıların arkasında yatan kavramları ve başarıların Android'de nasıl uygulanacağını öğrenin.
6. Tür-Sayı Yarışması 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 "Yüksek Puanlar" adlı iki örnek skor tablosu ekleyin. Her iki skor tablosu da 0 ondalık basamak içeren Tam sayı puan biçimlendirmesini kullanmalıdır ve sıralama türü Büyükse daha iyidir.
   3. Oluşturduğunuz her bir skor tablosunun kimliklerini (uzun alfanümerik dizeler) kaydedin.
   4. Skor tablolarını oyununuza uygun şekilde yapılandırın. Daha fazla bilgi edinmek için skor tablolarının ardındaki kavramlara ve Android'de skor tablolarının nasıl uygulanacağına bakın.
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 herkesin giriş yapmasına izin verilir.

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

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. Oyun meta verilerini AndroidManifest.xml bölümüne de eklemeniz gerekir.

1. 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 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.
2. AndroidManifest.xml uygulamasını açın ve paket adınızı <manifest> öğesinin package özelliğine girin. Sıfırdan bir Android oyunu oluşturuyorsanız aşağıdaki kodu <application> öğesinin içine de 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 çalıştığından emin olmak için uygulamayı Google Play'de yayınlamadan önce test edin.

Not: Fiziksel bir Android cihazda test etmeniz önerilir. Ancak, fiziksel bir cihazınız yoksa testi Android Emülatör ile yapabilirsiniz. Bunu yapmak için SDK Yöneticisi'nden Android 4.2.2 altındaki Google Play Hizmetleri'ni içeren emülatör sistem görüntüsünü indirin.

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

1. Uygulamaya giriş yapmak için kullandığınız test hesabını ayarladığınızı doğrulayın (2. Adım'da açıklandığı şekilde).
2. Bir APK'yı dışa aktarın ve Google Play Console'da projeyi oluştururken kullandığınız sertifikayla imzalayın. Android Studio'da imzalı bir APK'yı dışa aktarmak için Oluştur > İmzalanmış APK Oluştur'u tıklayın.
3. İ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ıştırma bölümüne bakın.

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