API'den SDK'ya geçiş

PC Üzerinde Google Play Games'deki yerel oyunlarınız doğrudan Play Billing 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 öğesini 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 Google Play Games on PC 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üreciniz başlatılırken 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ına göz atın.

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ı kullanan kullanıcılara 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ümler bu ilişkilendirmeyi gerektirmez.

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

Google ile Giriş yerine Initialize SDK'yı olabildiğince 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 akışını 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 yapar.

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

Kullanıcının satın alma işlemini işleme almak, satın alma işleminin meşru olduğunu başarıyla doğruladıktan sonra işlemi 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.

İşlem, hem API çözümü hem de SDK çözümü için 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 App Bundle biçiminde paketlenmeli ve Play Console üzerinden yüklenmelidir. Oyununuzu Windows App Bundle'a paketleme hakkında bilgi edinmek için dokümanlara bakın: