Migrazione da API a SDK

Se i giochi nativi di Google Play Giochi su PC chiamano direttamente le API Play Billing, devi eseguire la migrazione del gioco per utilizzare l'SDK per PC.

A seconda del motore di gioco che utilizzi, puoi integrare il C++ SDK o il C# SDK. Fai riferimento ai progetti di esempio che mostrano esempi che possono essere utilizzati per eseguire la migrazione del gioco nativo all'SDK.

Configurazione e preparazione

In questa sezione vengono descritti i passaggi di migrazione da una soluzione basata su API all'SDK nativo di Google Play Giochi su PC.

Argomenti della riga di comando

L'SDK nativo di Google Play Giochi su PC si basa su alcuni argomenti della riga di comando passati durante l'avvio del processo di gioco per autenticare gli utenti. Questi argomenti devono essere passati al processo che chiama Initialize SDK. Se l'avvio del gioco coinvolge più processi, devi verificare che tutti gli argomenti vengano passati al processo che utilizza l'SDK. Consulta il passaggio Supporto di più processi di gioco della configurazione.

Mappatura delle API

Per completare la migrazione, dovrai rimuovere tutte le chiamate API dirette ai server Play. Nell'SDK sono presenti chiamate di funzione corrispondenti per ottenere la stessa funzionalità. In questa sezione è elencata la mappatura per ogni funzionalità.

Accedi con Google

Accedi con Google, noto anche come Accedi con Google, è un metodo di autenticazione OAuth che fornisce un'opzione di autenticazione con un clic per gli utenti con il proprio Account Google. Nei progetti basati su API, associ l'account di un giocatore ai suoi acquisti. Le soluzioni basate su SDK non richiedono questa associazione.

Le soluzioni basate su SDK utilizzano l'Account Google del client di Google Play Giochi già associato al profilo giocatore e ai diritti del giocatore. In questo modo, i giocatori possono usufruire di un'esperienza più fluida e gli sviluppatori di un ambiente più sicuro, perché l'SDK può comunicare in modo sicuro con il client di Google Play Giochi tramite IPC.

Anziché Accedi con Google, chiama Initialize SDK il prima possibile. Agisci in base al codice di errore per fornire un ambiente sicuro per il runtime del gioco.

Recuperare l'elenco dei prodotti

Nella soluzione API, il server di backend recupera l'elenco dei prodotti utilizzando l' API Play Developer inappproduct.gets endpoint.

Nell'SDK, recupera l'elenco dei prodotti in-app direttamente sul client utilizzando la QueryProductDetails funzione.

Recuperare gli acquisti

Nella soluzione API, il server di backend recupera gli acquisti degli utenti utilizzando l'endpoint purchases.products.get dell'API Play Developer.

Nell'SDK, utilizza la QueryPurchases funzione direttamente dal client di gioco.

Avviare il flusso di acquisto

Nella soluzione API, l'avvio del flusso di acquisto richiede la chiamata di più endpoint per la configurazione e l'acquisizione dei token necessari.

Nell'SDK, avvia il processo chiamando la funzione BillingClient's LaunchPurchaseFlow. L'SDK gestisce tutte le operazioni necessarie.

Elaborare l'acquisto

L'elaborazione dell'acquisto dell'utente prevede il riconoscimento e il consumo dell'acquisto dopo aver verificato che sia legittimo. Sia la soluzione API sia la soluzione SDK consigliano di completare i passaggi dal backend per motivi di sicurezza.

La procedura è simile sia per la soluzione API sia per la soluzione SDK:

Dopo aver recuperato il purchaseToken dall'acquisto, ad esempio ProductPurchase.purchaseToken nella soluzione API o ProductPurchaseDetails's purchase_token nella soluzione SDK, invialo al backend per la verifica.

Una volta verificato, il backend può riconoscere o consumare in modo sicuro l'acquisto dopo aver concesso i diritti.

Inviare per i test

Per inviare il gioco per i test, segui questi passaggi.

Creare il pacchetto per l'invio

I giochi che utilizzano l'SDK devono essere pacchettizzati in formato Windows App Bundle e caricati tramite Play Console. Consulta la documentazione per creare il pacchetto del gioco in Windows App Bundle per: