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

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

Play Games SDK'sı, oyununuzun oynanışını kolayca yürütmenizi sağlayan, platformlar arası Google Play oyun hizmetleri Başarılar, skor tabloları ve Tabletinizde ve mobil oyunlarınızda kaydedilmiş Oyunlar.

Bu eğitim, Android için örnek bir oyun uygulamasını yüklemeniz konusunda size yol gösterecektir. ve hızlıca kendi Android oyununuzu oluşturmaya başlayın. Sayıyı Yazın Örnek meydan okuma uygulaması, başarıları ve başarıları nasıl entegre edebileceğinizi skor tabloları oluşturabilirsiniz.

Başlamadan önce

Uygulamanızı hazırlamak için aşağıdaki bölümlerde yer alan 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 ayarlayın

Google Play Console, hesabınız için Google Play Games hizmetlerini yönettiğiniz yerdir. yapabilir ve oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırabilirsiniz. Örneğin, daha fazla bilgi için Google Play Games Hizmetleri'ni kurma.

Uygulamanızı yapılandırma

Proje düzeyindeki build.gradle dosyanıza Google'ın Maven deposu ve Maven merkez deposu hem buildscript hem de allprojects bölümlerinizde:

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

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

Play Games SDK'sı için Google Play Hizmetleri bağımlılığını modülün Gradle derleme dosyasına app/build.gradle:

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

Örnek Uygulama Rehberi

Bu eğitim, Android için örnek bir oyun uygulaması yüklemenize yardımcı olacaktır. ve hızlıca kendi Android oyununuzu oluşturmaya başlayın. Sayıyı Yazın Örnek meydan okuma uygulaması, başarıları ve başarıları nasıl entegre edebileceğinizi skor tabloları oluşturabilirsiniz.

1. Adım: Örnek uygulamayı indirin

Bu geliştirici kılavuzu için Type-a-Number Yarışma örneğini indirmeniz gerekir Android uygulaması.

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

  1. Şu listeden Android örneklerini indirin: örnek indirme sayfası.
  2. android-basic-samples projesini içe aktarın. Bu projede TypeANumber ve başka Android oyunları var kullanabilirsiniz. Bunu Android Studio'da yapmak için:
    1. Dosya > Projeyi İçe Aktarın.
    2. Geliştirirken android-basic-samples indirdiğiniz dizine göz atın üretiliyor. 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 başka bir paket adıyla değiştirin. Yeni paket adı com.google, com.example veya com.android ile başlamaz.

2. Adım: Google Play Console'da oyunu ayarlayın

Google Play Console, oyununuz için Google Play Games hizmetlerini yönettiğiniz yerdir ve Oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için meta verileri yapılandırın.

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

  1. Web tarayıcınızda Google Play Console ve oturum açın. Google Play Console'a daha önce kaydolmadıysanız bunu yapmanız istenir.
  2. Bu talimatları uygulayarak oyununuzu Google Play Console'a ekleyin.
    1. Uygulamanızda Google API'lerini 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ılavuzunun amaçları doğrultusunda, formu kendi bilgilerinizle doldurabilirsiniz. bolca fırsat sunuyor. Kolaylık sağlaması açısından yer tutucu simgelerini ve ekran görüntülerini kullanabilirsiniz İndirilenler sayfasında bulabilirsiniz.
  3. Bu talimatları uygulayarak OAuth 2.0 istemci kimliği oluşturun Android uygulamanız için.
    1. Android uygulamanızı bağlarken tam paketi belirttiğinizden emin olun örnek paketi yeniden adlandırırken kullandığınız ad.
    2. Android Studio'da İmzalanmış APK Oluşturma Sihirbazı'nı kullanarak yoksa yeni bir anahtar deposu ve imzalanmış sertifika oluşturun. Nasıl yapıldığını öğrenmek için İmzalanmış APK Oluşturma Sihirbazı'nı çalıştırmak için Uygulamanızı Android Studio'da İmzalama.
  4. Daha sonrası için aşağıdaki bilgileri kaydettiğinizden emin olun:
    1. Uygulama kimliğiniz: Bu bir dizedir yalnızca rakamlardan (genellikle 12 veya daha fazla) oluşmalıdır.
    2. İmzalama sertifikanız: Kurulum sırasında hangi sertifikayı kullandığınızı not edin API erişiminiz (SHA1 parmak izini sağladığınız sertifika). Siz uygulamanızı test ederken veya yayınlarken uygulamasını indirin.
  5. Type-a-Number Görevi için başarıları yapılandırma:
    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 skor alın. Yok
      Alçak 0 puan isteyin. Yok
      Çekinmeyin evlat Her iki modda da 9.999 puan isteyin. Yok
      Merhaba U R TEH UBER LEET! 1337 puan alın. Bunu gizli başarı yap.
      Sıkılmış Oyunu 10 kez oynayın. Kilidi açmak için 10 adımla bunu artımlı başarı haline getirin.
      Çok Sıkıldım 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 bir başarının kimliklerini (uzun alfanümerik dizeler) oluşturuldu.
    4. Oyununuza uygun başarıları yapılandırın. Daha fazla bilgi edinmek için başarıların arkasındaki kavramları görün ve başarıları Android'de uygulama konularına değindik.
  6. Type-a-Number Görevi 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" adlı iki örnek skor tablosu ekleyin. Bunlar “Hard Resmî Puanlar”dır. Her iki skor tablosu da tam sayı biçimlendirmesini kullanmalıdır sıralama türü Büyükse daha iyi olmalı,
    3. Oluşturduğunuz her skor tablosunun kimliklerini (uzun alfanümerik dizeleri) kaydedin.
    4. Oyununuz için uygun skor tabloları yapılandırın. Daha fazla bilgi edinmek için Skor tablolarının arkasındaki kavramları öğrenin ve Android'de skor tabloları nasıl uygulanır?
  7. Oyununuz için test hesapları ekleyin. Bu adım yalnızca şurada henüz yayınlanmamış uygulamalar için gereklidir: Google Play Console. Uygulama yayınlanmadan önce yalnızca listelenen test hesapları giriş yapabilirsiniz. Ancak uygulama yayınlandıktan sonra Herkesin giriş yapmasına izin verilir.
ziyaret edin.

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

Oyunu çalıştırmak için Android projesi. Ayrıca, oyunlar meta verilerini AndroidManifest.xml dosyasına eklemeniz gerekir.

  1. res/values/ids.xml öğesini açın ve yer tutucu kimliklerini değiştirin. Şu durumda: sıfırdan Android oyunu oluşturmak için ö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_* kaynak.
    3. Daha önce oluşturduğunuz skor tablolarının kimliklerini ilgili leaderboard_* kaynak.
  2. AndroidManifest.xml sayfasını açıp package alanına paketinizin adını girin <manifest> özelliğinin öğesine dokunun. YouTube'dan bir Android oyunu yoksa <application> etiketinin içine aşağıdaki kodu da eklediğinizden emin olun: öğe:
    <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 düzgün çalıştığından emin olmak için uygulamanızı Google Play'de yayınlamayın.

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

  1. Giriş yapmak için kullandığınız test hesabını oluşturduğunuzu doğrulayın. (2. Adım'da açıklandığı şekilde) uygulamaya koymanız gerekir.
  2. Bir APK'yı dışa aktarın ve ayarlamak için kullandığınız sertifikayla imzalayın Google Play Console'da bulabilirsiniz. Android Studio'da imzalı bir APK'yı dışa aktarmak için Derleme > İmzalanmış APK oluşturun.
  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 şuraya bakın: Cihazda çalışan.
ziyaret edin.