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 almaktadır.

Para kazanma

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

   Google Play Console'da yeni oluşturulan lisanslama anahtarları, Google Play'in dahili önbellekleri tüm yayınlama ortamlarında senkronize edilmeden önce ticaret arka ucunda birkaç saatlik önbelleğe alma ve yayma 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. Satın alma işlemlerini test etmeden önce lisanslama anahtarınızı yükledikten veya güncelledikten sonra birkaç saat bekleyin.

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

   Google, güvenlik açısından bir 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. Mevcut API tabanlı ödeme yönteminizi aynı oyunda kullanamazsınız.

4. Geliştirici modunda satın alma işlemlerini nasıl kullanabiliriz?

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

5. Yinelenen ödemeler veya abonelikler destekleniyor mu?

   Şu an için bu mümkün olmasa da gelecekteki yol haritamıza eklememiz için belirli kullanım alanları önerebilirsiniz.

6. Satın alma çağrılarımda faturalandırma hatası nedir?

   BillingError, ödeme sonucunun yanıtıdır. LaunchPurchaseFlow işlevi, engelleme yapmadan hemen geri döner ancak işlemin ne zaman tamamlandığını öğ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. Müşteri uygulamanızdaki satın alma işlemlerinin işlenmesi için oyununuzun izin verilenler listesinde olması gerekir. Oyununuzun erişim gerektirmesi durumunda 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'ye tek bir çağrıda sorgulanabilecek maksimum ürün sayısı 50'dir. Bu sınırı aşarsanız isteği birden fazla aramaya bölmeniz gerekir.

9. Faturalandırma istemcisinde Query Purchases veya Launch Purchase Flow çağrılırken hangi parametreler gereklidir?

   İşlev, QueryPurchasesContinuation imzalı bir işlev geri çağırması olan std::function<void(QueryPurchasesResult)> değerini kabul eder. Geri çağırma, sonucu tüm ProductPurchaseDetails ile birlikte size iletir. Bu bilgiler, includes/billing/models.h dosyasındaki SDK başlık 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, kullanıcı iptali veya ağ hatası gibi 10 olası hata durumu olan BillingError enum'unu (includes/billing/enums.h) döndürür.

10. Faturalandırma istemcisinde satın alma sürecini başlatmak 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 öğelerinin 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'nun tam olarak bir teklifi vardır (örneğin, bir öğeyi 10 ABD dolarına satın alma). Gelecekte Play faturalandırma ekibi, birden fazla teklif için destek sağlayacaktır.

    Satın alma sürecinde kesintiler olması durumunda meta verilerin ilişkilendirilmesini sağlamak için satın alma iletişim kutusunu başlatmadan önce meta verileri arka uç sunucunuzda saklayın ve bunları 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.

11. 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'lerinin kullanımını durdurmanızı önerir. REST faturalandırma API'lerinden (OAuth2 ile oturum açma) SDK akışına geçiş, özellik işaretli bir işlem olabilir. Bu nedenle, oyun geçiş yaparken her ikisi de bir süre birlikte var olabilir.

12. Launch Purchase Flow API çağrısı bir web tarayıcısı üzerinden mi işleniyor?

    Hayır. Satın alma süreci artık oyun istemcisinden ayrılmadan, sorunsuz bir WebView yerleşimi kullanılarak tamamen oyun içinde tamamlanıyor.

13. Kullanıcını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ürecinde bu hesap otomatik olarak kullanılır.

14. Bir oyun aynı anda hem PC SDK'sını hem de eski ödeme sistemlerini destekleyebilir mi?

    Ödeme sistemi, oyun ikili sürümüne bağlı olarak çift akışlı bir modelle çalışır. Eski sürümlerdeki kullanıcılar mevcut akışı kullanmaya devam ederken yeni sürümlerdeki kullanıcılar SDK tabanlı ödemelere geçer. Geçiş dönemi boyunca her iki ödeme akışındaki kullanıcılar birlikte bulunur.

Windows Uygulama Paketi Grubu

1. Üçüncü taraf başlatıcı kullanılarak WAB gönderildiğinde inceleme için oyun paketi gerekli mi?

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

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

   Yükleyici Yayınlama için bir WAB'nin dosya boyutu en fazla 10 GB olabilir. Play Yönetilen Yayıncılık'ta 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?

   Oyununuz önceden mevcut bir PC sürümü olmadan kullanıma sunuluyorsa ("ilk kez WAB"), sistem oyunu otomatik olarak yönetilen yayınlama bekleme durumuna yerleştirebilir. Bunun nedeni, güncellenecek mevcut bir temel çizginin olmamasıdır. WAB'yi tamamen yayınlamak ve oyunu yüklenebilir hale getirmek için Google Play Console'a gidip gerekli yayınlama işlemini manuel olarak gerçekleştirmeniz gerekir (örneğin, "Değişiklikleri yayınla"yı tıklayın).

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

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

5. WAB paketi nereye yüklenmelidir?

   WAB paketini ilk soruda belirtilen konuma yükleyebilirsiniz. Ancak bunu manuel olarak yayınlayamazsınız. Google arka uç personeline tam bir UTC saati (saat bazında) 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

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

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

2. Oyunu PC Üzerinde Google Play Games'i kullanmadan doğrudan oyun başlatıcıyı kullanarak başlatarak SDK'yı başlatmanı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 dokümanına bakın.

3. PC SDK, 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ı'nda oturum açma işlemini nasıl ele alır?

   Google Play Games'deki her oyun başlatma işlemi "oyun oturumu" olarak kabul edilir ve her "oyun oturumu" ile ilişkili bir hesap olabilir. Farklı olabilirler. Bu nedenle, oyunu A hesabı ile başlatıp B hesabına geçerseniz her ikisi de 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 başlıklı makaleyi inceleyin.

Başlatıcı

1. Bir oyuncu Google Play istemcisi yerine üçüncü taraf başlatıcı kullanıyorsa Play Games Hizmetleri hesabı otomatik olarak senkronize edilir mi?

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

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

   SDK'yı doğrudan başlatıcınıza entegre etmeniz gerekmez. Ancak başlatıcı tarafından Google Play Games istemcisinden alınan 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 işlemi başarısız olursa (örneğin, kActionRequiredShutdownClientProcess döndürülerek), 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. Üretim aşamasındaki oyunumda ve başlatıcımda 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ı hem oyunu hem de kendisini güncelleyebilmelidir.

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

   GPG, oturum jetonunu yükleyiciye --g_session_token=<token> komut satırı bağımsız değişkenini kullanarak iletir. Bunu etkinleştirmek için play_publishing_config.xml bölümünde acceptsCommandLineArguments="true" ayarını yapmanız gerekir.

   Bu jetonu ayıklamak ve oyunu başlatmak için kullanmak yükleyicinin sorumluluğundadır. Jeton oluşturma işlemi başarısız olursa GPG, yükleyiciyi jeton olmadan (yedek) başlatır.

Başlatma

1. Google Play Games uygulamasını kullanarak bir oyuna başladığımda Google Hesabı ayrıntılarım senkronize edilir mi?

   Oyun, Google Play Games istemcisi üzerinden başlatıldıktan sonra hesap otomatik olarak senkronize edilir ve Google oturum açma işlemiyle tekrar oturum açmanız gerekmez.

2. Başlatma parametrelerini birden fazla kez yeniden kullanmak mümkün mü?

   Google Play Games istemcisi çalışıyor ve giriş bilgileri geçerli olduğu sürece bu mümkündür. Ancak kılavuzda açıklanan senaryolarda olduğu gibi, kullanıcı oyunu kapattığında veya oyun, kActionRequiredShutdownClientProcess gibi bir SDK başlatma hatası nedeniyle çıktığı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. SDK'yı kullanmadan PC Üzerinde Google Play Games yüklemesini doğrulamanın bir yolu var mı?

   Aşağıdaki Windows kayıt defteri anahtarının varlığını kontrol ederek SDK'yı entegre etmeden PC'de Google Play Games'in yükleme durumunu doğrulayabilirsiniz:

   HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games Services

   Bu anahtarın varlığı, Google Play Games hizmetlerinin (oyunların PC'de çalıştırılması için gereklidir) makineye yüklendiğini gösterir. Anahtar eksikse kullanıcıyı istemciyi indirip yüklemesi için PC Üzerinde Google Play Games yükleme sayfasına yönlendirmeniz gerekir.

Test

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

   Özel bir uçtan uca sanal alan olmasa da geliştiricilerin üretime benzer bir test ortamına ihtiyacı olduğunun farkındayız. Yakında daha sağlam bir çözüm sunulacak.

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. Bu gruba test kullanıcılarının Google Hesapları 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 yönergeleri 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 nasıl geliştirme yapmaya başlayabilirim?

   • Geliştirici Modu'nu etkinleştirin ve test işlemine devam edin.
   • manifest.xml ve .dll dosyalarını ekleyin. Daha fazla bilgi için geliştirici dokümanına 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 bölümüne göre kayıt defteri anahtarları oluşturmalısınız. Amacınıza ve verilerin yapısına bağlı olarak kök bölümü HKEY_LOCAL_MACHINE veya HKEY_CURRENT_USER olarak ayarlayabilirsiniz. HKEY_LOCAL_MACHINE Hive, kurallarda örnek olarak kullanılmıştır.

4. Google'ın PC paketlerini incelemesi için gerekenler nelerdir?

   PC paketleri kötü amaçlı yazılım taramasından geçirilir. Ardından, inceleme uzmanları yalnızca oyun yükleme, başarılı başlatma ve kaldırma işlemlerini test eder.

5. Tüm API'lerin entegre edilmesi 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, hangi trafik kaynaklarının uygulamanızı indirmesi için en çok kullanıcı gönderdiğini anlamanıza yardımcı olmak üzere yönlendirme verilerini izlemek için gereklidir. google::play::games::integrity, kötü niyetli kişilerden uygulamanızı korumak için gereklidir. Bu amaçla, riskli olabilecek cihazları ve bilinmeyen emülatörleri tespit eder.

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

   Google, çalışan oyunun alt süreçlerini veya süreçlerini kontrol etmez. Davranış, oyunun emüle edilmiş bir Android oyunu mu yoksa PC oyunu mu olduğuna bağlıdır. Emülasyonu yapılan oyunlar kendi ortamlarına yüklenir. Bu nedenle, 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ırma programını mı kullanmalıyım?

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

Ek yardım

Bu SSS'de yanıtlanmayan başka sorularınız varsa lütfen google-play-games-pc@google.com adresinden bize ulaşın.