Registrazione video nei giochi Android

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 replay 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 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.