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 integrati in precedenza con l'SDK v1 per i giochi continueranno a funzionare per un paio di anni, ti consigliamo di eseguire la migrazione all'SDK v2 a partire da giugno 2025.
Questa guida riguarda l'utilizzo dell'SDK Play Games Services v1. La registrazione video non è supportata nell'SDK Play Games Services v2.

Con l'API di registrazione video, puoi aggiungere facilmente l'opzione di registrazione video al tuo gioco e 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 l'opzione di 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.

• Fai pratica con i consigli descritti nella lista di controllo della qualità.

Scaricare il client di video

Per iniziare a usare 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 il parametro GoogleSignInAccount per il giocatore corrente. Per scoprire come recuperare le informazioni dell'account del 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 su più thread, consulta la Guida per gli sviluppatori sull'API Tasks.

Nozioni di base sull'API di registrazione video

Puoi usare 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:

• L'overlay di registrazione video, che ha tre pulsanti:

  1. Avvia/Interrompi registrazione
  2. Attiva/Disattiva microfono
  3. Attiva/Disattivare videocamera anteriore
  Nota: toccando l'anteprima della fotocamera frontale nell'overlay, appaiono i tre pulsanti citati in precedenza.

• Un pulsante fornito dallo sviluppatore per avviare la registrazione o un elemento alternativo di attivazione della registrazione

• Un toast cliccabile che compare 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 salvati nella categoria ScreenCasts in Foto)

Avvia l'overlay di registrazione video

Per avviare la registrazione video per il giocatore che ha eseguito l'accesso, 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 l'overlay 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 delle registrazioni video

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

Suggerimento	Descrizione
Rendi facilmente individuabile l'attivazione della registrazione video	Posiziona in modo ben visibile un pulsante di registrazione al di fuori del menu principale Attiva automaticamente l'overlay 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 l'overlay di registrazione video Promuovi la funzionalità di registrazione video tramite promozioni in-game Valuta la possibilità di fornire premi in-game per la condivisione dei replay
Coinvolgi la tua community di giocatori con le competizioni di replay	Incoraggia i giocatori a registrare e condividere i replay delle partite con competizioni settimanali, mensili o annuali dedicate ai migliori replay Riconosci i video e i creator migliori nel gioco o sui social media