Elenco di controllo per il lancio

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.

Configurare il progetto

  • Scarica e importa l'SDK: integra l'ultima versione dell'SDK Play Games per PC per il tuo ambiente. Per ulteriori informazioni, consulta la guida di Unity o la guida di C++.
  • Crea il manifest dell'applicazione: crea un file manifest.xml che mappa il <PackageName> al pacchetto Play Console rivendicato. Per ulteriori informazioni, consulta la guida al manifest.
  • Firma digitalmente l'eseguibile: firma il gioco utilizzando una firma digitale Authenticode e proteggi il certificato per tutti gli aggiornamenti futuri. Sebbene tu possa 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 ulteriori informazioni, consulta la sezione Firmare digitalmente il gioco.
  • Formatta e invia il certificato: Invia le informazioni sul certificato al tuo rappresentante 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.

Integrare 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 ulteriori informazioni, consulta la guida all'inizializzazione.
  • Implementa l'accesso senza interruzioni: autentica automaticamente i giocatori utilizzando l'account client di Play Giochi tramite l'API Recall. Per ulteriori informazioni, consulta la guida all'accesso senza interruzioni.
  • Integra Play Integrity: utilizza IntegrityClient per richiedere token e verificare la legittimità delle sessioni di gioco sul backend. Per ulteriori informazioni, consulta la guida a Play Integrity.
  • Aggiungi Play Install Referrer: integra l'API Install Referrer se devi monitorare le origini di acquisizione utenti per PC. Per ulteriori informazioni, consulta la guida a Install Referrer.
  • Gestisci gli errori di inizializzazione: per utilizzare l'SDK, chiama GooglePlayInitialize (C++) o GooglePlayInitialization.InitializeAsync (C#) per inizializzare l'API. Prima di poter utilizzare qualsiasi altra API, devi chiamare questa API e verificare che il callback di continuazione venga completato con InitializeResult::ok() (C++) o che Result.IsOk (C#) restituisca true.
  • Gestisci l'arresto obbligatorio: gestisci kActionRequiredShutdownClientProcess arrestando il processo client il prima possibile.
  • Gestisci i requisiti di installazione di Google Play Giochi: gestisci kSdkRuntimeUnavailable informando gli utenti che per procedere è necessario installare Google Play Giochi e il runtime dell'SDK.
  • Gestisci gli aggiornamenti di Google Play Games: gestisci kSdkRuntimeUpdateRequired notificando agli utenti che è necessario un aggiornamento del runtime di Google Play Games.

Implementare 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 ulteriori informazioni, consulta le domande frequenti sulla fatturazione.
  • Esegui query sui dettagli del prodotto: utilizza QueryProductDetails per recuperare i dati del negozio localizzati. Se hai più di 50 prodotti, suddividi la richiesta in più chiamate. Per ulteriori informazioni, consulta la guida Eseguire query sui prodotti.
  • Avvia il flusso di acquisto: utilizza LaunchPurchaseFlow per elaborare le transazioni in modo nativo. Se chiudi il browser di pagamento senza pagare, si verifica un errore di timeout di cinque minuti. Per ulteriori informazioni, consulta la guida al flusso di acquisto.
  • Ripristina gli acquisti esistenti: chiama QueryPurchases all'avvio e in primo piano per intercettare gli acquisti cross-device non riconosciuti. Per ulteriori informazioni, consulta la guida Ripristinare gli acquisti.
  • Proteggi l'elaborazione del backend: convalida il purchaseToken sul backend prima di concedere i diritti e finalizzare con AcknowledgePurchase o ConsumePurchase. Per ulteriori informazioni, consulta la guida Elaborazione sicura.

Testare in modalità sviluppatore ed eseguire la QA pre-lancio

  • Testa in modalità sviluppatore: aggiungi <IsDeveloperMode>true</IsDeveloperMode> a l manifest e configura il GUID del partner di accesso anticipato per i test dell'ambiente di sviluppo integrato (IDE) locale. Se non hai un GUID del partner di accesso anticipato, compila il modulo di richiesta di interesse.
  • Gestisci gli acquisti in modalità sviluppatore: quando testi gli acquisti in modalità sviluppatore, consuma l'acquisto entro tre minuti per evitare rimborsi automatici. Per ulteriori informazioni, consulta le domande frequenti sui test.
  • Rimuovi la modalità sviluppatore: devi rimuovere il tag <IsDeveloperMode> prima di creare il pacchetto della build di release il prima possibile. Per ulteriori informazioni, consulta la guida alla modalità sviluppatore.
  • Inoltra gli argomenti utilizzando 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 ulteriori informazioni, consulta la guida al processo multiplo.
  • Testa con una VPN: se esegui i test da una regione non supportata, utilizza una rete privata virtuale (VPN) con la modalità TUN attivata per acquisire un indirizzo IP supportato. Per ulteriori informazioni, consulta le domande frequenti sui test VPN.
  • Supporta le scorciatoie del desktop: per un supporto senza interruzioni delle scorciatoie, consulta le domande frequenti sulle scorciatoie per l'esecuzione delle scorciatoie. L'avvio diretto del gioco o di un launcher di terze parti utilizzando una scorciatoia potrebbe causare errori di inizializzazione.

Creare il pacchetto, testare e pubblicare il gioco

  • Crea il pacchetto WAB: utilizza lo strumento di pubblicazione di Play per creare il pacchetto del gioco in un Windows App Bundle (WAB). Le dimensioni del file WAB devono essere inferiori al limite di 10 GB. Per ulteriori informazioni, consulta la guida alla creazione di pacchetti.
  • Invia i programmi di installazione dei launcher di terze parti: se utilizzi un launcher di terze parti, invia il relativo programma di installazione all'interno del WAB. Per ulteriori informazioni, consulta la guida alla pubblicazione del programma di installazione.
  • Aggiorna il gioco e il launcher o il programma di installazione: i contenuti del pacchetto, inclusi i programmi di installazione del launcher, devono essere autoaggiornabili. Gestisci tutte le risorse di cui ha bisogno il tuo gioco, incluso l'aggiornamento del launcher stesso.
  • Condividi le informazioni sul lancio con Google: contatta il tuo partner di Google Play e condividi il nome del pacchetto, i paesi di lancio (utilizzando i codici ISO a 2 caratteri, ad esempio US, CA, MX) e la data e l'ora di lancio in Tempo universale coordinato (UTC).
  • Configura l'accesso ai 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 di indirizzi email degli 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 ulteriori informazioni, consulta la guida ai requisiti del PC.
  • Carica gli asset dello Store: carica il file WAB in pacchetto nel canale di produzione e configura gli asset visivi. Per ulteriori informazioni, consulta la guida al caricamento degli asset.
  • Pubblica per i test dell'ambiente utente: seleziona Pubblica in Google Play Console. A differenza della versione Android, la selezione di Pubblica sul WAB non attiva una release pubblica. Dopo la procedura di revisione di Google, l'app diventa ricercabile per gli account di test condivisi per eseguire i test in un ambiente utente.
  • Lancia ufficialmente: Google controlla il lancio in base alla data di lancio ufficiale che hai condiviso con il tuo partner Play.

Eseguire la migrazione dall'API all'SDK

La migrazione dall'API all'SDK è un passaggio facoltativo. Se scegli di eseguire la migrazione, segui queste raccomandazioni:

  • 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 pacchetto gestisca e passi correttamente tutti gli argomenti. Per ulteriori informazioni, consulta la sezione Verifica.
  • Verifica il percorso del registro: per una migrazione senza interruzioni all'SDK nativo, la configurazione del registro deve rimanere coerente con le versioni precedenti. Per ulteriori informazioni, consulta la guida al file WAB.

Vedi anche