Grabación de video en juegos para Android

La API de grabación de video te permite agregar fácilmente grabaciones de video a tu juego y permitir que los usuarios compartan sus videos con amigos en YouTube en unos simples pasos. Por ejemplo, puedes agregar un botón a una pantalla de repetición de batalla que, cuando se presione, muestre la experiencia de grabación de video de Play Juegos.

En esta guía, se muestra cómo implementar la grabación de video en juegos con los Servicios de juego de Google Play. Se pueden encontrar las APIs en los paquetes com.google.android.gms.games.video y com.google.android.gms.games.

Antes de comenzar

Antes de comenzar a usar la API de grabación de video, haz lo siguiente:

• Descarga y revisa la muestra de código.

• Familiarízate con las recomendaciones que se describen en la lista de tareas de calidad.

Cómo obtener el cliente de videos

Para comenzar a usar la API de grabación de video, el juego primero debe obtener un objeto VideosClient. Para ello, llama al método Games.getVideosClient() y pasa la actividad y el GoogleSignInAccount del reproductor actual. Si quieres saber cómo recuperar la información de la cuenta del jugador, consulta Información sobre el acceso a juegos para Android.

Conceptos básicos de la API de grabación de video

Puedes usar la API de grabación de video para integrar una experiencia de grabación de video directamente desde tu juego.

La experiencia de grabación de video para los usuarios incluye lo siguiente:

• La superposición de grabación de video, que tiene tres botones:

  1. Iniciar o detener la grabación
  2. Activar o desactivar el micrófono
  3. Activar o desactivar la cámara frontal

• Un botón proporcionado por el desarrollador para iniciar la grabación o un activador de grabación alternativo

• Un aviso emergente en el que se puede hacer clic que aparece al final de la grabación y que permite a los usuarios subir el video a YouTube o verlo a través de la app de Fotos (Nota: Los videos grabados se almacenan en la categoría ScreenCasts en Fotos)

Cómo iniciar la superposición de grabación de video

Para iniciar la grabación de video del jugador que está conectado actualmente, sigue estos pasos:

1. Llama al método VideosClient.getCaptureOverlayIntent().
2. Si la llamada se realiza correctamente, los Servicios de juego de Google Play mostrarán un objeto Task que cargará de forma asíncrona un intent para iniciar la superposición de grabación de video.
3. Usa el intent del paso anterior para iniciar una actividad.

Este es un ejemplo de cómo mostrar la superposición de grabación de 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);
        }
      });
}

Sugerencias para usar los datos de grabación de video

La API de grabación de video te permite integrar una experiencia de grabación de video directamente en tu juego.