Utilizza questo elenco di controllo per assicurarti che il tuo gioco soddisfi tutti i requisiti e le best practice prima di inviarlo per la revisione su Google Play Giochi su PC.
Imposta e configura il progetto
- Scarica e importa l'SDK: integra l'SDK Play Giochi su PC più recente per il tuo ambiente. Per saperne di più, consulta la guida di Unity o la guida di C++.
- Crea il file manifest dell'applicazione: crea un file
manifest.xmlche mappa<PackageName>al pacchetto Play Console rivendicato. Per ulteriori informazioni, consulta la guida ai manifest. - Firma digitalmente l'eseguibile: firma il gioco utilizzando una firma digitale Authenticode e proteggi il certificato per tutti gli aggiornamenti futuri. Anche se puoi saltare questo passaggio durante lo sviluppo locale attivando la modalità sviluppatore, devi firmare il file binario finale con un certificato di produzione effettivo di un'autorità di certificazione nota. Per saperne di più, consulta Firma digitalmente il tuo gioco.
- Formatta e invia il certificato: invia le informazioni del certificato al tuo rappresentante di Google. Il file del certificato deve contenere solo informazioni relative al certificato. Verifica che tutti i blocchi non relativi al certificato siano stati rimossi. Puoi utilizzare OpenSSL per convertire i file DER/CER nel formato PEM richiesto.
Integra API e funzionalità
- Inizializza l'SDK: implementa la logica di inizializzazione dell'SDK, ad esempio
InitializeAsync, durante l'avvio prima di utilizzare altre funzionalità. Per saperne di più, consulta la guida all'inizializzazione. - Implementa l'accesso senza interruzioni: autentica i giocatori automaticamente utilizzando l'account cliente di Play Giochi tramite l'API Recall. Per ulteriori informazioni, consulta la guida all'accesso integrato.
- Integra Play Integrity: utilizza l'
IntegrityClientper richiedere token e verificare la legittimità delle sessioni di gioco sul tuo backend. Per ulteriori informazioni, consulta la guida di Play Integrity. - Aggiungi Play Install Referrer: integra l'API Install Referrer se devi monitorare le origini di acquisizione utenti per PC. Per saperne di più, consulta la guida all'installazione del referrer.
- Gestisci gli errori di inizializzazione: per utilizzare l'SDK, chiama
GooglePlayInitialize(C++) oGooglePlayInitialization.InitializeAsync(C#) per inizializzare l'API. Devi chiamare questo metodo e verificare che il callback di continuazione venga completato conInitializeResult::ok()(C++) oResult.IsOk(C#) restituiscatrueprima di poter utilizzare qualsiasi altra API. - Gestisci l'arresto obbligatorio: gestisci
kActionRequiredShutdownClientProcessarrestano il processo client il prima possibile. - Gestisci i requisiti di installazione di Google Play Giochi: gestisci
kSdkRuntimeUnavailableinformando gli utenti che per procedere è necessario installare Google Play Giochi e il runtime SDK. - Gestisci gli aggiornamenti di Google Play Games: gestisci
kSdkRuntimeUpdateRequirednotificando agli utenti che è necessario un aggiornamento del runtime di Google Play Games.
Implementa Fatturazione Play
- Controlla i tipi di acquisto: verifica che il tuo gioco si basi solo sugli acquisti in-app, perché i pagamenti ricorrenti e gli abbonamenti non sono supportati. Per saperne di più, consulta le domande frequenti sulla fatturazione.
- Esegui query sui dettagli dei prodotti: utilizza
QueryProductDetailsper recuperare i dati localizzati dello store. Se hai più di 50 prodotti, suddividi la richiesta in più chiamate. Per maggiori informazioni, consulta la guida ai prodotti di query. - Avvia il flusso di acquisto: utilizza
LaunchPurchaseFlowper elaborare le transazioni in modo nativo. Se chiudi il browser di pagamento senza pagare, si verifica un errore di timeout di cinque minuti. Per saperne di più, consulta la guida al flusso di acquisto. - Ripristina gli acquisti esistenti: chiama
QueryPurchasesall'avvio e all'attivazione in primo piano per rilevare gli acquisti cross-device non confermati. Per saperne di più, consulta la guida al ripristino degli acquisti. - Elaborazione sicura del backend: convalida il
purchaseTokensul tuo backend prima di concedere i diritti e finalizza conAcknowledgePurchaseoConsumePurchase. Per saperne di più, consulta la guida all'elaborazione sicura. - Tieni conto del ritardo di propagazione del codice licenza: quando configuri nuovi codici licenza o di fatturazione in Play Console, attendi alcune ore affinché la cache di backend si sincronizzi negli ambienti di pubblicazione commerciale prima di eseguire test di acquisto dal vivo. Gli acquisti tentati prima del completamento della sincronizzazione restituiranno il codice di errore 6.
Esegui i test in modalità sviluppatore e il QA pre-lancio
- Esegui i test in modalità sviluppatore: aggiungi
<IsDeveloperMode>true</IsDeveloperMode>al manifest e configura il GUID del partner con accesso in anteprima per i test dell'ambiente di sviluppo integrato (IDE) locale. Se non hai un GUID partner con accesso in anteprima, compila il modulo di interesse rapido. - Gestisci gli acquisti in modalità sviluppatore: quando testi gli acquisti in modalità sviluppatore, consuma l'acquisto entro tre minuti per evitare rimborsi automatici. Per saperne di più, consulta le domande frequenti sui test.
- Rimuovi la modalità sviluppatore: devi rimuovere il tag
<IsDeveloperMode>prima di pacchettizzare la build di release il prima possibile. Per ulteriori informazioni, consulta la guida alla modalità sviluppatore. - Inoltra gli argomenti utilizzando i launcher di terze parti: passa tutti gli argomenti della riga di comando sconosciuti ricevuti dal launcher dal client Google Play Giochi direttamente al processo di gioco generato. Per saperne di più, consulta la guida ai multi-processi.
- Esegui il test con una VPN: se esegui il test da una regione non supportata, utilizza una VPN con la modalità TUN attivata per acquisire un indirizzo IP supportato. Per saperne di più, consulta le domande frequenti sui test VPN.
- Supporto dei collegamenti sul desktop: per un supporto ottimale dei collegamenti, consulta le domande frequenti sui collegamenti per l'esecuzione dei collegamenti. L'avvio diretto del gioco o di un launcher di terze parti tramite una scorciatoia potrebbe causare errori di inizializzazione.
Crea il pacchetto, testa e pubblica il tuo gioco
- Crea il pacchetto WAB: utilizza lo strumento di pubblicazione di Play per creare il pacchetto del tuo gioco in un Windows App Bundle (WAB). Il file WAB deve avere dimensioni inferiori a 10 GB per la pubblicazione con il programma di installazione e a 200 GB per la pubblicazione gestita di Google Play. Per saperne di più, consulta la guida al packaging.
- Utilizza gli SDK e gli strumenti più recenti: compila e pacchettizza la tua release con le versioni più recenti dell'SDK Play Giochi su PC, dell'SDK Unity di Play Giochi su PC, dello strumento per sviluppatori di Play su PC e dello strumento di pubblicazione di Play.
- Verifica se è necessaria l'elevazione: se il programma di installazione, Avvio app o il programma di disinstallazione deve essere eseguito come amministratore ogni volta che viene avviato, ricorda di controllare se hai impostato
INSTALLER_REQUIRES_ELEVATION,LAUNCHER_REQUIRES_ELEVATIONoUNINSTALLER_REQUIRES_ELEVATIONsutrue. In caso contrario, non verranno eseguiti con privilegi amministrativi, il che comporterà un errore di avvio. Per maggiori dettagli, consulta Formato file di configurazione WAB. - Invia i programmi di installazione di strumenti per l'avvio di app di terze parti: se utilizzi uno strumento per l'avvio di app di terze parti, invia il relativo programma di installazione all'interno del WAB. Per saperne di più, consulta la guida alla pubblicazione per gli installatori.
- Gestisci il token di sessione di Avvio automatico: se attivi Avvio automatico impostando
acceptsCommandLineArguments="true"inplay_publishing_config.xml, verifica che il programma di installazione estragga l'argomento della riga di comando--g_session_token=<token>e lo utilizzi per avviare il gioco. Assicurati che il programma di installazione gestisca il caso di riserva in cui il token non è presente. Per saperne di più, consulta le domande frequenti su Avvio app. - Aggiorna il gioco e il programma di avvio o il programma di installazione: i contenuti del pacchetto, inclusi i programmi di installazione del programma di avvio, devono essere aggiornabili automaticamente. Gestire tutte le risorse necessarie per il gioco, incluso l'aggiornamento del programma di avvio stesso.
- Condividi le informazioni di lancio con Google: contatta il tuo partner Play e condividi il nome del pacchetto, i paesi di lancio (utilizzando i codici ISO di 2 caratteri, ad esempio US, CA, MX) e la data e l'ora di lancio nel fuso orario UTC (tempo universale coordinato).
- Configura l'accesso per i test: fornisci un gruppo Google esterno da aggiungere a una lista consentita per i test, la documentazione e l'accesso a Google Drive. Condividi un elenco email di account di test con il tuo partner Play, perché i canali di test di Play Console non sono supportati per PC.
- Aggiungi il fattore di forma PC: aggiungi esplicitamente il fattore di forma "Google Play Giochi su PC" alla tua app in Google Play Console. Se non riesci ad accedere a questa scheda, contatta il tuo partner Play per aggiungere il tuo account a una lista consentita.
- Configura i requisiti del PC: inserisci i requisiti hardware (RAM, GPU, spazio di archiviazione) per i PC Windows. Per saperne di più, consulta la guida ai requisiti del PC.
- Carica gli asset dello store: carica il file WAB pacchettizzato nel canale di produzione e configura gli asset visivi. Per saperne di più, consulta la guida al caricamento degli asset.
- Pubblica per i test dell'ambiente utente: seleziona Pubblica in Google Play Console. A differenza della versione per Android, la selezione di Pubblica nella WAB non attiva una release pubblica. Invece, rende l'app ricercabile per i tuoi account di test condivisi per eseguire test in un ambiente utente dopo la procedura di revisione di Google.
- Lancio ufficiale: Google controlla il lancio in base alla data di lancio ufficiale che hai condiviso con il tuo partner di Play.
- Test durante la preregistrazione: durante la fase di preregistrazione, devi eseguire test interni in un paese non incluso nelle regioni di preregistrazione selezionate.
- Verifica la terminazione del processo del programma di installazione: verifica che il processo del programma di installazione principale rimanga attivo finché non vengono create e registrate tutte le chiavi del registry richieste. Se il processo viene chiuso prematuramente, la verifica dell'installazione non va a buon fine. Per saperne di più, consulta Pubblicazione per gli installatori.
- Mantieni hive del registry coerenti ed esegui la pulizia durante la disinstallazione:
Google Play Giochi su PC controlla
HKEY_LOCAL_MACHINEprima diHKEY_CURRENT_USERe utilizza il primo valore corrispondente. Mantieni l'hive del registry coerente tra gli aggiornamenti e i titoli con un programma di avvio condiviso e rimuovi le chiavi del registry durante la disinstallazione in modo che le vociHKEY_LOCAL_MACHINEobsolete non nascondano i percorsiHKEY_CURRENT_USERvalidi. Per saperne di più, consulta Pubblicazione per gli installatori.
Esegui la migrazione dall'API all'SDK
La migrazione dall'API all'SDK è un passaggio facoltativo. Se scegli di eseguire la migrazione, segui questi consigli:
- Rimuovi le API REST legacy: mappa le chiamate API Play Developer legacy (ad esempio
purchases.products.get) alle funzioni dell'SDK nativo lato client. Per ulteriori informazioni, consulta la guida alla migrazione. - Verifica gli argomenti della riga di comando: gli argomenti della riga di comando nell'ambiente SDK potrebbero essere diversi da quelli nell'ambiente API. Verifica che il tuo pacchetto gestisca e passi correttamente tutti gli argomenti. Per saperne di più, consulta Verifica.
- Verifica il percorso del registry: per una migrazione senza problemi all'SDK nativo, la configurazione del registry deve rimanere coerente con le versioni precedenti. Per saperne di più, consulta la guida ai file WAB.