Registrazione video nei giochi Android

A seguito del ritiro dell'API Google Sign-in, rimuoveremo l'SDK di Google Play Services per i giochi v1 nel 2026. Dopo febbraio 2025, non potrai pubblicare su Google Play titoli appena integrati con l'SDK v1 per i giochi. Ti consigliamo di utilizzare invece l'SDK giochi v2.
Sebbene i titoli esistenti con le integrazioni precedenti della versione 1 dei giochi continuino a funzionare per un paio di anni, ti invitiamo a eseguire la migrazione alla versione 2 a partire da giugno 2025.
Questa guida è dedicata all'utilizzo dell'SDK Play Services v1. La registrazione video non è supportata nell'SDK Play 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 video con gli amici su YouTube in pochi semplici passaggi. Ad esempio, potresti aggiungere un pulsante in una schermata di ripetizione della battaglia che, se premuto, mostri l'esperienza di registrazione video di Play Giochi.

Questa guida spiega 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 ed esamina il codice di esempio.

• Acquisisci familiarità con i consigli descritti nel Controllo qualità.

Ottenere il client per i video

Per iniziare a utilizzare l'API di registrazione video, il tuo gioco deve prima ottenere un oggetto VideosClient. Per farlo, chiama il metodo Games.getVideosClient() e passa l'attività e il GoogleSignInAccount per il player corrente. Per scoprire come recuperare i dati dell'account del giocatore, consulta Accedere a Giochi Android.

Nozioni di base sull'API di registrazione video

Puoi utilizzare l'API di registrazione video per integrare un'esperienza di registrazione video direttamente dal tuo gioco.

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

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

  1. Avvia / interrompi la registrazione
  2. Attivare / disattivare il microfono
  3. Attivare / disattivare la fotocamera anteriore

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

• Una notifica popup cliccabile che viene visualizzata al termine della registrazione e consente ai giocatori di caricare il video su YouTube o di visualizzarlo tramite l'app Foto. (Nota: i video registrati vengono archiviati nella categoria ScreenCasts in Foto)

Avvia l'overlay di registrazione video

Per avviare la registrazione video per il player con cui hai eseguito l'accesso, segui questi passaggi:

1. Chiama il metodo VideosClient.getCaptureOverlayIntent().
2. Se la chiamata va a buon fine, Google Play Services per i giochi restituisce un oggetto Task che carica 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 relativi alle registrazioni video

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