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. Satın alma sürecini arka uç sunucusu olmadan kullanabilir miyim?

   Güvenlik açısından, arka uç sunucusu olmadan işleme önerilmez.

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

2. 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.

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

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

4. Yinelenen ödemeler veya abonelikler destekleniyor mu?

   Bu özellik yakın gelecekte kullanıma sunulmayacak ancak gelecekteki yol haritamıza eklememiz için belirli kullanım alanları önerebilirsiniz.

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

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

6. İstemci tarafı satın alma doğrulamasını 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.

7. Ü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.

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

   İşlev, QueryPurchasesContinuation imzasını içeren 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 durumuna sahip olan BillingError enum'unu (includes/billing/enums.h) döndürür.

9. Faturalandırma istemcisinde satın alma akışını 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 TL'ye 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.

10. Kullanıcı, satın alma süreci sırasında ödeme yapmadan tarayıcıyı kapatırsa zaman aşımı hatası amaçlanmış mıdır?

    Evet, bu bilinen bir sorundur ve tarayıcı tabanlı akışta amaçlanan davranıştır. Ödeme akışını oyun içinde tutacak ve bu zaman aşımı sorununu çözecek sorunsuz bir satın alma özelliği (WebView tabanlı) üzerinde aktif olarak çalışıyoruz.

11. OAuth ile Google faturalandırmadan DLL ile yerel Google faturalandırmaya geçiş yapmanın ön koşulları nelerdir?

    Oyunlar, oturum açılan hesabı yönetmek için Google ile 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?

    Evet, şu anda tarayıcı üzerinden işleniyor. Google, SDK aracılığıyla oyunun dışına çıkmadan tüm akışı tamamlamayı planlı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. Tarayıcıda bir satın alma akışı başlattığınızda, oyun oturumuyla aynı hesapla oturum açmış ve bu hesabı kullanıyor olmanız gerekir. Kullanıcı farklı bir hesapla oturum açtıysa web akışı, hesaplar arasında geçiş yapmasını ister.

14. Bir oyun aynı anda hem yerel SDK'yı 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ı kullanarak WAB gönderirken oyun paketinin inceleme için gönderilmesi gerekir mi?

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

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

   Bir WAB için 10 GB'a kadar dosya boyutu yükleyebilirsiniz.

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 işletmelerin 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 bunu manuel olarak yayınlayamazsınız. Google arka uç personeline tam UTC saati (saat bazında) vermeniz gerekir. Google daha sonra yayın takvimini yapılandırır ve zamanında yayınlanmasını sağlar.

PC SDK

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

   • Eski API'miz 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 gerekmez.

2. SDK'yı, PC Üzerinde Google Play Games'i kullanmadan doğrudan oyun başlatıcıyı kullanarak oyunu başlatarak 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. Yerel 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ı'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şkilendirilmiş bir hesap olabilir. Bunlar farklı olabilir. Bu nedenle, oyunu A hesabı ile başlatıp B hesabına geçerseniz ve oyunu yeniden başlatırsanız 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 üstü) Play Install Referrer API'yi destekler. Daha fazla bilgi için Play Install Referrer API'si 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 bir 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 işlemine 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.

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 giriş yapılması gerekmez.

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

   Google Play Games istemcisi çalışır durumda olduğu ve giriş bilgileri geçerli olduğu sürece bu işlem yapılabilir. 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 Üzerinde 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önlendirmelisiniz.

Test

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

   Uçtan uca özel bir 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. Test kullanıcılarının Google Hesapları bu gruba eklenmelidir. Google Play Games'deki test paketlerini yalnızca bu e-posta grubunun üyeleri indirebilir.

Ç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 uygulama 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 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 niteliğine bağlı olarak kök bölümü HKEY_LOCAL_MACHINE veya HKEY_CURRENT_USER olarak ayarlayabilirsiniz. HKEY_LOCAL_MACHINE grubu, 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 değildir ancak 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ı indiren kullanıcıların çoğunu gönderdiğini anlamanıza yardımcı olmak için yönlendirme verilerinin izlenmesi açısından gereklidir. google::play::games::integrity, kötü niyetli kişilerden korunmak için gereklidir. Bu amaçla, riskli olabilecek cihazlar ve bilinmeyen emülatörler tespit edilir.

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 Android'de emüle edilen bir oyun mu yoksa yerel bir 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.