Questo documento risponde alle domande comuni sugli SDK e sulla pubblicazione per Google Play Giochi su PC.
Monetizzazione
Perché il mio flusso di acquisto non va a buon fine con il codice di errore 6 dopo l'aggiunta di una nuova chiave di fatturazione o codice licenza?
Le chiavi di licenza appena generate in Google Play Console subiscono un ritardo di memorizzazione nella cache e di propagazione di diverse ore nel backend commerciale prima che le cache interne di Google Play si sincronizzino in tutti gli ambienti di pubblicazione. Anche se il client di gioco può eseguire correttamente query sui dettagli del prodotto, le richieste di acquisto non andranno a buon fine con il codice di errore 6 fino al completamento della sincronizzazione. Attendi alcune ore dopo aver caricato o aggiornato il codice licenza prima di testare gli acquisti.
Posso utilizzare il flusso di acquisto senza un server di backend?
Dal punto di vista della sicurezza, Google consiglia di utilizzare un server di backend.
Per saperne di più, consulta Elabora senza un server di backend.
I sistemi di pagamento basati su API esistenti sono consentiti dopo l'integrazione dell'SDK di Google Play Giochi su PC?
Tutti i pagamenti devono essere gestiti dall'SDK Google Play Giochi su PC utilizzando la Fatturazione Google Play. Non puoi utilizzare il metodo di pagamento basato su API esistente nello stesso gioco.
Come possiamo consumare gli acquisti in modalità sviluppatore?
Consuma l'acquisto in modalità sviluppatore entro 3 minuti, altrimenti l'acquisto verrà rimborsato.
Sono supportati i pagamenti ricorrenti o gli abbonamenti?
Non per il futuro immediato, anche se puoi fornire casi d'uso specifici da aggiungere alla nostra roadmap futura.
Che cos'è l'errore di fatturazione nelle mie chiamate di acquisto?
BillingError è la risposta del risultato del pagamento. LaunchPurchaseFlow restituirà immediatamente il risultato senza bloccare, ma devi ascoltare il callback per sapere quando è terminato e acquisire il risultato.
Come faccio a utilizzare la verifica degli acquisti lato client?
Ti consigliamo di utilizzare l'acquisto lato server e la relativa procedura di verifica. Per elaborare gli acquisti dalla tua app client, il tuo gioco deve essere incluso in una lista consentita. Se il tuo gioco richiede l'accesso, contatta il tuo partner di Google. Per saperne di più, consulta Elabora senza un server di backend.
Quali sono i limiti API per l'esecuzione di query sui dettagli dei prodotti?
Il numero massimo di prodotti su cui è possibile eseguire query in una singola chiamata all'API
QueryProductDetailsè 50. Se superi questo limite, devi suddividere la richiesta in più chiamate.Perché le query sui prodotti o i flussi di acquisto non vanno a buon fine con errori interni quando vengono caricati molti SKU dei prodotti?
L'esecuzione di query su troppi SKU di prodotti contemporaneamente o la chiamata di
QueryProductDetailsin C++ oQueryProductDetailsAsyncin Unity consecutivamente troppe volte in un breve periodo, ad esempio l'invio di decine di chiamate batch in un ciclo ristretto o la creazione di una nuova istanzaBillingClientper batch, può sovraccaricare le connessioni IPC e backend locali. Quando queste connessioni vengono reimpostate, le query sui dettagli del prodotto non vanno a buon fine e il gioco non può ottenere i token di offerta necessari per avviare un flusso di acquisto.Per evitare questi errori durante il caricamento del catalogo, segui queste pratiche:
- Rispetta il numero di prodotti supportati per chiamata: non eseguire query su più di 50 prodotti in una singola chiamata
QueryProductDetailsoQueryProductDetailsAsynce memorizza nella cache ilProductDetailsrestituito anziché eseguire nuovamente query sull'intero catalogo più volte. Per ulteriori informazioni sui limiti dei batch supportati e sull'esecuzione di query sui dettagli dei prodotti, consulta la domanda precedente sui limiti dell'API, Mostra i prodotti disponibili per l'acquisto per C++ e Esegui query sui dettagli dei prodotti per Unity. - Evita di chiamare le API consecutivamente troppe volte in un breve periodo: non inviare più batch di query sui prodotti contemporaneamente o uno dopo l'altro senza un intervallo di tempo. Riutilizza una singola istanza
BillingClient, serializza le richieste o limita la concorrenza a due o tre chiamate in corso alla volta e aggiungi un breve ritardo tra i batch consecutivi. - Esegui l'aggiornamento all'SDK più recente: aggiorna l'integrazione all'ultima versione dell'SDK Google Play Giochi su PC, versione 26.9.261.0 per C++ o 26.9.261.0 per Unity, dalla pagina dei download dell'SDK Google Play Giochi su PC per assicurarti che il tuo client includa gli ultimi miglioramenti alla fatturazione e alla stabilità dell'IPC.
- Rispetta il numero di prodotti supportati per chiamata: non eseguire query su più di 50 prodotti in una singola chiamata
Quali parametri sono richiesti quando si chiama Query Purchases o Launch Purchase Flow nel client di fatturazione?
La funzione accetta
QueryPurchasesContinuation, che è un callback della funzione con la firmastd::function<void(QueryPurchasesResult)>. Il callback ti trasmette il risultato con tutti iProductPurchaseDetails. Queste informazioni sono disponibili nei file di intestazione dell'SDK nel fileincludes/billing/models.h.Il
launch_purchase_flow_resultrisultante ha le funzioniok()ecode(). La funzioneok()indica se il flusso è stato eseguito correttamente. La funzionecode()restituisce l'enumBillingError(includes/billing/enums.h), che ha 10 possibili casi di errore, ad esempio l'annullamento da parte dell'utente o un errore di rete.È supportato un ordinamento personalizzato per il flusso di acquisto di lancio nel client di fatturazione?
Nell'attuale design dell'SDK, non è possibile trasmettere il proprio payload. Tuttavia, puoi fornire qualsiasi combinazione di
obfuscated_account_ideobfuscated_profile_id. Puoi non fornirne nessuno, fornirne solo uno o entrambi.Il campo
offer_tokenè obbligatorio e specifica l'offerta di acquisto che l'utente sta tentando di acquistare nel flusso di checkout. Al momento, ogni SKU in Google Play ha esattamente un'offerta (ad esempio, acquista un articolo per 10 $). In futuro, il team di Fatturazione Play fornirà assistenza per più offerte.Per assicurarti che i metadati vengano associati in caso di interruzioni del flusso di acquisto, memorizzali sul tuo server di backend prima di lanciare la finestra di dialogo di acquisto e associali all'ID account dell'utente, allo SKU acquistato e al timestamp corrente. Per maggiori informazioni, consulta la sezione Associa un acquisto ai dati interni.
Quali sono i prerequisiti per passare dalla fatturazione Google con OAuth alla fatturazione Google basata su DLL?
I giochi possono continuare a utilizzare l'accesso OAuth con Google per gestire l'account che ha eseguito l'accesso, ma Google consiglia di interrompere l'utilizzo delle API di fatturazione REST legacy. Il passaggio dalle API di fatturazione REST (con accesso OAuth2) al flusso dell'SDK può essere un'operazione con flag di funzionalità, quindi entrambi possono coesistere per un periodo di tempo durante il passaggio del gioco.
La chiamata API del flusso di acquisto di lancio viene elaborata tramite un browser web?
No, il flusso di acquisto ora viene completato interamente in-game utilizzando un overlay WebView fluido, senza uscire dal client di gioco.
Un utente deve accedere separatamente a ogni gioco per effettuare un acquisto?
L'account in primo piano in Google Play Games viene utilizzato per ogni sessione di gioco, quindi non è necessario eseguire nuovamente l'accesso. L'account che utilizzi in Google Play Giochi all'inizio della sessione di gioco è l'account con cui vengono effettuate le chiamate API. Il flusso di acquisto utilizzerà automaticamente questo account.
Un gioco può supportare contemporaneamente sia l'SDK per PC sia i sistemi di pagamento legacy?
Il sistema di pagamento funziona secondo un modello a doppio flusso a seconda della versione binaria del gioco. Gli utenti con build precedenti continuano con il flusso esistente, mentre gli utenti con nuove build passano ai pagamenti basati su SDK. Gli utenti di entrambi i flussi di pagamento coesistono durante il periodo di transizione.
Windows App Bundle
Quando invio un WAB utilizzando un launcher di terze parti, è necessario il pacchetto di gioco per la revisione?
Puoi inviare solo il programma di installazione e non l'intero pacchetto di gioco. Il revisore potrà scaricare il pacchetto di gioco utilizzando il programma di installazione.
Esistono limitazioni per le dimensioni dei file WAB?
Per la pubblicazione del programma di installazione, puoi caricare un file WAB di dimensioni fino a 10 GB. Per la pubblicazione gestita di Google Play, il limite massimo per le dimensioni dei file WAB è di 200 GB.
Perché il mio gioco non viene installato o non viene visualizzato dopo aver caricato il mio bundle di asset web?
Se il tuo gioco viene integrato senza una versione per PC preesistente (un "WAB per la prima volta"), il sistema potrebbe inserirlo automaticamente in uno stato di attesa della pubblicazione gestita. Questo accade perché non esiste una base di riferimento da aggiornare. Per rilasciare completamente il WAB e rendere il gioco disponibile per l'installazione, devi andare su Google Play Console ed eseguire manualmente l'azione di pubblicazione richiesta (ad esempio, fai clic su "Pubblica modifiche").
Come faccio a caricare il WAB per i test interni?
Condividi gli account della lista consentita con Google in modo che possa attivarli per i test interni. Una volta che Google ha l'elenco, si assicura che i partner siano inclusi nel processo di onboarding.
Dove deve essere caricato il pacchetto WAB?
Puoi caricare il pacchetto WAB nella posizione indicata nella prima domanda. Tuttavia, non puoi pubblicarla manualmente. Devi fornire al personale di backend di Google un'ora UTC precisa (fino all'ora). Google configura quindi il programma delle pubblicazioni e si assicura che i contenuti vengano pubblicati in tempo.
SDK per PC
Quali sono le differenze tra l'API precedente e l'SDK Google Play Giochi su PC?
- L'API precedente offre solo funzionalità di fatturazione.
- L'SDK per PC supporta Google Desktop Service (GDS) e le funzionalità complete per PC.
- Con l'SDK per PC non è richiesto l'accesso a Google basato su browser.
Esiste un modo alternativo per inizializzare l'SDK avviando il gioco direttamente tramite il relativo avviatore, senza passare da Google Play Giochi su PC?
Il gioco deve essere avviato tramite il client Google Play Giochi su PC. Per maggiori dettagli, consulta questo documento per lo sviluppo.
L'SDK PC supporta i caratteri multibyte nel file di certificazione PEM?
Sì, l'SDK supporta i caratteri multibyte per la certificazione.
In che modo l'SDK gestisce l'accesso all'Account Google per più istanze o account?
Ogni avvio di un gioco in Google Play Games viene considerato una "sessione di gioco" e a ogni "sessione di gioco" può essere associato un account. Possono essere diversi. Quindi, se avvii il gioco con l'account A e poi passi all'account B e lo riavvii, entrambi possono essere eseguiti contemporaneamente.
L'integrazione di Play Install Referrer funziona con l'SDK per PC?
L'SDK per PC (25.5.409.0 e versioni successive) supporta l'API Play Install Referrer. Per saperne di più, consulta la pagina API Play Install Referrer.
Avvio applicazioni
Se un giocatore utilizza un avviatore di terze parti anziché il client Google Play, il suo account Play Games Services verrà sincronizzato automaticamente?
Affinché le funzioni dell'SDK funzionino, il gioco deve essere avviato direttamente tramite il client Google Play Games. Se il gioco viene avviato da un altro processo, ad esempio un'applicazione di installazione o di avvio, questo processo deve essere avviato dal client Google Play Games. Il gioco deve passare tutti i parametri ricevuti dal client al processo del client.
Come faccio a gestire l'inizializzazione se Google Play Giochi avvia un programma di avvio di giochi di terze parti?
Non è necessario integrare l'SDK direttamente nel tuo programma di avvio. Tuttavia, devi passare tutti gli argomenti della riga di comando ricevuti dal programma di avvio dal client Google Play Giochi direttamente al processo secondario generato (l'eseguibile del gioco). Se l'inizializzazione non va a buon fine (ad esempio, restituendo
kActionRequiredShutdownClientProcess), tutti i processi, incluso il programma di avvio, devono essere terminati in modo che Google Play Games possa tentare di recuperare e riavviare il gioco automaticamente. Per maggiori dettagli, consulta il passaggio 5 della guida alla configurazione.Come posso gestire gli aggiornamenti e la manutenzione del mio gioco e del mio programma di avvio dopo la messa in produzione?
Gli aggiornamenti e la manutenzione successivi devono essere implementati tramite il tuo launcher. Il client Google Play Games non supporta le funzioni di aggiornamento, pertanto il programma di avvio deve essere in grado di aggiornare sia il gioco sia il programma di avvio stesso.
In che modo il programma di installazione riceve il token di sessione di GPG per la riproduzione automatica?
GPG passa il token di sessione utilizzando l'argomento della riga di comando
--g_session_token=<token>al programma di installazione. Per attivare questa funzionalità, devi impostareacceptsCommandLineArguments="true"inplay_publishing_config.xml.Il programma di installazione è responsabile dell'estrazione di questo token e del suo utilizzo per avviare il gioco. Se la generazione del token non va a buon fine, GPG avvia il programma di installazione senza il token (fallback).
Inizializzazione
Quando avvio un gioco utilizzando l'app Google Play Giochi, i dettagli del mio Account Google vengono sincronizzati?
Dopo aver avviato il gioco tramite il client Google Play Games, l'account viene sincronizzato automaticamente e non è necessario accedere di nuovo tramite la procedura di accesso di Google.
È possibile riutilizzare i parametri di inizializzazione più volte?
Questo è possibile se il client Google Play Games è in esecuzione e i dati di accesso sono validi. Tuttavia, in scenari come quello descritto nella guida, tutti i processi avviati dal gioco devono essere terminati quando l'utente chiude il gioco o il gioco viene chiuso a causa di un errore di inizializzazione dell'SDK, ad esempio
kActionRequiredShutdownClientProcess.Esiste un modo per creare una scorciatoia per aprire direttamente il gioco?
Puoi utilizzare il seguente URI per aprire direttamente il gioco:
googleplaygames://launch/?pid=2&id=com.company.gamenameL'URI supporta il rilevamento dell'apertura del client Google Play Giochi su PC. Se il client non è aperto, il client Google Play Games si apre prima dell'esecuzione del gioco o del programma di avvio. Devi gestire il gioco o il programma di avvio per impedire l'esecuzione di più istanze.
Esiste un modo per verificare l'installazione di Google Play Giochi su PC senza utilizzare l'SDK?
Puoi verificare lo stato dell'installazione di Google Play Giochi su PC senza integrare l'SDK controllando la presenza della seguente chiave del Registro di sistema di Windows:
HKEY_LOCAL_MACHINE\SOFTWARE\Google\Play Games ServicesLa presenza di questa chiave indica che i servizi per i giochi di Google Play (necessari per eseguire i giochi su PC) sono installati sul computer. Se la chiave non è presente, devi indirizzare l'utente alla pagina di installazione di Google Play Giochi su PC per scaricare e installare il client.
Test
Esistono ambienti di test aperti o chiusi simili a quelli per dispositivi mobili?
Sebbene non sia disponibile una sandbox end-to-end dedicata, riconosciamo la necessità di un ambiente di test simile alla produzione per gli sviluppatori. A breve verrà offerta una soluzione più solida.
Come faccio ad aggiungere nuovi tester?
Il tuo referente Google crea un gruppo email per ogni progetto PC, in cui devono essere aggiunti gli Account Google dei tester. Solo i membri di questo gruppo email sono autorizzati a scaricare i pacchetti di test in Google Play Games.
Varie
Posso utilizzare una VPN?
Per gli sviluppatori che devono testare il proprio gioco in regioni in cui Google Play Giochi su PC non è supportato, consigliamo di utilizzare una VPN per acquisire un indirizzo IP da una regione supportata.
Assicurati di attivare la modalità TUN sulla VPN. Le istruzioni per attivare la modalità TUN e configurare il firewall sono disponibili nel manuale operativo del provider VPN.
Dopo aver attivato la modalità TUN, installa Google Play Giochi su PC e l'emulatore per i test.
Come posso iniziare a sviluppare per Google Play Giochi su PC nell'editor di Unity o UE?
- Attiva la modalità sviluppatore e procedi con i test.
- Aggiungi i file
manifest.xmle.dll. Per saperne di più, consulta la documentazione per lo sviluppo. - Registra un GUID partner con accesso in anteprima per scopi di test.
Come faccio a utilizzare correttamente le chiavi del Registro di sistema?
Devi creare le chiavi del Registro di sistema in base all'hive principale. Puoi impostare l'hive root come
HKEY_LOCAL_MACHINEoHKEY_CURRENT_USERa seconda dello scopo e della natura dei dati. L'hiveHKEY_LOCAL_MACHINEviene utilizzato come esempio nelle linee guida.Quali sono i requisiti per la revisione dei pacchetti per PC da parte di Google?
I pacchetti per PC vengono sottoposti a scansione malware, dopodiché i revisori testano solo i processi di installazione, avvio riuscito e disinstallazione del gioco.
È necessario integrare tutte le API?
Altre API non sono obbligatorie, ma offrono vantaggi aggiuntivi.
google::play::billingè obbligatorio per gli acquisti in-app e la vendita di contenuti digitali.google::play::install_referrerè necessario per monitorare i dati dei referral per aiutarti a capire quali sorgenti di traffico indirizzano il maggior numero di utenti al download della tua app.google::play::games::integrityè necessario per proteggere la tua app da malintenzionati rilevando dispositivi potenzialmente rischiosi ed emulatori sconosciuti.Perché alcuni processi di gioco vengono terminati quando il client Google Play Games viene chiuso, mentre altri no?
Google non controlla i processi secondari o i processi del gioco in esecuzione. Il comportamento dipende dal fatto che il gioco sia un gioco Android emulato o un gioco per PC. I giochi emulati vengono installati nel proprio ambiente, pertanto il loro comportamento dipende in gran parte dall'inizializzazione e dall'arresto dell'emulatore.
Devo utilizzare la funzionalità di disinstallazione di Google Play Giochi o un programma di disinstallazione personalizzato?
Google consiglia di utilizzare la funzionalità di disinstallazione di Google Play Giochi.
Ulteriore assistenza
Se hai bisogno di ulteriore assistenza non trattata in queste domande frequenti, contatta l'indirizzo google-play-games-pc@google.com