Android İçin Play Oyun Hizmetlerini Kullanmaya Başlayın

Dikkat: Bu kılavuz, Play Games Hizmetleri v1 SDK'sını kullanma içindir. En yeni SDK hakkında bilgi edinmek için Play Games Hizmeti v2 dokümanlarına göz atın.

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

Play Games SDK'sı, tabletleriniz ve mobil oyunlarınızda başarılar, skor tabloları ve Kayıtlı Oyunlar gibi popüler oyun özelliklerini kolayca entegre etmenize olanak tanıyan platformlar arası Google Play oyun hizmetleri sunar.

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu oluşturmaya hemen başlamanıza yardımcı olacaktır. Type-a-NumberChallenge ö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 adımları tamamlayın.

Uygulama ön koşulları

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

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

Oyununuzu Google Play Console'da kurma

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 Oyun Hizmetleri'ni kurma konusuna bakın.

Uygulamanızı yapılandırma

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

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

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

Play Games SDK'sının Google Play Hizmetleri bağımlısını, genellikle 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.1.0'
  }

Örnek Uygulama Kılavuzu

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize ve kendi Android oyununuzu oluşturmaya hemen başlamanıza yardımcı olacaktır. Type-a-NumberChallenge ö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ği Android uygulamasını indirmeniz gerekir.

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

1. Android örneklerini örnekleri indirme sayfasından 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 indirdiğiniz dizine göz atın. android-basic-samples/build.gradle dosyasını seçin ve Tamam'ı tıklayın.
3. TypeANumber modülünde AndroidManifest.xml öğesini açın ve paket adını com.google.example.games.tanc yerine 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: Oyunu Google Play Console'da 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.

Ö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 ekleme talimatlarını uygulayın.
   1. Uygulamanızda Google API'lerini kullanıp kullanmadığınız sorulduğunda Oyunumda henüz Google API'si kullanmıyorum'u seçin.
   2. Bu geliştirici kılavuzunun amaçları doğrultusunda, formu kendi oyun bilgilerinizle doldurabilirsiniz. Kolaylık sağlamak 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şturma talimatlarını 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. Önceden oluşturduğunuz yeni bir anahtar deposu ve imzalı sertifika oluşturmak için Android Studio'da İmzalanmış APK Oluştur 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ünü inceleyin.
4. Aşağıdaki bilgileri daha sonra kullanmak üzere 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 (hangi SHA1 parmak izini sağladığınız sertifika) oluştururken hangi sertifikayı kullandığınızı not edin. Uygulamanızı test ederken veya yayınlarken uygulamanızı 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'daki 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
      Mütevazı	0 puan iste.	Yok
      Üzülmeyin çocuk	Her iki modda da 9.999 puan isteyin.	Yok
      BAŞKA BİR DAHA DAHA!	1337 puan alın.	Bunu gizli bir başarı yap.
      Sıkıldım	Oyunu 10 kez oynayın.	Kilidi açmak için 10 adımı olan bu adımı, artımlı bir başarı olarak ayarlayın.
      Gerçekten Çok Sıkıldım	Oyunu 100 kez oynayın.	Kilidini açmak için 100 adımdan yararlanarak artımlı bir başarı elde edin.

   3. Oluşturduğunuz her başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
   4. Oyununuz için uygun başarılar yapılandırın. Daha fazla bilgi edinmek için başarıların temelini oluşturan kavramlara ve başarıları Android'de nasıl uygulayacağınıza bakın.
6. Type-a-Number Meydan Okuması için skor tablolarını yapılandırın:
   1. Google Play Console'daki Skor tabloları sekmesini seçin.
   2. Biri "Kolay Yüksek Puanlar" ve diğeri "Zor Yüksek Puanlar" adlı iki örnek skor tablosu ekleyin. Her iki skor tablosunda da 0 ondalık basamak içeren Tam Sayı skor biçimlendirmesi kullanılmalıdır. Ayrıca sıralama türü Büyüktür'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 için skor tablolarının arkasındaki kavramlar ve skor tablolarını Android'de uygulama konusuna bakın.
7. 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 herkesin giriş yapmasına izin verilir.

Uyarı: Yayınlanmamış bir oyun için Play Games SDK'sı tarafından test hesabı olarak listelenmeyen bir hesap kullanarak çağrı 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() uygulamasını başlatmayı denerseniz GamesActivityResultCodes.RESULT_SIGN_IN_FAILED uygulamasına geri dönersiniz.

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

Oyunu çalıştırmak için uygulama kimliğinizi Android projenizde kaynak olarak yapılandırmanız gerekir. AndroidManifest.xml içinde oyun meta verileri de eklemeniz gerekir.

1. res/values/ids.xml uygulaması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. app_id kaynağında uygulama kimliğinizi belirtin.
   2. İlgili achievement_* kaynağında daha önce oluşturduğunuz her başarı kimliğini belirtin.
   3. İlgili leaderboard_* kaynağında daha önce oluşturduğunuz her skor tablosu kimliğini belirtin.
2. AndroidManifest.xml öğesini açın ve paket adınızı <manifest> öğesinin package özelliğine girin. Scrack'ten 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 şekilde ç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. Bununla birlikte, fiziksel bir cihazınız yoksa Android Emülatör'e karşı test edebilirsiniz. Bunun için SDK Manager'dan, Android 4.2.2 kapsamında Google Play Hizmetleri'ni içeren emülatör sistem resmini indirin.

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

1. Uygulamaya giriş yapmak için kullandığınız test hesabını oluşturduğunuzu doğrulayın (2. Adım'da açıklandığı gibi).
2. Bir APK'yı dışa aktarın ve Google Play Console'da projeyi oluştururken kullandığınız sertifikayla imzalayın. İmzalı bir APK'yı Android Studio'ya aktarmak için Oluştur > İmzalı APK oluştur'u tıklayın.
3. İmzalı APK'yı adb aracını kullanarak fiziksel test cihazınıza yükleyin. Bir uygulamayı nasıl yükleyeceğinizi öğ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 uygulamayı varsayılan olarak hata ayıklama sertifikanızla imzalar. Google Play Console'da uygulama oluştururken bu hata ayıklama sertifikasını kullanmadıysanız hatalara neden olabilirsiniz. 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 çalıştırdığınızdan emin olun.