Sık sorulan sorular

Bu belgede, PC Üzerinde Google Play Games için SDK'lar ve yayınlama hakkında sık sorulan soruların yanıtları yer alır.

Para kazanma

1. Yeni bir faturalandırma veya lisanslama anahtarı ekledikten sonra satın alma sürecim neden 6 numaralı hata koduyla başarısız oluyor?

   Google Play Console'da yeni oluşturulan lisanslama anahtarları, Google Play'in dahili önbellekleri tüm sunum ortamlarında senkronize edilmeden önce ticaret arka ucunda birkaç saatlik önbelleğe alma ve yayılma gecikmesi yaşar. Oyun istemciniz ürün ayrıntılarını başarıyla sorgulayabilse de senkronizasyon tamamlanana kadar satın alma istekleri 6 numaralı hata koduyla başarısız olur. Lisans anahtarınızı yükledikten veya güncelledikten sonra satın alma işlemlerini test etmeden önce birkaç saat bekleyin.

2. Satın alma sürecini arka uç sunucusu olmadan kullanabilir miyim?

   Google, güvenlik açısından arka uç sunucusu kullanmanızı önerir.

   Daha fazla bilgi için Arka uç sunucusu olmadan işleme başlıklı makaleyi inceleyin.

3. PC Üzerinde Google Play Games SDK'sı entegre edildikten sonra mevcut API tabanlı ödeme sistemlerine izin verilir mi?

   Tüm ödemeler, Google Play Faturalandırma kullanılarak PC Üzerinde Google Play Games SDK'sı tarafından işlenmelidir. Aynı oyunda mevcut API tabanlı ödeme yönteminizi kullanamazsınız.

4. Geliştirici modunda satın alma işlemlerini nasıl tüketebiliriz?

   Geliştirici modunda satın alma işlemini 3 dakika içinde tamamlayın. Aksi takdirde satın alma işlemi için geri ödeme yapılır.

5. Yinelenen ödemeler veya abonelikler destekleniyor mu?

   Yakın gelecekte böyle bir planımız yok. Ancak gelecekteki yol haritamıza eklememiz için belirli kullanım alanları önerebilirsiniz.

6. Satın alma aramalarımda faturalandırma hatası nedir?

   BillingError, ödeme sonucunun yanıtıdır. LaunchPurchaseFlow, engelleme olmadan hemen geri döner ancak ne zaman bittiğini öğrenmek ve sonucu yakalamak için geri aramayı dinlemeniz gerekir.

7. İstemci taraflı satın almayı doğrulamayı nasıl kullanabilirim?

   Sunucu tarafı satın alma ve doğrulama sürecini kullanmanızı öneririz. İstemci uygulamanızdan yapılan satın alma işlemlerinin işlenmesi için oyununuzun izin verilenler listesinde olması gerekir. Oyununuzun erişime ihtiyacı varsa lütfen Google İş Ortağınızla iletişime geçin. Daha fazla bilgi için Arka uç sunucusu olmadan işleme başlıklı makaleyi inceleyin.

8. Ürün ayrıntılarını sorgulamayla ilgili API sınırları nelerdir?

   QueryProductDetails API'sine yapılan tek bir çağrıda sorgulanabilecek maksimum ürün sayısı 50'dir. Bu sınırı aşarsanız isteği birden fazla çağrıya bölmeniz gerekir.

9. Çok sayıda ürün SKU'su yüklenirken ürün sorguları veya satın alma süreçleri neden dahili hatalarla başarısız oluyor?

   Aynı anda çok fazla ürün SKU'su sorgulamak veya kısa bir süre içinde C++'ta QueryProductDetails ya da Unity'de QueryProductDetailsAsync işlevini çok fazla kez çağırmak (örneğin, dar bir döngüde onlarca toplu çağrı göndermek veya grup başına yeni bir BillingClient örneği oluşturmak) yerel IPC ve arka uç bağlantılarını aşırı yükleyebilir. Bu bağlantılar sıfırlandığında ürün ayrıntısı sorguları başarısız olur ve oyununuz, satın alma sürecini başlatmak için gereken teklif jetonlarını alamaz.

   Kataloğunuzu yüklerken bu hataları önlemek için aşağıdaki uygulamaları takip edin:

   • Çağrı başına desteklenen ürün sayısına uyun: Tek bir QueryProductDetails veya QueryProductDetailsAsync çağrısında en fazla 50 ürün sorgulayın ve tüm kataloğu tekrar tekrar sorgulamak yerine döndürülen ProductDetails değerini bellekte önbelleğe alın. Desteklenen toplu işlem sınırları ve ürün ayrıntılarını sorgulama hakkında daha fazla bilgi için önceki API sınırları sorusuna, C++ için Satın alınabilecek ürünleri gösterme ve Unity için Ürün ayrıntılarını sorgulama bölümüne bakın.
   • API'leri kısa bir süre içinde çok fazla kez art arda çağırmaktan kaçının: Birden fazla ürün sorgusu grubunu aynı anda veya aralık vermeden art arda göndermeyin. Tek bir BillingClient örneğini yeniden kullanın, istekleri serileştirin veya eşzamanlılığı aynı anda iki ya da üç etkin çağrıyla sınırlayın ve ardışık gruplar arasına kısa bir gecikme ekleyin.
   • En yeni SDK'ya güncelleyin: En yeni faturalandırma ve IPC kararlılık iyileştirmelerinin istemcinizde yer aldığından emin olmak için entegrasyonunuzu, PC Üzerinde Google Play Games SDK'sı indirme sayfasından PC Üzerinde Google Play Games SDK'sının en yeni sürümüne (C++ için 26.9.261.0 veya Unity için 26.9.261.0) güncelleyin.

10. Billing Client'ta Query Purchases veya Launch Purchase Flow çağrılırken hangi parametreler gereklidir?

    İşlev, std::function<void(QueryPurchasesResult)> imzalı bir işlev geri çağırma olan QueryPurchasesContinuation değerini kabul eder. Geri çağırma, sonucu tüm ProductPurchaseDetails ile birlikte size iletir. Bu bilgiler, includes/billing/models.h dosyasındaki SDK üstbilgi dosyalarında bulunur.

    Elde edilen launch_purchase_flow_result, ok() ve code() işlevlerine sahiptir. ok() işlevi, akışın başarılı olup olmadığını döndürür. code() işlevi, BillingError enum'unu (includes/billing/enums.h) döndürür. Bu enum'da, kullanıcının iptal etmesi veya ağ hatası gibi 10 olası hata durumu vardır.

11. Faturalandırma istemcisinde satın alma sürecini başlatma için özel sıralama destekleniyor mu?

    Mevcut SDK tasarımında kendi yükünüzü iletmenin bir yolu yoktur. Ancak obfuscated_account_id ve obfuscated_profile_id değerlerinin herhangi bir kombinasyonunu sağlayabilirsiniz. Hiçbirini, yalnızca birini veya her ikisini de sağlayabilirsiniz.

    offer_token alanı zorunludur ve kullanıcının ödeme adımlarında satın almaya çalıştığı satın alma teklifini belirtir. Şu anda Google Play'deki her SKU'da tam olarak bir teklif bulunmaktadır (örneğin, bir öğeyi 10 ABD dolarına satın alma). Gelecekte Google Play Faturalandırma ekibi birden fazla teklif için destek sunacaktır.

    Satın alma süreci kesintiye uğradığında meta verilerin ilişkilendirildiğinden emin olmak için satın alma iletişim kutusunu başlatmadan önce meta verileri arka uç sunucunuzda depolayın ve kullanıcınızın hesap kimliği, satın alınan SKU ve geçerli zaman damgasıyla ilişkilendirin. Daha fazla bilgi için Satın alma işlemini dahili verilerle ilişkilendirme başlıklı makaleyi inceleyin.

12. OAuth ile Google faturalandırmasından DLL tabanlı Google faturalandırmasına geçiş için ön koşullar nelerdir?

    Oyunlar, oturum açılan hesabı yönetmek için Google ile OAuth oturum açma özelliğini kullanmaya devam edebilir ancak Google, eski REST faturalandırma API'lerini kullanmayı bırakmanızı önerir. REST faturalandırma API'lerinden (OAuth2 oturum açma ile) SDK akışına geçiş, özellik bayraklı bir işlem olabilir. Bu nedenle, oyun geçiş yaparken her ikisi de bir süre birlikte kullanılabilir.

13. Satın alma süreci başlatma API çağrısı bir web tarayıcısı üzerinden mi işleniyor?

    Hayır, satın alma süreci artık oyun istemcisinden çıkmadan, sorunsuz bir WebView yer paylaşımı kullanılarak tamamen oyun içinde tamamlanıyor.

14. Kullanıcıların satın alma işlemi yapmak için her oyunda ayrı ayrı oturum açması gerekir mi?

    Google Play Games'deki ön plan hesabı her oyun oturumu için kullanılır. Bu nedenle tekrar oturum açmanız gerekmez. Oyun oturumu başladığında Google Play Games'de kullandığınız hesap, API çağrılarının yapıldığı hesaptır. Satın alma süreci bu hesabı otomatik olarak kullanır.

15. Bir oyun aynı anda hem PC SDK'yı hem de eski ödeme sistemlerini destekleyebilir mi?

    Ödeme sistemi, oyunun ikili sürümüne bağlı olarak ikili akış modeline göre çalışır. Eski derlemeleri kullanan kullanıcılar mevcut akışta devam ederken yeni derlemeleri kullanan kullanıcılar SDK tabanlı ödemelere geçer. Geçiş döneminde her iki ödeme akışını kullanan kullanıcılar bir arada bulunur.

Windows Uygulama Paketi Grubu

1. Üçüncü taraf başlatıcı kullanarak WAB gönderirken oyun paketi inceleme için gerekli mi?

   Yalnızca yükleyicinizi gönderebilirsiniz. Oyun paketinizin tamamını göndermeniz gerekmez. İnceleme uzmanı, yükleyiciyi kullanarak oyun paketinizi indirebilir.

2. WAB dosya boyutunda herhangi bir sınırlama var mı?

   Yükleyici yayınlama için WAB'ye en fazla 10 GB boyutunda dosya yükleyebilirsiniz. Google Play Yönetilen Yayınlama için maksimum WAB dosya boyutu sınırı 200 GB'tır.

3. WAB'mi yükledikten sonra oyunum neden yüklenmiyor veya görünmüyor?

   Oyununuzun mevcut bir PC sürümü yoksa (ilk kez WAB) sistem, oyunu otomatik olarak yönetilen yayınlama bekleme durumuna alabilir. Bunun nedeni, güncellenecek mevcut bir referans olmamasıdır. WAB'yi tam olarak yayınlamak ve oyunu yüklemeye hazır hale getirmek için Google Play Console'a gidip gerekli yayınlama işlemini manuel olarak yürütmeniz (ör. "Değişiklikleri yayınla"yı tıklamanız) gerekir.

4. WAB'yi dahili test için nasıl yüklerim?

   Google'ın dahili test için etkinleştirebilmesi amacıyla izin verilenler listesindeki hesapları Google ile paylaşın. Google, listeyi aldıktan sonra bu kişilerin ilk katılım sürecine dahil edilmesini sağlar.

5. WAB paketi nereye yüklenmelidir?

   WAB paketini ilk soruda belirtilen konuma yükleyebilirsiniz. Ancak manuel olarak yayınlayamazsınız. Google arka uç personeline tam bir UTC saati (saat düzeyinde) sağlamanız gerekir. Google daha sonra yayın planını yapılandırır ve zamanında yayınlanmasını sağlar.

PC SDK'sı

1. Eski API ile PC Üzerinde Google Play Games SDK'sı arasındaki farklar nelerdir?

   • Eski API yalnızca faturalandırma işlevi sunar.
   • PC SDK'sı, Google Masaüstü Hizmeti'ni (GDS) ve tüm PC özelliklerini destekler.
   • PC SDK'sı ile tarayıcı tabanlı Google ile Oturum Açma gerekmez.

2. PC Üzerinde Google Play Games'i kullanmadan, oyunu doğrudan oyun başlatıcıyla başlatarak SDK'yı ilk kullanıma hazırlamanın alternatif bir yolu var mı?

   Oyununuz, PC Üzerinde Google Play Games istemcisi üzerinden başlatılmalıdır. Daha fazla bilgi için bu geliştirici belgesine bakın.

3. PC SDK'sı, PEM sertifika dosyasında çok baytlı karakterleri destekliyor mu?

   Evet, SDK sertifika için çok baytlı karakterleri destekler.

4. SDK, birden fazla örnek veya hesap için Google Hesabı oturum açma işlemini nasıl yönetir?

   Google Play Games'de her oyun başlatma işlemi bir "oyun oturumu" olarak kabul edilir ve her "oyun oturumu" ile ilişkilendirilmiş bir hesap olabilir. Farklı olabilirler. Yani oyunu A hesabıyla başlatıp B hesabına geçiş yapar ve oyunu yeniden başlatırsanız her iki hesap da aynı anda çalışabilir.

5. Play Install Referrer entegrasyonu PC SDK'sı ile çalışır mı?

   PC SDK'sı (25.5.409.0 ve sonraki sürümler) Play Install Referrer API'yi destekler. Daha fazla bilgi için Play Install Referrer API'yi inceleyin.

Başlatıcı

1. Oyuncular Google Play istemcisi yerine üçüncü taraf başlatıcı kullanırsa Google Play Games Hizmetleri hesapları otomatik olarak senkronize edilir mi?

   SDK işlevlerinin çalışması için oyunun doğrudan Google Play Games istemcisi üzerinden başlatılması gerekir. Oyun, yükleyici veya başlatıcı uygulama gibi başka bir işlem tarafından başlatılıyorsa bu işlemin kendisi Google Play Games istemcisinden başlatılmalıdır. Oyun, istemciden alınan tüm parametreleri istemci işlemine iletmelidir.

2. Google Play Games üçüncü taraf bir oyun başlatıcı başlatırsa başlatma işlemini nasıl yaparım?

   SDK'yı doğrudan başlatıcınıza entegre etmeniz gerekmez. Ancak başlatıcının Google Play Games istemcisinden aldığı tüm komut satırı bağımsız değişkenlerini doğrudan oluşturulan alt işleme (oyun yürütülebilir dosyası) iletmeniz gerekir. Başlatma başarısız olursa (ör. kActionRequiredShutdownClientProcess döndürerek) başlatıcı da dahil olmak üzere tüm işlemler sonlandırılmalıdır. Böylece Google Play Games, oyunu otomatik olarak kurtarmayı ve yeniden başlatmayı deneyebilir. Daha fazla bilgi için kurulum kılavuzundaki 5. adıma bakın.

3. Oyunum ve başlatıcım üretim aşamasına geçtikten sonra güncellemeleri ve bakımı nasıl yapabilirim?

   Sonraki güncellemeler ve bakım işlemleri başlatıcınız üzerinden yapılmalıdır. Google Play Games istemcisi güncelleme işlevlerini desteklemediğinden başlatıcının hem oyunu hem de başlatıcının kendisini güncelleyebilmesi gerekir.

4. Yükleyici, otomatik oyun için GPG oturum jetonunu nasıl alır?

   GPG, oturum jetonunu --g_session_token=<token> komut satırı bağımsız değişkenini kullanarak yükleyiciye iletir. Bunu etkinleştirmek için play_publishing_config.xml dosyanızda acceptsCommandLineArguments="true" değerini ayarlamanız gerekir.

   Yükleyici, bu jetonu ayıklamak ve oyunu başlatmak için kullanmaktan sorumludur. Jeton oluşturma başarısız olursa GPG, yükleyiciyi jeton olmadan başlatır (yedek).

Başlatma

1. Google Play Games uygulamasını kullanarak bir oyun başlattığımda Google Hesabı bilgilerim senkronize edilir mi?

   Oyun, Google Play Games istemcisi üzerinden başlatıldıktan sonra hesap otomatik olarak senkronize edilir ve Google Giriş işlemiyle tekrar giriş yapılması gerekmez.

2. Başlatma parametrelerini birden çok kez kullanmak mümkün mü?

   Google Play Games istemcisi çalıştığı ve giriş bilgileri geçerli olduğu sürece bu mümkündür. Ancak kılavuzda açıklanan senaryolarda, kullanıcı oyunu kapattığında veya oyun, SDK başlatma hatası (ör. kActionRequiredShutdownClientProcess) nedeniyle kapandığında oyun tarafından başlatılan tüm işlemler sonlandırılmalıdır.

3. Oyunu doğrudan açmak için kısayol oluşturmanın bir yolu var mı?

   Oyunu doğrudan açmak için aşağıdaki URI'yi kullanabilirsiniz:

   googleplaygames://launch/?pid=2&id=com.company.gamename

   URI, PC Üzerinde Google Play Games istemcisinin açılıp açılmadığını algılamayı destekler. İstemci açık değilse oyun veya başlatıcı çalıştırılmadan önce Google Play Games istemcisi açılır. Birden fazla örneğin çalışmasını önlemek için oyunu veya başlatıcıyı yönetmeniz gerekir.

4. PC Üzerinde Google Play Games'in yüklenip yüklenmediğini SDK kullanmadan doğrulamanın bir yolu var mı?

   PC Üzerinde Google Play Games'in yükleme durumunu, SDK'yı entegre etmeden aşağıdaki Windows Kayıt Defteri anahtarının varlığını kontrol ederek doğrulayabilirsiniz:

   HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

   Bu anahtarın varlığı, Google Play Games Hizmetleri'nin (oyunları PC'de çalıştırmak için gereklidir) makinede yüklü olduğunu gösterir. Anahtar yoksa kullanıcıyı PC Üzerinde Google Play Games yükleme sayfasına yönlendirerek istemciyi indirip yüklemesini sağlamanız gerekir.

Test

1. Mobil cihazlara benzer açık test veya kapalı test ortamları var mı?

   Özel bir uçtan uca korumalı alan olmasa da geliştiriciler için üretime benzer bir test ortamına ihtiyaç duyulduğunun farkındayız. Yakında daha sağlam bir çözüm sunulacaktır.

2. Nasıl yeni test kullanıcıları ekleyebilirim?

   Google'daki iletişim kişiniz, her PC projesi için bir e-posta grubu oluşturur. Test kullanıcılarının Google Hesapları bu gruba eklenmelidir. Yalnızca bu e-posta grubunun üyeleri Google Play Games'deki test paketlerini indirme yetkisine sahiptir.

Çeşitli

1. VPN kullanabilir miyim?

   Oyunlarını PC Üzerinde Google Play Games'in desteklenmediği bölgelerde test etmesi gereken geliştiricilerin, desteklenen bir bölgeden IP adresi almak için VPN kullanmasını öneririz.

   VPN'de TUN modunu etkinleştirdiğinizden emin olun. TUN modunu etkinleştirme ve güvenlik duvarını yapılandırma ile ilgili talimatları VPN sağlayıcının kullanım kılavuzunda bulabilirsiniz.

   TUN modu etkinleştirildikten sonra test amacıyla PC Üzerinde Google Play Games'i ve emülatörü yükleyin.

2. Unity veya UE Editor'da PC Üzerinde Google Play Games için geliştirmeye nasıl başlayabilirim?

   • Geliştirici modunu etkinleştirin ve test işlemine devam edin.
   • manifest.xml ve .dll dosyalarını ekleyin. Daha fazla bilgi için geliştirici belgesine bakın.
   • Test amacıyla erken erişim iş ortağı GUID'si kaydedin.

3. Kayıt defteri anahtarlarını nasıl doğru şekilde kullanabilirim?

   Kök kovanı temel alan kayıt defteri anahtarları oluşturmanız gerekir. Amacınıza ve verilerin yapısına bağlı olarak kök kovanı HKEY_LOCAL_MACHINE veya HKEY_CURRENT_USER olarak ayarlayabilirsiniz. Yönergelerde örnek olarak HKEY_LOCAL_MACHINE kovanı kullanılmıştır.

4. Google'ın PC paketlerini incelemesi için gereken şartlar nelerdir?

   PC paketleri kötü amaçlı yazılım taramasından geçirilir. Ardından inceleme uzmanları yalnızca oyunun yüklenmesi, başarıyla başlatılması ve kaldırılması işlemlerini test eder.

5. Tüm API'leri entegre etmek gerekli mi?

   Diğer API'ler zorunlu olmasa da ek avantajlar sunar. Uygulama içi satın alma işlemleri ve dijital içerik satışı için google::play::billing gereklidir. google::play::install_referrer, yönlendirme verilerini izleyerek uygulamanızı indiren kullanıcıların en çok hangi trafik kaynaklarından geldiğini anlamanıza yardımcı olmak için gereklidir. google::play::games::integrity ise potansiyel olarak riskli cihazları ve bilinmeyen emülatörleri tespit ederek uygulamanızı kötü niyetli kişilerden korumak için gereklidir.

6. Google Play Games istemcisi kapatıldığında neden bazı oyun işlemleri sonlandırılırken diğerleri sonlandırılmıyor?

   Google, çalışan oyunun alt süreçlerini veya süreçlerini kontrol etmez. Davranış, oyunun emülasyonlu bir Android oyunu mu yoksa PC oyunu mu olduğuna bağlıdır. Emülasyonlu oyunlar kendi ortamlarına yüklendiğinden davranışları büyük ölçüde emülatörün başlatılmasına ve kapatılmasına bağlıdır.

7. Google Play Games'in kaldırma özelliğini mi yoksa özel bir kaldırıcı mı kullanmalıyım?

   Google, Google Play Games'i kaldırma özelliğimizi kullanmanızı önerir.

Ek destek

Bu SSS'de yer almayan konularda daha fazla yardıma ihtiyacınız olursa lütfen google-play-games-pc@google.com adresinden bize ulaşın.