Migrazione da API a SDK

Se i tuoi 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 C++ SDK o C# SDK. Fai riferimento ai progetti di esempio che mostrano esempi che possono essere utilizzati per eseguire la migrazione del tuo gioco nativo all'SDK.

Configurazione e preparazione

Questa sezione descrive 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 prevede 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, devi rimuovere tutte le chiamate API dirette ai server di Play. Nell'SDK sono presenti chiamate di funzione corrispondenti per ottenere la stessa funzionalità. Questa sezione elenca il mapping per ciascuna funzionalità.

Accedi con Google

Accedi con Google, noto anche come Accedi con Google, è un metodo di autenticazione OAuth che offre 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 Google Play Giochi già associato al profilo giocatore e ai diritti del giocatore. Ciò offre un'esperienza più fluida per i giocatori e un ambiente più sicuro per gli sviluppatori, perché l'SDK può comunicare in modo sicuro con il client Google Play Giochi tramite IPC.

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

Ottieni l'elenco dei prodotti

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

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

Ricevi acquisti

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

Nell'SDK, utilizza la funzione QueryPurchases 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 la procedura chiamando la funzione LaunchPurchaseFlow di BillingClient. L'SDK gestisce tutto il lavoro necessario.

Elaborare l'acquisto

L'elaborazione dell'acquisto dell'utente comporta il riconoscimento e il consumo dell'acquisto dopo aver verificato che sia legittimo. Sia la soluzione API che quella SDK consigliano i passaggi da completare 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 l'acquisto in modo sicuro dopo aver concesso il diritto.

Invia per i test

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

Pacchetto per l'invio

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