Google Play Games Hizmetleri'ni kurma

Bu sayfada, Google Play Console kullanılarak Android oyununuz için Google Play Oyun Hizmetleri'ni nasıl kuracağınız açıklanmaktadır. Play Console, oyun hizmetlerini yönetebileceğiniz ve oyununuzu yetkilendirmek ve doğrulamak için kullanılan meta verileri yapılandırabileceğiniz merkezi bir yer sağlar.

Oyununuzu Play Console'a eklemek için aşağıdaki genel adımları uygulayın:

• Oyununuz için bir oyun projesi oluşturun ve oyunun adı ve açıklaması gibi ayrıntıları belirtin.

• Oyununuzu yetkilendirmek ve Google Play Games Hizmetleri'nde kimlik doğrulaması yapmak için gerekli kimlik bilgilerini oluşturun ve bu kimlik bilgilerini Google Play Games Hizmetleri'ne bağlayın.

Başlamadan önce

• Play Console'da oluşturulmuş bir Google Play Geliştirici hesabınız olmalıdır. Daha fazla bilgi için Google Play Geliştirici hesabına kaydolma bölümüne bakın.

• Düzenleme izni verme: Play Console'da Play Oyun Hizmetleri ayarlarını düzenleyebilmek için ekibinizin Play Games Hizmetleri'ni yönetme izinlerine sahip olması gerekir. Daha fazla bilgi için Geliştirici hesabı kullanıcıları ekleme ve izinleri yönetme bölümüne bakın.

Play Console'da oturum açma

Oturum açmak için Google Play Console'a gidin. Daha önce Play Console'a kaydolmadıysanız bunu yapmanız istenir.

Oyununuzu Play Console'a ekleyin

Oyununuzu eklemek için aşağıdaki adımları uygulayın:

1. Play Console'da bir uygulama oluşturup bunun bir oyun olduğunu belirtin. Daha fazla bilgi için Uygulamanızı oluşturma ve ayarlama bölümünü inceleyin.

2. Büyüme > Play Oyun Hizmetleri > Kurulum ve yönetim > Yapılandırma'ya gidin.

3. Oyununuzun halihazırda Google API'lerini (ör. Firebase) kullanıp kullanmadığını belirtin. Doğru seçeneği belirlemeniz önemlidir. Aksi takdirde, Google API'lerini kullanırken oyununuzda sorunlar yaşanabilir. Seçenekler aşağıda açıklanmıştır:

   • Hayır, oyunumda Google API'leri kullanılmıyor: Yeni bir oyun oluşturuyorsanız veya bunun için daha önce bir Google API kurmadıysanız bu seçeneği belirleyin. Oyununuzun adını girin ve ardından Oluştur'u tıklayın.

   • Evet, oyunumda zaten Google API'leri kullanılıyor: Oyun için daha önce bir Google API'si oluşturduysanız bu seçeneği belirleyin. Bu durumda Google Cloud Console'da projelerinizin bir listesini görürsünüz. Listeden projenizi seçip Kullan'ı tıklayın.

   • Mevcut bir Play Games Hizmetleri projesini kullanma: Mevcut bir Play Games Hizmetleri projesini kullanmak istiyorsanız bu seçeneği belirleyin. Hesabınızla ilgili mevcut Play Oyun Hizmetleri projelerinin bir listesini görürsünüz. Listeden oyun projenizi seçin ve Kullan'ı tıklayın. Bu tipik bir seçim olmasa da paket adını değiştirmek için Play Console'da yeni bir oyun oluşturuyorsanız veya oyununuzun farklı paket adlarına sahip ücretsiz ve ücretli sürümleri varsa bunu yapabilirsiniz.

   Play Games Hizmetleri oyun projesi oluşturulur ve Google Cloud Console'da sizin için buna karşılık gelen bir giriş oluşturulur.

4. Özellikler bölümünde, oyununuzun açıklama, kategori ve grafik öğeleri gibi bilgileri eklemek için Özellikleri Düzenle'yi tıklayın. Aşağıda, özellikleri uyumlu hale getirmek için bazı yönergeler verilmiştir:

   • Test için yalnızca görünen ad gerekir. Oyununuzu yayınlamadan önce diğer alanları doldurmanız gerekir.

   • Oyununuzun görünen adı ve açıklaması, oyununuzun Play Store girişinde ayarladığınız ad ve açıklamayla eşleşmelidir.

   • Grafik öğelerinin oluşturulmasıyla ilgili yönergeler için Uygulamanızı sergilemek için önizleme öğeleri ekleme ve Google Play Öne Çıkan Resim Kuralları'na bakın.

OAuth 2.0 istemci kimliği oluşturma

Oyununuzun kimliğinin doğrulanması ve Google Play Games Hizmetleri'ni çağırma yetkisi verilmesi için OAuth 2.0 istemci kimliğine sahip olması gerekir. İstemci kimliği ile oyununuz arasındaki ilişkilendirme olan Play Games Hizmetleri için kimlik bilgisi oluşturmak amacıyla istemci kimliğini oluşturmak için Google Cloud Platform'u kullanın. Ardından, Google Play Console'u kullanarak kimlik bilgisi ekleyin ve istemci kimliğini oyununuza bağlayın.

Daha ayrıntılı talimatlar için aşağıdaki adımlara göz atın:

OAuth kullanıcı rızası ekranını yapılandırın

OAuth izin ekranını henüz yapılandırmadıysanız Kimlik bilgileri bölümünde yapılandırmanızı isteyen bir mesaj görüntülenir.

Yapılandır'ı tıklayın. Daha fazla talimat içeren bir iletişim kutusu ve Google Cloud Platform'a derin bir bağlantı açılır.

İzin ekranının, oyunun kullanılabilir olduğu herkesin erişimine açık olduğundan emin olun. Nihai kapsam listesinin games, games_lite ve drive.appdata içermesi gerekir. Bu kapsamların hiçbiri için uygulama doğrulaması gerekmez. İzin ekranını hemen yayınlamanızı öneririz. Bu mümkün değilse oyunda oturum açmalarına izin vermek için izin ekranını test kullanıcılarının kullanımına sunabilirsiniz.

OAuth izin ekranının kurulumunu tamamladıysanız Bitti'yi tıklayın. Google Play Console otomatik olarak yenilenir. Yapılandırma başarılı olursa kimlik bilgisi oluşturabilirsiniz:

Kimlik bilgisi oluştur

Oyununuzun Google Play Games Hizmetleri ile iletişim kurmasını yetkilendirmek için yetkili OAuth2 istemci kimliğine sahip bir kimlik bilgisi oluşturmanız gerekir.

Kimlik bilgileri bölümünde, Kimlik bilgisi ekle'yi tıklayın.

Sihirbazda, Android kimlik bilgisi mi (oyun APK'nız kullanıcının kimliğini doğrulayıp Play Games Hizmetleri API'lerini kullanacaksa) veya bir oyun sunucusu kimlik bilgisi (oyun sunucunuz Play Games Hizmetleri API'lerini kullanacaksa) oluşturmak isteyip istemediğinizi seçin. İstediğiniz kimlik bilgisi türüne özel talimatları uygulayın.

Android

Kimlik bilgisi ayrıntılarını ayarlama

Ad alanındaki adın oyununuzun adıyla eşleştiğinden emin olun. Korsanlıkla Mücadele'yi etkinleştirip etkinleştirmeyeceğinizi seçin.

Yetkilendirmeyi ayarlayın

Ardından, bu oyun projesi için kullanılacak OAuth istemci kimliğini seçin. Zaten OAuth2 istemci kimlikleriniz varsa birini seçebilirsiniz. Ancak genellikle yeni bir hesap oluşturursunuz. OAuth istemcisi oluştur'u tıklayın. Bu işlem, derin bağlantıları ve Google Cloud Platform'da OAuth İstemci Kimliği oluşturma talimatlarını içeren bir iletişim kutusu açar.

1. Uygulama türü olarak Android'i seçin.
2. Ad alanına oyununuzun adını girin.
3. Android uygulamanızın paket adını Paket adı alanına girin.

4. Bir terminal penceresi açıp Keytool yardımcı programını çalıştırarak sürümün SHA1 parmak izlerini alın ve hata ayıklama sertifikalarını çalıştırın.

   Sürüm sertifikası parmak izini almak için aşağıdaki komutu çalıştırın:

   keytool -list -keystore <path-to-production-keystore> -v

   Hata ayıklama sertifikası parmak izini almak için aşağıdaki komutu çalıştırın:

   keytool -list -keystore <path-to-debug-keystore> -v

   Not: Windows'da hata ayıklama anahtar deposu C:\Users\<USERNAME>\.android\debug.keystore konumunda bulunur. Mac veya Linux'ta hata ayıklama anahtar deposu genellikle ~/.android/debug.keystore konumunda bulunur.

5. Keytool yardımcı programı, anahtar deposu için bir şifre girmenizi ister. Hata ayıklama anahtar deposu için varsayılan şifre android şeklindedir. Daha sonra tuş aracı, parmak izini terminale yazdırır.

6. SHA1 parmak izini, İmzalama sertifikası dijital parmak izi (SHA1) alanına yapıştırın.

7. Oluştur'u tıklayın.

Android'de OAuth 2.0 hakkında daha fazla bilgi edinmek için OAuth2 Hizmetlerinden Kimlik Doğrulama başlıklı makaleye göz atın.

Uyarı: Bu adımda yapılandırdığınız paket adını ve imzalama sertifikasını kaydettiğinizden emin olun. Uygulamanızda farklı bir sertifika veya paket adı kullanmanız kimlik doğrulama hatalarına neden olur.

İletişim kutusunda Bitti'yi tıkladıktan sonra mevcut İstemci Kimlikleri yenilenir. Oluşturduğunuz kimlik bilgisini açılır menüden seçin ve ardından Değişiklikleri Kaydet'i tıklayın. Bu işlem, kimlik bilgilerini taslak halinde oluşturur ve oyununuzda Play Games Hizmetleri'nde kimlik doğrulaması yapabilmenizi sağlar.

Biri sürüm sertifikası parmak izine, diğeri ise hata ayıklama sertifikası parmak izine sahip olmak üzere iki kimlik bilgisi oluşturmak isteyebilirsiniz. Her ikisi için de aynı paket adını kullandığınızdan emin olun. Bu şekilde Google Play Games Hizmetleri, her iki sertifikayla da imzalanmış bağlı APK'larınızdan gelen aramaları tanıyabilir. Android için sertifika imzalama hakkında daha fazla bilgiyi Uygulamanızı imzalama bölümünde bulabilirsiniz.

Oyun sunucusu

Kimlik bilgisi ayrıntılarını ayarlama

Ad alanındaki adın oyununuzun adıyla eşleştiğinden emin olun.

Yetkilendirmeyi ayarlayın

Ardından, bu oyun projesi için kullanılacak OAuth istemci kimliğini seçin. Zaten OAuth2 istemci kimlikleriniz varsa birini seçebilirsiniz. Ancak genellikle yeni bir hesap oluşturursunuz. OAuth istemcisi oluştur'u tıklayın. Bu işlem, derin bağlantıları ve Google Cloud Platform'da OAuth İstemci Kimliği oluşturma talimatlarını içeren bir iletişim kutusu açar.

1. Uygulama türü olarak Web application'ı (Web uygulaması) seçin.
2. Ad alanına oyununuzun adını girin.
3. Oluştur'u tıklayın.

Android'de OAuth 2.0 hakkında daha fazla bilgi edinmek için OAuth2 Hizmetlerinden Kimlik Doğrulama başlıklı makaleye göz atın.

İletişim kutusunda Bitti'yi tıkladıktan sonra mevcut İstemci Kimlikleri yenilenir. Oluşturduğunuz kimlik bilgisini açılır menüden seçin ve ardından Değişiklikleri Kaydet'i tıklayın. Bu işlem, kimlik bilgilerini taslak halinde oluşturur ve oyun sunucunuzdan Play Games Hizmetleri'nde kimlik doğrulama işlemi yapabilmenizi sağlar. Oyun sunucunuzla Play Oyun Hizmetleri'ni kullanma hakkında daha fazla bilgi için Google Play Games Hizmetleri'ne Sunucu Tarafı Erişimini Etkinleştirme bölümüne bakın.

Testi etkinleştir

Google Play Oyun Hizmetleri'nin oyununuzda doğru şekilde çalıştığından emin olmak için, oyun değişikliklerinizi Google Play'de yayınlamadan önce oyun hizmetlerinizi test etmeniz gerekir.

Oyununuz yayınlanmamış durumdaysa, kullanıcı hesaplarını izin verilenler listesine ekleyerek test kullanıcılarınıza erişim izni verin. Aksi takdirde test kullanıcılarınız, Play Games Hizmetleri uç noktalarına (ör. oturum açma uç noktası) erişmeye çalıştıklarında OAuth ve 404 hatalarıyla karşılaşır.

Yetkili test hesapları olan kullanıcılar, yayınlanmamış Play Games Hizmetleri oyun projenize erişebilir ve yapılandırılmış Play Games Hizmetlerinizin düzgün çalışıp çalışmadığını test edebilirler.

Önemli: Kendinizi test kullanıcısı olarak eklemeyi unutmayın. Aksi takdirde Play Games SDK'sı kullanıcı hesabınızda çalışmaz.

Test kullanıcılarının oyununuz için Play Games Hizmetleri API'lerini kullanmalarını sağlamanın iki yolu vardır:

• Bireysel düzeyde, tek tek e-posta adresleri ekleyerek.

• Grup düzeyinde, bir Play Console sürüm kanalı için Play Oyun Hizmetleri'ni etkinleştirerek

Oyun projenize bağımsız test kullanıcıları eklemek için:

1. Google Play Console'da oyununuzun Test kullanıcıları sekmesini açın (Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Test Kullanıcıları).
2. Test kullanıcıları ekle düğmesini tıklayın.
3. Görüntülenen iletişim kutusunda, test kullanıcısı olarak eklemek istediğiniz Google Hesaplarının e-posta adreslerini girin (virgülle veya her satıra bir e-posta adresiyle ayrılmış olarak).
4. Kullanıcıları test kullanıcısı olarak kaydetmek için Ekle'yi tıklayın. Eklediğiniz test kullanıcısı hesapları birkaç saat içinde Play Games Hizmetleri'ne erişebilir.

Bir gruba test erişimi vermek için bir sürüm kanalını etkinleştirerek Play Games Hizmetleri'ne erişin:

Google Play, sürüm kanalı özellikleriyle uygulamanızın yayın öncesi sürümlerini kontrol edilen güvenilir kullanıcı gruplarına dağıtmayı kolaylaştırır. Google Play Yardım web sitesinde açık, kapalı veya dahili test oluşturma konusuna bakın.

Belirli bir sürüm kanalında test APK'larına erişimi olan tüm kullanıcılara oyununuzu test etme erişimi verebilirsiniz. Bu işlem, test kullanıcısı listesine tek tek eklediğiniz gibi çalışır. Bunu yapmak için şu adımları uygulayın:

1. PGS Test Kullanıcıları bölümünü (Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Test kullanıcıları) açın ve Sürüm kanalları sekmesini seçin. Bu sayfada, Play Games Hizmetleri testi için etkinleştirilmiş parçaların listesini de görebilirsiniz.
2. Parça ekle'yi tıklayın.
3. Play Oyun Hizmetleri testi için etkinleştirilecek bir veya daha fazla kanal seçin.
4. Parça Ekle'yi tıklayın.

Seçilen sürüm kanalları artık Play Games Hizmetleri testi için etkinleştirilen kanallar listesinde görünür.

Bu özelliği yalnızca Google Play Console'da oyununuza bağlı bir Android uygulamanız varsa kullanabilirsiniz.

Yaygın sorunlardan kaçınma

Yaygın kurulum hatalarından kaçınmak için, oyununuzu Google Play Games Hizmetleri'ni kullanacak şekilde yapılandırırken bu önerileri uyguladığınızdan emin olun.

1. Oyununuzu Play Console ile ayarlama

Google Cloud Console'da uygulamanız için Oauth 2.0 istemci kimliği oluşturduysanız Google Play Games Hizmetleri, oyunun başarılar ile skor tabloları ve istemci kimliği arasındaki ilişkilendirmeden haberdar olmaz. Bu ilişkilendirmeyi oluşturmak için Oauth 2.0 istemci kimliğini kullanarak Kimlik bilgisi oluşturma bölümünde açıklandığı gibi bir kimlik bilgisi oluşturmanız gerekir.

2. Android'de doğru uygulama kimliğini kullanma

Uygulama kimliği, Android manifestinizde referans vermeniz gereken gerekli bir dize kaynağıdır. Uygulama kimliği dizesi, yalnızca Play Console tarafından sağlanan istemci kimliğinin başındaki rakamlardan (genellikle 12 veya daha fazla) oluşur. Uygulama kimliği, Yapılandırma sayfasının üst kısmında bulunabilir ve oyununuzun adının altında Proje Kimliği olarak etiketlenir.

3. APK'nızı doğru sertifikayla imzalayın

Android uygulamanızı Play Console'da oyununuza bağlarken, uygulamanızı yayınlamak için kullandığınız paket adı ve sertifika parmak izinin aynısını kullanmanız gerekir. Uyuşmazlık varsa Google Play Games Hizmetleri'ne yapılan çağrılar başarısız olur. Biri sürüm sertifikası dijital parmak izine, diğeri ise hata ayıklama sertifikası dijital parmak izine sahip iki istemci kimliği oluşturmanız ve her ikisi için de aynı paket adını kullanmanız gerekir. Play Console'da imzalama sertifikasının nasıl belirtileceği hakkında daha fazla bilgi edinmek için Uygulamalarınızı İmzalama bölümüne bakın.

4. Android için geliştirme yaparken Play Games SDK'sını bağımsız bir JAR olarak değil, kitaplık projesi olarak ekleyin.

Google Play Hizmetleri SDK'sına Android projenizde bir kitaplık projesi olarak referansta bulunulduğundan emin olun. Aksi takdirde, uygulamanız Google Play Hizmetleri kaynaklarını bulamadığında hatalar oluşabilir. Google Play Hizmetleri'ni kullanmak üzere Android projenizi nasıl ayarlayacağınızı öğrenmek için Google Play Hizmetleri'ni Kurma bölümüne bakın.

5. Geliştirme sırasında test kullanıcısı hesabıyla oturum açma

Oyun ayarı değişikliklerinizi Play Console'da yayınlamadıysanız beyaz listeye eklenmiş bir test kullanıcısı hesabıyla oturum açmadıysanız test sırasında hatalarla karşılaşabilirsiniz. Test için her zaman Play Console yayıncı hesabınızı etkinleştirmeniz gerekir. Test kullanıcısı hesaplarını nasıl yöneteceğinizi öğrenmek için Hesapları test için etkinleştirme konusuna bakın.

6. İzin ekranını Google Cloud Platform'da yayınlama

Uygulamayı Play Console'da yayınlamadan önce, izin ekranını Google Cloud Platform'da yayınlayın. Bu adım olmadan herkese açık kitle, Play Games Hizmetleri özelliklerinin hiçbirini kullanamaz.

7. Sürümde, oyununuzu yayınlamadan önce Play Oyun Hizmetleri ayarlarını yayınlayın

Geliştiriciler, uygulamalarıyla ilgili Play Games Hizmetleri ayarlarını yayınlamadan yanlışlıkla uygulamalarını yayınlayabilirler. Bu durum, uygulama doğru oyun ayarlarına başvuramayacağından test kullanıcısı olmayan hesaplarla oturum açan oyuncuların hatalarla karşılaşmasına neden olabilir. Oyununuzu yayınlarken öncelikle Play Console'daki Oyunu Yayınla seçeneğini kullanarak oyun ayarlarınızı yayınlamayı unutmayın. Değişikliklerinizi nasıl yayınlayacağınızı öğrenmek için Oyun değişikliklerinizi yayınlama bölümünü inceleyin.

Ek ipuçları için Android sorun giderme kılavuzuna bakın.

Sonraki adımlar

Yukarıda açıklanan ilk kurulum görevlerini tamamladıktan sonra oyununuz için kayıtlı oyunlar, skor tabloları ve başarılar gibi Play Oyun Hizmetleri özelliklerini etkinleştirebilirsiniz.