Oyununuzu PC Üzerinde Google Play Games'de incelenmek üzere göndermeden önce tüm şartları ve en iyi uygulamaları karşıladığından emin olmak için bu yapılacaklar listesini kullanın.
Projenizi oluşturma ve yapılandırma
- SDK'yı indirip içe aktarın: Ortamınız için en yeni Google Play Games PC SDK'sını entegre edin. Daha fazla bilgi için Unity kılavuzuna veya C++ kılavuzuna bakın.
- Uygulama manifesti oluşturun:
<PackageName>öğesini hak talebinde bulunduğunuz Google Play Console paketiyle eşleyen birmanifest.xmldosyası oluşturun. Daha fazla bilgi için Manifest kılavuzuna bakın. - Yürütülebilir dosyanızı dijital olarak imzalayın: Oyununuzu Authenticode dijital imzası kullanarak imzalayın ve sertifikayı gelecekteki tüm güncellemeler için koruyun. Geliştirici modunu etkinleştirerek yerel geliştirme sırasında bu adımı atlayabilirsiniz. Ancak nihai ikili programınızı, bilinen bir sertifika yetkilisinden alınmış gerçek bir üretim sertifikasıyla imzalamanız gerekir. Daha fazla bilgi için Oyununuzu dijital olarak imzalama başlıklı makaleyi inceleyin.
- Sertifikayı biçimlendirme ve gönderme: Sertifika bilgilerini Google temsilcinize gönderin. Sertifika dosyası yalnızca sertifikayla ilgili bilgileri içermelidir. Sertifika dışındaki tüm blokların kaldırıldığını doğrulayın. DER/CER dosyalarını gerekli PEM biçimine dönüştürmek için OpenSSL'yi kullanabilirsiniz.
API'leri ve özellikleri entegre etme
- SDK'yı başlatma: Diğer özellikleri kullanmadan önce başlangıç sırasında SDK başlatma mantığını (ör.
InitializeAsync) uygulayın. Daha fazla bilgi için Başlatma kılavuzuna bakın. - Sorunsuz oturum açma özelliğini uygulayın: Recall API aracılığıyla Google Play Games istemci hesabını kullanarak oyuncuların kimliğini otomatik olarak doğrulayın. Daha fazla bilgi için Sorunsuz Oturum Açma kılavuzunu inceleyin.
- Play Integrity'yi entegre edin: Jeton istemek ve arka ucunuzdaki oyun oturumlarının meşruiyetini doğrulamak için
IntegrityClientkullanın. Daha fazla bilgi için Play Integrity kılavuzuna bakın. - Google Play Install Referrer API'yi ekleme: PC için kullanıcı edinme kaynaklarını izlemeniz gerekiyorsa Install Referrer API'yi entegre edin. Daha fazla bilgi için Install Referrer kılavuzuna bakın.
- Başlatma hatalarını işleme: SDK'yı kullanmak için API'yi başlatmak üzere
GooglePlayInitialize(C++) veyaGooglePlayInitialization.InitializeAsync(C#) yöntemini çağırın. Başka bir API kullanmadan önce bunu çağırmanız ve devam geri çağırma işlevininInitializeResult::ok()(C++) ile tamamlandığını veyaResult.IsOk(C#) işlevinintruedöndürdüğünü doğrulamanız gerekir. - Zorunlu kapatma işlemini gerçekleştirme: İstemci işlemini en kısa sürede kapatarak
kActionRequiredShutdownClientProcessişlemini gerçekleştirin. - Google Play Games yükleme şartlarını karşılama: Kullanıcılara devam etmek için Google Play Games ve SDK Çalışma Zamanı'nın yüklenmesi gerektiğini bildirerek
kSdkRuntimeUnavailablehatasını giderin. - Google Play Games güncellemelerini işleme: Kullanıcılara Google Play Games çalışma zamanı güncellemesi gerektiğini bildirerek
kSdkRuntimeUpdateRequiredhatasını işleyin.
Google Play Faturalandırma'yı uygulama
- Satın alma türlerini kontrol edin: Yinelenen ödemeler ve abonelikler desteklenmediğinden oyununuzun yalnızca uygulama içi satın alma işlemlerini kullandığından emin olun. Daha fazla bilgi için Faturalandırmayla ilgili SSS başlıklı makaleyi inceleyin.
- Ürün ayrıntılarını sorgulama: Yerelleştirilmiş mağaza verilerini almak için
QueryProductDetailskullanın. 50'den fazla ürününüz varsa isteği birden fazla çağrıya bölün. Daha fazla bilgi için Ürünleri sorgulama kılavuzunu inceleyin. - Satın alma sürecini başlatma: İşlemleri yerel olarak işlemek için
LaunchPurchaseFlowkullanın. Ödeme yapmadan ödeme tarayıcısını kapatırsanız beş dakikalık bir zaman aşımı hatası oluşur. Daha fazla bilgi için Satın alma süreci kılavuzunu inceleyin. - Mevcut satın alma işlemlerini geri yükleme: Onaylanmamış cihazlar arası satın alma işlemlerini yakalamak için başlangıçta ve ön plana alma sırasında
QueryPurchasesyöntemini çağırın. Daha fazla bilgi için Satın alma işlemlerini geri yükleme kılavuzunu inceleyin. - Güvenli arka uç işleme: Yararlanma hakkı vermeden ve
AcknowledgePurchaseveyaConsumePurchaseile sonlandırmadan önce arka ucunuzdapurchaseTokendeğerini doğrulayın. Daha fazla bilgi için Güvenli işleme kılavuzunu inceleyin. - Lisanslama anahtarı yayılma gecikmesini hesaba katın: Play Console'da yeni faturalandırma veya lisanslama anahtarları yapılandırırken canlı satın alma testleri yapmadan önce arka uç önbelleğinin ticari sunum ortamlarında senkronize olması için birkaç saat bekleyin. Senkronizasyon tamamlanmadan önce yapılan satın alma denemeleri 6 numaralı hata kodunu döndürür.
Geliştirici modunda test etme ve lansman öncesi kalite güvencesi gerçekleştirme
- Geliştirici modunda test etme: Manifest dosyanıza
<IsDeveloperMode>true</IsDeveloperMode>ekleyin ve yerel entegre geliştirme ortamı (IDE) testi için erken erişim iş ortağı GUID'nizi yapılandırın. Erken erişim iş ortağı GUID'niz yoksa talep formunu doldurun. - Geliştirici modu satın alma işlemlerini yönetme: Geliştirici modunda satın alma işlemlerini test ederken otomatik geri ödemeleri önlemek için satın alma işlemini üç dakika içinde kullanın. Daha fazla bilgi için Test SSS bölümüne bakın.
- Geliştirici modunu kaldırma: Yayınlanan derlemenizi paketlemeden önce
<IsDeveloperMode>etiketini en kısa sürede kaldırmanız gerekir. Daha fazla bilgi için Geliştirici modu kılavuzuna bakın. - Üçüncü taraf başlatıcıları kullanarak bağımsız değişkenleri yönlendirme: Başlatıcının Google Play Games istemcisinden aldığı tüm bilinmeyen komut satırı bağımsız değişkenlerini doğrudan oluşturulan oyun işlemine iletin. Daha fazla bilgi için Çoklu işlem kılavuzunu inceleyin.
- VPN ile test etme: Desteklenmeyen bir bölgeden test yapıyorsanız desteklenen bir IP adresi almak için TUN modu etkinleştirilmiş bir VPN kullanın. Daha fazla bilgi için VPN testiyle ilgili SSS bölümüne bakın.
- Masaüstü kısayollarını destekleme: Sorunsuz kısayol desteği için kısayol yürütme ile ilgili Kısayol SSS bölümüne bakın. Oyunu veya üçüncü taraf başlatıcıyı doğrudan bir kısayol kullanarak başlatmak, başlatma hatalarına neden olabilir.
Oyununuzu paketleme, test etme ve yayınlama
- WAB'yi paketleme: Play Publishing Tool'u kullanarak oyununuzu Windows Uygulama Paketi Grubu (WAB) olarak paketleyin. WAB dosyası, Yükleyici Yayınlama için 10 GB, Google Play Yönetilen Yayınlama için 200 GB dosya boyutu sınırının altında olmalıdır. Daha fazla bilgi için Paketleme kılavuzuna bakın.
- En yeni SDK'ları ve araçları kullanın: Sürümünüzü Google Play Games PC SDK'sı, Google Play Games PC Unity SDK'sı, Google Play PC geliştirici aracı ve Google Play yayınlama aracının en yeni sürümleriyle derleyip paketleyin.
- Yükseltme gerekip gerekmediğini onaylayın: Yükleyicinizin, başlatıcınızın veya kaldırıcı uygulamanızın her başlatıldığında yönetici olarak çalıştırılması gerekiyorsa
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONveyaUNINSTALLER_REQUIRES_ELEVATIONdeğerinitrueolarak ayarlayıp ayarlamadığınızı kontrol etmeyi unutmayın. Aksi takdirde, yönetici ayrıcalıklarıyla çalışmazlar ve bu da başlatma hatasına neden olur. Daha fazla bilgi için WAB Yapılandırma Dosyası Biçimi bölümüne bakın. - Üçüncü taraf başlatıcı yükleyicileri gönderme: Üçüncü taraf başlatıcı kullanıyorsanız yükleyicisini WAB içinde gönderin. Daha fazla bilgi için Yükleyici yayınlama kılavuzu'nu inceleyin.
- Otomatik oynatma oturum jetonunu işleme:
play_publishing_config.xmliçindeacceptsCommandLineArguments="true"ayarını yaparak otomatik oynatmayı etkinleştirirseniz yükleyicinizin--g_session_token=<token>komut satırı bağımsız değişkenini çıkardığını ve oyunu başlatmak için kullandığını doğrulayın. Yükleyicinizin, jetonun mevcut olmadığı yedek durumu işlediğinden emin olun. Daha fazla bilgi için Başlatıcı ile ilgili SSS bölümüne bakın. - Oyunu ve başlatıcıyı veya yükleyiciyi güncelleyin: Başlatıcı yükleyiciler de dahil olmak üzere paket içeriğiniz kendi kendine güncellenebilir olmalıdır. Başlatıcının kendisini güncellemek de dahil olmak üzere oyununuzun ihtiyaç duyduğu tüm kaynakları yönetin.
- Lansman bilgilerini Google ile paylaşın: Play iş ortağınızla iletişime geçerek paket adınızı, lansman ülkelerini (ISO 2 karakterli kodları kullanarak, örneğin US, CA, MX) ve lansman tarihini ve saatini Eşgüdümlü Evrensel Saat (UTC) olarak paylaşın.
- Test erişimini ayarlama: Test, dokümanlar ve Google Drive erişimi için izin verilenler listesine eklenecek harici bir Google Grubu sağlayın. Play Console test kanalları PC'de desteklenmediğinden test hesaplarının e-posta listesini Google Play iş ortağınızla paylaşın.
- PC form faktörünü ekleyin: Google Play Console'da uygulamanıza "PC Üzerinde Google Play Games" form faktörünü açıkça ekleyin. Bu sekmeye erişemiyorsanız hesabınızı izin verilenler listesine eklemesi için Google Play iş ortağınızla iletişime geçin.
- PC gereksinimlerini yapılandırın: Windows PC'ler için donanım gereksinimlerini (RAM, GPU, depolama alanı) girin. Daha fazla bilgi için PC gereksinimleri kılavuzuna bakın.
- Mağaza öğelerini yükleme: Paketlenmiş WAB dosyanızı Üretim kanalına yükleyin ve görsel öğeleri yapılandırın. Daha fazla bilgi için Öğe yükleme kılavuzu'nu inceleyin.
- Kullanıcı ortamı testi için yayınlama: Google Play Console'da Yayınla'yı seçin. Android sürümünden farklı olarak, WAB'de Yayınla'yı seçtiğinizde herkese açık bir sürüm tetiklenmez. Bunun yerine, Google'ın inceleme sürecinden sonra kullanıcı ortamında testler yapmak için uygulamanın, paylaşılan test hesaplarınız tarafından aranabilir olmasını sağlar.
- Resmi lansman: Google, lansmanı Play iş ortağınızla paylaştığınız resmi lansman tarihine göre kontrol eder.
- Ön kayıt sırasında test etme: Ön kayıt aşamasında, seçtiğiniz ön kayıt bölgelerine dahil olmayan bir ülkede dahili test yapmanız gerekir.
- Yükleyici işleminin sonlandırılmasını doğrulama: Gerekli tüm kayıt defteri anahtarları oluşturulup kaydedilene kadar birincil yükleyici işleminin etkin kaldığını doğrulayın. İşlem erken sonlandırılırsa yükleme doğrulaması başarısız olur. Daha fazla bilgi için Yükleyici yayınlama başlıklı makaleyi inceleyin.
- Tutarlı kayıt defteri kovanları kullanın ve kaldırma işleminde temizlik yapın:
PC Üzerinde Google Play Games,
HKEY_CURRENT_USERöncesindeHKEY_LOCAL_MACHINEdeğerini kontrol eder ve ilk eşleşen değeri kullanır. Kayıt defteri kovanını güncellemeler ve paylaşılan başlatıcı başlıkları arasında tutarlı tutun ve kaldırma işlemi sırasında kayıt defteri anahtarlarını kaldırın. Böylece eskiHKEY_LOCAL_MACHINEgirişleri geçerliHKEY_CURRENT_USERyollarını gölgelemez. Daha fazla bilgi için Yükleyici yayınlama başlıklı makaleyi inceleyin.
API'den SDK'ya geçiş
API'den SDK'ya geçiş isteğe bağlı bir adımdır. Geçiş yapmayı seçerseniz aşağıdaki önerileri uygulayın:
- Eski REST API'leri kaldırın: Eski Google Play Developer API çağrılarını (ör.
purchases.products.get) istemci tarafı yerel SDK işlevleriyle eşleyin. Daha fazla bilgi için Geçiş rehberini inceleyin. - Komut satırı bağımsız değişkenlerini doğrulayın: SDK ortamındaki komut satırı bağımsız değişkenleri, API ortamındakilerden farklı olabilir. Paketinizin tüm bağımsız değişkenleri doğru şekilde işlediğini ve ilettiğini doğrulayın. Daha fazla bilgi için Doğrulama bölümüne bakın.
- Kayıt defteri yolunu doğrulayın: Yerel SDK'ya sorunsuz bir geçiş için kayıt defteri yapılandırması önceki sürümlerle tutarlı olmalıdır. Daha fazla bilgi için WAB dosyası kılavuzuna bakın.