API'den SDK'ya geçiş

PC Üzerinde Google Play Games'deki yerel oyunlarınız doğrudan Play Faturalandırma API'lerini çağırıyorsa oyununuzu PC SDK'sını kullanacak şekilde taşımanız gerekir.

Kullandığınız oyun motoruna bağlı olarak C++ SDK veya C# SDK simgesini entegre edebilirsiniz. Yerel oyununuzu SDK'ya taşımak için kullanılabilecek örnekleri gösteren örnek projelere bakın.

Kurulum ve hazırlık

Bu bölümde, API tabanlı bir çözümden PC Üzerinde Google Play Games Native SDK'ya geçiş adımları açıklanmaktadır.

Komut satırı bağımsız değişkenleri

PC Üzerinde Google Play Games Native SDK, kullanıcıların kimliğini doğrulamak için oyun sürecinizin başlatılması sırasında iletilen bazı komut satırı bağımsız değişkenlerini kullanır. Bu bağımsız değişkenlerin, Initialize SDK'yı çağıran işleme iletilmesi gerekir. Oyununuzun başlatılması birden fazla işlem içeriyorsa tüm bağımsız değişkenlerin, SDK'yı nihai olarak kullanan işleme iletildiğini doğrulamanız gerekir. Kurulumun Birden fazla oyun sürecini destekleme adımını inceleyin.

API eşleme

Taşıma işlemini tamamlamak için Play sunucularına yapılan tüm doğrudan API çağrılarını kaldırmanız gerekir. Aynı işlevselliği elde etmek için SDK'da ilgili işlev çağrıları vardır. Bu bölümde, her işlevin eşlemesi listelenmektedir.

Google ile Oturum Açma

Google ile oturum açma olarak da bilinen Google ile oturum açma, Google Hesaplarını kullanarak tek tıklamayla kimlik doğrulama seçeneği sunan bir OAuth kimlik doğrulama yöntemidir. API tabanlı projelerde, oyuncunun hesabını satın alma işlemleriyle ilişkilendirirsiniz. SDK tabanlı çözümlerde bu ilişkilendirme gerekmez.

SDK tabanlı çözümler, Google Play Games istemcisinin, oyuncunun Oyuncu Profili ve haklarıyla zaten ilişkilendirilmiş olan Google Hesabı'nı kullanır. Bu, oyuncular için daha sorunsuz bir deneyim ve geliştiriciler için daha güvenli bir ortam sağlar. Bunun nedeni, SDK'nın IPC aracılığıyla Google Play Games istemcisiyle güvenli bir şekilde iletişim kurabilmesidir.

Google ile oturum açma yerine, Initialize SDK'yı mümkün olduğunca erken çağırın. Oyununuzun çalışma zamanı için güvenli bir ortam sağlamak üzere hata koduna göre hareket edin.

Ürün listesini alma

API çözümünde, arka uç sunucunuz Play Geliştirici API'si inappproduct.gets uç noktasını kullanarak ürün listesini alır.

SDK'da, QueryProductDetails işlevini kullanarak uygulama içi ürün listesini doğrudan istemciden alın.

Satın alma hedefi

API çözümünde, arka uç sunucunuz Play Developer API purchases.products.get uç noktasını kullanarak kullanıcı satın alımlarını alır.

SDK'da QueryPurchases işlevini doğrudan oyun istemcinizden kullanın.

Satın alma sürecini başlatma

API çözümünde, satın alma akışının başlatılması için kurulumla ilgili birden fazla uç nokta çağrılması ve gerekli jetonların alınması gerekir.

SDK'da, BillingClient'nın LaunchPurchaseFlow işlevini çağırarak işlemi başlatın. SDK, gerekli tüm işlemleri gerçekleştirir.

Satın alma işlemini gerçekleştirme

Kullanıcının satın alma işlemini işleme, satın alma işleminin meşru olduğunu başarıyla doğruladıktan sonra satın alma işlemini onaylamayı ve kullanmayı içerir. Hem API çözümü hem de SDK çözümü, güvenlik amacıyla arka uçta tamamlanması gereken adımları önerir.

API çözümü ve SDK çözümü için süreç benzerdir:

Satın alma işleminden purchaseToken'ı aldıktan sonra (ör. API çözümünde ProductPurchase.purchaseToken veya SDK çözümünde ProductPurchaseDetails'in purchase_token'ı) doğrulama için arka uçunuza gönderin.

Doğrulandıktan sonra arka uç sisteminiz, yetki verdikten sonra satın alma işlemini güvenli bir şekilde onaylayabilir veya kullanabilir.

Test için gönderme

Oyununuzu teste göndermek için aşağıdaki adımları uygulayın.

Gönderim için paket

SDK'yı kullanan oyunlar, Windows Uygulama Paketi Grubu biçiminde paketlenmeli ve Play Console üzerinden yüklenmelidir. Oyununuzu Windows Uygulama Paketi Grubu'na paketleme hakkında bilgi edinmek için dokümanlara bakın: