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/
28veya 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:
- Android örneklerini örnekleri indirme sayfasından indirin.
android-basic-samplesprojesini içe aktarın. Bu proje,
TypeANumberve diğer Android oyun örneklerini içerir. Bunu Android Studio'da yapmak için:
- Dosya > Projeyi İçe Aktar'ı tıklayın.
- Geliştirme makinenize
android-basic-samplesindirdiğiniz dizine göz atın.
android-basic-samples/build.gradledosyasını seçin ve Tamam'ı tıklayın.
TypeANumbermodülünde
AndroidManifest.xmlöğesini açın ve paket adını
com.google.example.games.tancyerine farklı bir paket adıyla değiştirin. Yeni paket adı
com.google,
com.exampleveya
com.androidile 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:
- 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.
- Oyununuzu Google Play Console'a ekleme talimatlarını uygulayın.
- Uygulamanızda Google API'lerini kullanıp kullanmadığınız sorulduğunda Oyunumda henüz Google API'si kullanmıyorum'u seçin.
- 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.
- Android uygulamanız için OAuth 2.0 istemci kimliği oluşturma talimatlarını uygulayın.
- Android uygulamanızı bağlarken daha önce örnek paketi yeniden adlandırırken kullandığınız tam paket adını belirttiğinizden emin olun.
- Ö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.
- Aşağıdaki bilgileri daha sonra kullanmak üzere kaydettiğinizden emin olun:
- Uygulama kimliğiniz: Bu, istemci kimliğinizin başında yalnızca rakamlardan (genellikle 12 veya daha fazla) oluşan bir dizedir.
- İ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.
- Type-a-Number Yarışması için başarıları yapılandırın:
- Google Play Console'daki Başarılar sekmesini seçin.
- 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.
- Oluşturduğunuz her başarının kimliklerini (uzun alfanümerik dizeler) kaydedin.
- 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.
- Type-a-Number Meydan Okuması için skor tablolarını yapılandırın:
- Google Play Console'daki Skor tabloları sekmesini seçin.
- 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.
- Oluşturduğunuz her skor tablosunun kimliklerini (uzun alfanümerik dizeler) kaydedin.
- 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.
- 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.
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.
res/values/ids.xmluygulaması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.
app_idkaynağında uygulama kimliğinizi belirtin.
- İlgili
achievement_*kaynağında daha önce oluşturduğunuz her başarı kimliğini belirtin.
- İlgili
leaderboard_*kaynağında daha önce oluşturduğunuz her skor tablosu kimliğini belirtin.
-
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.
Oyununuzu fiziksel test cihazınızda çalıştırmak için:
- Uygulamaya giriş yapmak için kullandığınız test hesabını oluşturduğunuzu doğrulayın (2. Adım'da açıklandığı gibi).
- 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.
- İmzalı APK'yı
adbaracı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.