Registrazione video nei giochi Android

A seguito del ritiro dell'API Google Sign-In, rimuoveremo l'SDK v1 per i giochi nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli che sono stati integrati di recente con l'SDK v1 per i giochi. Ti consigliamo di utilizzare l'SDK v2 per i giochi.
Anche se i titoli esistenti con le precedenti integrazioni di giochi v1 continueranno a funzionare per un paio di anni, ti consigliamo di eseguire la migrazione alla v2 a partire da giugno 2025.
Questa guida riguarda l'utilizzo dell'SDK v1 dei servizi per i giochi di Play. La registrazione video non è supportata nell'SDK Play Games Services v2.

L'API di registrazione video ti consente di aggiungere facilmente la registrazione video al tuo gioco e di consentire agli utenti di condividere i propri video con gli amici su YouTube in pochi semplici passaggi. Ad esempio, potresti aggiungere un pulsante a una schermata di replay di una battaglia che, quando viene premuto, apre l'esperienza di registrazione video di Play Giochi.

Questa guida mostra come implementare la registrazione video nei giochi utilizzando i servizi per i giochi di Google Play. Le API sono disponibili nei pacchetti com.google.android.gms.games.video e com.google.android.gms.games.

Prima di iniziare

Prima di iniziare a utilizzare l'API di registrazione video:

• Scarica e rivedi l'esempio di codice.

• Acquisisci familiarità con i consigli descritti nella lista di controllo della qualità.

Scarica il client video

Per iniziare a utilizzare l'API di registrazione video, il gioco deve prima ottenere un oggetto VideosClient. Per farlo, chiama il metodo Games.getVideosClient() e passa l'attività e l'GoogleSignInAccount per il giocatore attuale. Per scoprire come recuperare le informazioni dell'account giocatore, consulta la sezione Accesso nei giochi per Android.

Nota: la classe VideosClient utilizza la classe Task di Google Play Services per restituire i risultati in modo asincrono. Per saperne di più sull'utilizzo delle attività per gestire il lavoro in thread, consulta la Guida per gli sviluppatori dell'API Tasks.

Nozioni di base sull'API Video Recording

Puoi utilizzare l'API di registrazione video per integrare un'esperienza di registrazione video direttamente all'interno del gioco.

L'esperienza di registrazione video per gli utenti include quanto segue:

• La sovrapposizione di registrazione video, che ha tre pulsanti:

  1. Avviare / interrompere la registrazione
  2. Attivare / disattivare il microfono
  3. Attivare / disattivare la videocamera anteriore
  Nota: se fai clic sul display della fotocamera frontale della sovrapposizione, vengono visualizzati i tre pulsanti menzionati in precedenza.

• Un pulsante fornito dallo sviluppatore per avviare la registrazione o un trigger di registrazione alternativo

• Un toast cliccabile che viene visualizzato al termine della registrazione e che consente ai giocatori di caricare il video su YouTube o visualizzarlo tramite l'app Foto (nota: i video registrati vengono memorizzati nella categoria ScreenCasts in Foto)

Avviare l'overlay di registrazione video

Per avviare la registrazione video per il giocatore attualmente connesso, segui questi passaggi:

1. Chiama il metodo VideosClient.getCaptureOverlayIntent().
2. Se la chiamata ha esito positivo, i servizi per i giochi di Google Play restituiscono un oggetto Task che carica in modo asincrono un intent per avviare l'overlay di registrazione video.
3. Utilizza l'intent del passaggio precedente per avviare un'attività.

Ecco un esempio di come visualizzare la sovrapposizione di registrazione video:

private static final int RC_VIDEO_OVERLAY = 9011;

public void showVideoOverlay(View myview) {
  Games.getVideosClient(this, GoogleSignIn.getLastSignedInAccount(this))
      .getCaptureOverlayIntent()
      .addOnSuccessListener(new OnSuccessListener<Intent>() {
        @Override
        public void onSuccess(Intent intent) {
          startActivityForResult(intent, RC_VIDEO_OVERLAY);
        }
      });
}

Suggerimenti per l'utilizzo dei dati di registrazione video

L'API di registrazione video ti consente di integrare un'esperienza di registrazione video direttamente nel tuo gioco.

Suggerimento	Descrizione
Rendere facilmente individuabile l'attivazione della registrazione video	Posizionare in modo ben visibile un pulsante di registrazione al di fuori del menu principale Attivare automaticamente la sovrapposizione da un'opzione di menu della modalità di registrazione dedicata ed etichettata in modo chiaro
Promuovi l'utilizzo della funzionalità nella scheda dello Store e all'interno del gioco	Utilizza uno screenshot nella scheda dello Store che mostri la sovrapposizione della registrazione video Promuovere la funzionalità di registrazione video tramite promozioni in-game Valuta la possibilità di fornire premi in-game per la condivisione delle repliche
Coinvolgi la community di giocatori con le competizioni di replay	Incoraggia i giocatori a registrare e condividere le repliche delle partite con concorsi settimanali, mensili o annuali Riconoscere i migliori video e creator nel gioco o sui social media