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'SDK Play Games PC più recente per il tuo ambiente. Per saperne di più, consulta la guida di Unity o la guida di C++.
  • Crea il manifest dell'applicazione:crea un file manifest.xml che mappi <PackageName> al pacchetto Play Console rivendicato. Per ulteriori informazioni, consulta la Guida al manifest.
  • Firma digitalmente il tuo eseguibile: firma il tuo 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 Firma digitale del 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 correlati al certificato siano 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, all'avvio prima di utilizzare altre funzionalità. Per saperne di più, consulta la guida all'inizializzazione.
  • Implementa l'accesso senza interruzioni:autentica automaticamente i giocatori utilizzando l'account client Play Giochi tramite l'API Recall. Per saperne di più, consulta la guida all'accesso senza interruzioni.
  • Integra Play Integrity:utilizza IntegrityClient per richiedere token e verificare la legittimità delle sessioni di gioco sul tuo 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 saperne di più, consulta la guida Install Referrer.
  • Gestisci gli errori di inizializzazione:per utilizzare l'SDK, chiama GooglePlayInitialize (C++) o GooglePlayInitialization.InitializeAsync (C#) per inizializzare l'API. Devi chiamare questa funzione e verificare che il callback di continuazione venga completato con InitializeResult::ok() (C++) o Result.IsOk (C#) restituisca true prima di poter utilizzare qualsiasi altra API.
  • Gestisci l'arresto forzato:gestisci kActionRequiredShutdownClientProcess arrestando il processo client il prima possibile.
  • Gestisci i requisiti di installazione di Google Play Games: gestisci kSdkRuntimeUnavailable informando gli utenti che per procedere è necessario installare Google Play Games e l'SDK Runtime.
  • Gestisci gli aggiornamenti di Google Play Games: gestisci kSdkRuntimeUpdateRequired notificando agli utenti che è necessario un aggiornamento del runtime di Google Play Games.

Implementare la 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, dividi la richiesta in più chiamate. Per maggiori informazioni, consulta la guida ai prodotti di query.
  • Avvia il flusso di acquisto:utilizza LaunchPurchaseFlow per elaborare le transazioni in modo nativo. Si verifica un errore di timeout di cinque minuti se chiudi il browser di pagamento senza pagare. Per saperne di più, consulta la guida al flusso di acquisto.
  • Ripristina gli acquisti esistenti:chiama QueryPurchases all'avvio e in primo piano per rilevare gli acquisti cross-device non confermati. Per ulteriori informazioni, consulta la guida al ripristino degli acquisti.
  • Elaborazione backend sicura:convalida purchaseToken sul backend prima di concedere i diritti e finalizzare con AcknowledgePurchase o ConsumePurchase. Per saperne di più, consulta la guida all'elaborazione sicura.

Esegui test in modalità sviluppatore ed esegui il QA pre-lancio

  • 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 per l'accesso in anteprima, compila il modulo 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 saperne di più, 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.
  • Inoltrare 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 saperne di più, consulta la guida multiprocesso.
  • Esegui il test con una VPN: se esegui il test da una regione non supportata, utilizza una rete privata virtuale (VPN) con la modalità TUN attivata per acquisire un indirizzo IP supportato. Per saperne di più, consulta le domande frequenti sui test VPN.
  • Supporto delle scorciatoie del desktop:per un supporto delle scorciatoie senza interruzioni, consulta le domande frequenti sulle scorciatoie per l'esecuzione delle scorciatoie. L'avvio diretto del gioco o di un launcher di terze parti tramite una scorciatoia potrebbe causare errori di inizializzazione.

Pacchettizzare, testare e pubblicare il gioco

  • Crea il pacchetto WAB:utilizza lo strumento di pubblicazione Play per creare un pacchetto del tuo gioco in un Windows App Bundle (WAB). Le dimensioni del file WAB devono essere inferiori al limite di 10 GB. Per saperne di più, consulta la guida all'imballaggio.
  • Invia i programmi di installazione di strumenti di avvio di app di terze parti: se utilizzi uno strumento di 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 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.
  • Condividere le informazioni sul lancio con Google: contatta il tuo partner di Google Play e comunica 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 test, documentazione e accesso a Google Drive. Condividi una mailing list di account di test con il tuo partner Google 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 compresso nel canale di produzione e configura gli asset visivi. Per saperne di più, consulta la guida al caricamento degli asset.
  • Pubblica per il test dell'ambiente utente:seleziona Pubblica in Google Play Console. A differenza della versione Android, la selezione di Pubblica su 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 Play.

Eseguire 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 differire da quelli nell'ambiente API. Verifica che il tuo gestore di pacchetti gestisca e trasmetta correttamente tutti gli argomenti. Per ulteriori informazioni, consulta Verifica.
  • Verifica il percorso del registro:per una migrazione senza problemi all'SDK nativo, la configurazione del registro deve rimanere coerente con le versioni precedenti. Per saperne di più, consulta la guida ai file WAB.

Vedi anche