Bu sayfa, Cloud Translation API ile çevrilmiştir.

Google Play Games Hizmetleri'ni kurma

Bu sayfada, Google Play Console'u kullanarak Android oyununuz için Google Play Oyun Hizmetleri'ni nasıl ayarlayacağınız açıklanmaktadır. Play Console, oyun hizmetlerini yönetmenize ve oyununuzu yetkilendirmek ve kimlik doğrulaması yapmak için kullanılan meta verileri yapılandırmanıza olanak tanıyan merkezi bir yerdir.

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 Google Play Oyun Hizmetleri'ne yetkilendirmek ve kimlik doğrulaması yapmak için gerekli kimlik bilgilerini oluşturup bağlayın.

Başlamadan önce

Google Play Games Hizmetleri'ni yapılandırmadan önce aşağıdaki adımları tamamlayın.

Google Play Geliştirici hesabı oluşturma

Play Console'da bir Google Play Geliştirici hesabınız olmalıdır. Daha fazla bilgi için Google Play Geliştirici hesabına kaydolma başlıklı makaleyi inceleyin.
Düzenleme izni verin: Play Console'da Play Games Hizmetleri ayarlarını düzenlemek için ekibinizin Play Games Hizmetleri'ni yönetme iznine sahip olması gerekir. Daha fazla bilgi için Geliştirici hesabı kullanıcıları ekleme ve izinleri yönetme başlıklı makaleyi inceleyin.

Google Cloud projesi oluşturma

Bir Google Cloud projesi oluşturmuş olmanız gerekir. Daha fazla bilgi için

Play Console'u kullanmak için projenizle kullanmayı planladığınız API'leri etkinleştirmeniz gerekir.

Konsol

Google Play Game Services API'yi etkinleştirme

gcloud

gcloud services enable \
   --project "PROJECT" \
   "games.googleapis.com"

Play Console'da oturum açma

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

Oyununuzu Play Console'a ekleme

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

Play Console'da bir uygulama oluşturun ve uygulamanın oyun olduğunu belirtin. Daha fazla bilgi için Uygulamanızı oluşturma ve ayarlama başlıklı makaleyi inceleyin.
Büyüme > Play Games Hizmetleri > Kurulum ve yönetim > Yapılandırma'ya gidin.
Oyununuzda zaten Google API'lerinin (ör. Firebase) kullanılıp kullanılmadığını belirtin. Doğru seçeneği belirlemeniz önemlidir. Aksi takdirde, oyununuzda Google API'leri kullanılırken sorunlar yaşanabilir. Seçenekler şunlardır:
- Hayır, oyunumda Google API'leri kullanılmıyor: Yeni bir oyun oluşturuyorsanız veya oyununuz için hiç Google API'si ayarlamadıysanız bu seçeneği belirleyin. Oyununuzun adını girin ve Oluştur'u tıklayın.
- Evet, oyunumda zaten Google API'leri kullanılıyor: Oyun için zaten bir Google API'si oluşturduysanız bu seçeneği belirleyin. Bu durumda, Google Cloud Console'daki projelerinizin listesini görürsünüz. Listeden projenizi seçin ve Kullan'ı tıklayın.
- Mevcut bir Play Games Hizmetleri projesini kullan: Mevcut bir Play Games Hizmetleri projesini kullanmak istiyorsanız bu seçeneği belirleyin. Hesabınızdaki mevcut Play Oyun Hizmetleri projelerinin listesini görürsünüz. Listeden oyun projenizi seçin ve Kullan'ı tıklayın. Bu, yaygın bir seçim değildir ancak Play Console'da paket adını değiştirmek için yeni bir oyun oluşturuyorsanız veya oyununuzun farklı paket adlarına sahip ücretsiz ve ücretli sürümleri varsa bunu yapabilirsiniz.
Bir Play Games Hizmetleri oyun projesi oluşturulur ve Google Cloud Console'da sizin için ilgili bir giriş oluşturulur.
Oyununuzun açıklaması, kategorisi ve grafik öğeleri gibi bilgileri eklemek için Özellikler bölümünde Özellikleri düzenle'yi tıklayın. Mülkleri yapılandırmayla ilgili bazı yönergeler aşağıda verilmiştir:
- Test için yalnızca görünen ad gereklidir. Oyununuzu yayınlayabilmek için diğer alanları doldurmanız gerekir.
- Oyununuzun görünen adı ve açıklaması, oyununuzun Play Store girişinde ayarladığınız bilgilerle eşleşmelidir.
- Grafik öğeleri oluşturmayla ilgili kurallar için Uygulamanızı sergilemek için önizleme öğeleri ekleme başlıklı makaleyi ve Google Play Öne Çıkan Resim Kuralları'nı inceleyin.

OAuth 2.0 istemci kimliği oluşturma

Oyununuzun kimlik doğrulaması yapılabilmesi ve Google Play Games Hizmetleri'ni çağırabilmesi için bir OAuth 2.0 istemci kimliği olmalıdır. Play Games Hizmetleri için kimlik bilgisi oluşturmak istiyorsanız (istemci kimliği ile oyununuz arasındaki ilişkilendirme) istemci kimliğini oluşturmak üzere Google Cloud Platform'u kullanın. Ardından, istemci kimliğini oyununuza bağlayarak Google Play Console'u kullanarak bir kimlik bilgisi ekleyin.

Daha ayrıntılı talimatlar için aşağıdaki adımları inceleyin:

OAuth izin ekranını yapılandırma

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österilir.

OAuth izin ekranını yapılandırma istemi

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

OAuth izin ekranınızı yapılandırmanız istenir.

İzin ekranının, oyunun kullanılabildiği herkese açık olduğundan emin olun. Nihai kapsam listesinde games, games_lite ve drive.appdata bulunmalıdır. 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 test kullanıcılarının oyunda oturum açmasına izin vermek için izin ekranını test kullanıcılarına sunabilirsiniz.

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

Kimlik bilgisi oluşturma

Oyununuzu Google Play Games Hizmetleri ile iletişim kurması için yetkilendirmek üzere yetkili bir OAuth2 istemci kimliği içeren bir kimlik bilgisi oluşturmanız gerekir.

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

Sihirbazda, Android kimlik bilgisi (oyun APK'nız kullanıcının kimliğini doğrulayacak ve Play Oyun Hizmetleri API'lerini kullanacaksa) mi yoksa oyun sunucusu kimlik bilgisi (oyun sunucunuz Play Oyun Hizmetleri API'lerini kullanacaksa) mi oluşturmak istediğinizi seçin. İstediğiniz kimlik bilgisi türüne özel talimatları uygulayın.

Yapay Zeka

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 ayarlama

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

Uygulama türü olarak Android'i seçin.
Ad alanına oyununuzun adını girin.
Paket adı alanına Android uygulamanızın paket adını girin.
Sürüm ve hata ayıklama sertifikalarının SHA1 parmak izlerini almak için bir terminal açın ve Keytool yardımcı programı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'ta hata ayıklama anahtar mağazası şu konumda bulunur: C:\Users\<USERNAME>\.android\debug.keystore. Mac veya Linux'ta hata ayıklama anahtar mağazası genellikle ~/.android/debug.keystore adresinde bulunur.
İsteğe bağlı: Unity Hub'ı kullanarak yeni bir anahtar mağazası oluşturduysanız önceki adımdaki talimatları kullanarak yeni bir sertifika oluşturmayın. Unity'de oluşturduğunuz SHA1 parmak izini kullanın.
- SHA1 parmak izini terminale yazdırmak için aşağıdaki komutu kullanın:
  
  keytool -list -keystore <var>path</var>/<var>name_of_keystore</var>.keystore -v
Anahtar aracı, anahtar deposu için şifre girmenizi ister. Ardından anahtar aracı, parmak izini terminale yazdırır.
SHA1 parmak izini İmza sertifikası parmak izi (SHA1) alanına yapıştırın.
Oluştur'u tıklayın.

Android'de OAuth 2.0 hakkında daha fazla bilgi için OAuth2 Hizmetleri için Kimlik Doğrulama başlıklı makaleyi inceleyin.

Bir sürüm sertifikası parmak izi ve bir hata ayıklama sertifikası parmak izi içeren iki kimlik bilgisi oluşturabilirsiniz. Her ikisi için de aynı paket adını kullandığınızdan emin olun. Bu, Google Play Games Hizmetleri'nin, bağlı APK'larınızdan gelen ve bu iki sertifika ile imzalanan çağrıları tanımasına olanak tanır. Android için sertifika imzalama hakkında daha fazla bilgi edinmek isterseniz Uygulamanızı imzalama başlıklı makaleyi inceleyin.

Oyun sunucusu

Kimlik bilgisi ayrıntılarını ayarlama

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

Yetkilendirmeyi ayarlama

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

Android'de OAuth 2.0 hakkında daha fazla bilgi için OAuth2 Hizmetlerinde Kimlik Doğrulama başlıklı makaleyi inceleyin.

İletişim kutusunda Bitti'yi tıkladıktan sonra kullanılabilir istemci kimlikleri yenilenir. Açılır menüden oluşturduğunuz kimlik bilgisini seçin ve ardından Değişiklikleri Kaydet'i tıklayın. Bu işlem, kimlik bilgisini taslak olarak oluşturur ve oyun sunucunuzdan Play Oyun Hizmetleri'nde kimlik doğrulama yapmanıza olanak tanır. Play Oyun Hizmetleri'ni oyun sunucunuzla kullanma hakkında daha fazla bilgi için Google Play Oyun Hizmetleri'ne Sunucu Tarafından Erişimi Etkinleştirme başlıklı makaleyi inceleyin.

Testi etkinleştirme

Google Play Games 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, giriş uç noktası gibi Play Oyun Hizmetleri uç noktalarına erişmeye çalışırken OAuth ve 404 hatalarıyla karşılaşır.

Yetkili test hesaplarına sahip kullanıcılar, yayınlanmamış Play Games Hizmetleri oyun projenize erişebilir ve yapılandırılmış Play Games Hizmetleri'nin doğru şekilde çalışıp çalışmadığını test edebilir.

Test kullanıcılarının oyununuz için Play Games Hizmetleri API'lerini kullanmasına izin vermenin iki yolu vardır:

Tek tek e-posta adresleri ekleyerek bireysel düzeyde.
Grup düzeyinde, Play Console sürüm kanalı için Play Games Hizmetleri'ni etkinleştirerek.

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

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ı).
Test kullanıcısı ekle düğmesini tıklayın.
Açılan iletişim kutusuna, test kullanıcısı olarak eklemek istediğiniz Google Hesaplarının e-posta adreslerini virgülle ayrılmış şekilde veya satır başına bir e-posta adresi olacak şekilde girin.
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 Play Games Hizmetleri'ne erişmek üzere bir sürüm kanalını etkinleştirin:

Google Play, yayın kanalı özellikleriyle uygulamanızın yayın öncesi sürümlerini kontrollü 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 başlıklı makaleyi inceleyin.

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

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

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

Bu özellik yalnızca Google Play Console'da oyununuza bağlı bir Android uygulamanız varsa kullanılabilir.

Yaygın sorunları önleyin

Sık karşılaşılan kurulum hatalarından kaçınmak için oyununuzu Google Play Games Hizmetleri'ni kullanacak şekilde ayarlarken bu önerileri uyguladığınızdan emin olun.

1. Play Console ile oyununuzu ayarlama: Google Cloud Console'da uygulamanız için bir OAuth 2.0 istemci kimliği oluşturduysanız Google Play Games Hizmetleri, oyunun başarıları ve lider tabloları ile istemci kimliği arasındaki ilişkiden haberdar olmaz. Bu ilişkilendirmeyi oluşturmak için Kimlik bilgisi oluşturma bölümünde açıklandığı şekilde OAuth 2.0 istemci kimliğini kullanarak bir kimlik bilgisi oluşturmanız gerekir.
2. Android'de doğru uygulama kimliğini kullanma: Uygulama kimliği, Android manifest dosyanızda referans vermeniz gereken zorunlu 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ğini, Yapılandırma sayfasının üst kısmında bulabilirsiniz. Bu kimlik, oyununuzun adının altında Proje Kimliği olarak etiketlenmiştir.
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ını ve sertifika parmak izini aynen kullanmanız gerekir. Eşleşme olmazsa Google Play Games Hizmetleri'ne yapılan çağrılar başarısız olur. Biri sürüm sertifikası parmak izi, diğeri hata ayıklama sertifikası parmak izi içeren iki istemci kimliği oluşturmalı ve her ikisi için de aynı paket adını kullanmalısınız. Play Console'da imzalama sertifikasını nasıl belirteceğiniz hakkında daha fazla bilgi edinmek için Uygulamalarınızı imzalama başlıklı makaleyi inceleyin.
4. Android için geliştirme yaparken Play Games SDK'sını bağımsız JAR olarak değil, kitaplık projesi olarak ekleyin.: Google Play Hizmetleri SDK'sına Android projenizde kitaplık projesi olarak referans verildiğinden emin olun. Aksi takdirde, uygulamanız Google Play Hizmetleri kaynaklarını bulamadığı zaman hatalarla karşılaşabilirsiniz. Android projenizi Google Play Hizmetleri'ni kullanacak şekilde nasıl ayarlayacağınızı öğrenmek için Google Play Hizmetleri'ni ayarlama başlıklı makaleyi inceleyin.
5. Geliştirme sırasında test kullanıcısı hesabıyla oturum açma: Oyun ayarlarınızdaki değişiklikleri Play Console'da yayınlamadıysanız, izin verilenler listesinde yer alan bir test kullanıcısı hesabıyla oturum açmadıysanız test sırasında hatalarla karşılaşabilirsiniz. Play Console yayıncı hesabınızı test için her zaman etkinleştirmeniz gerekir. Test kullanıcısı hesaplarını nasıl yöneteceğinizi öğrenmek için Hesapları test için etkinleştirme başlıklı makaleyi inceleyin.
6. Kullanıcı rızası ekranını Google Cloud Platform'da yayınlama: Uygulamayı Play Console'da yayınlamadan önce kullanıcı rızası ekranını Google Cloud Platform'da yayınlayın. Bu adım olmadan herkese açık kitle Play Games Hizmetleri özelliklerinden hiçbirini kullanamaz.
7. Oyununuzu yayınlamadan önce Play Games Hizmetleri ayarlarını yayınlayın: Geliştiriciler, uygulamalarının ilgili Play Games Hizmetleri ayarlarını yayınlamadan uygulamalarını yanlışlıkla yayınlayabilir. Bu durum, uygulama doğru oyun ayarlarına atıfta bulunamadığı için test kullanıcısı olmayan hesaplar ile oturum açan oyuncuların hatalarla karşılaşmasına neden olabilir. Oyununuzu yayınlarken önce Play Console'daki Oyun 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 başlıklı makaleyi inceleyin.

Daha fazla ipucu 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, lider tabloları ve başarılar gibi Play Oyun Hizmetleri özelliklerini etkinleştirebilirsiniz.