Grabación de video en los juegos de Android

Precaución: Esta guía se usa para usar la versión 1 del SDK de los Servicios de juego de Play. Para obtener información sobre el SDK más reciente, consulta la documentación de la versión 2 del Servicio de Play Juegos.

La API de grabación de video te permite agregar fácilmente la grabación de video a tu juego y permite que los usuarios compartan sus videos con amigos en YouTube en pocos pasos simples. Por ejemplo, puedes agregar un botón fuera de la pantalla de repetición de una batalla que, cuando se presione, aparecerá 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 mediante los Servicios de juego de Google Play. Se pueden encontrar las API 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:

• 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 jugador actual. Para obtener información sobre cómo recuperar la información de la cuenta del jugador, consulta Acceso en juegos para Android.

Nota: La clase VideosClient usa la clase Task de los Servicios de Google Play para mostrar resultados de forma asíncrona. A fin de obtener más información sobre el uso de tareas para administrar el trabajo de subprocesos, consulta la Guía para desarrolladores de la API de Tasks.

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 / detener grabación
  2. Activar o desactivar el micrófono
  3. Activa o desactiva la cámara frontal
  Nota: Si haces clic en la pantalla de la cámara orientada hacia delante de la superposición, aparecen los tres botones antes mencionados.

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

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

Lanzamiento de la superposición de grabación de video

Para iniciar la grabación de video del reproductor conectado, sigue estos pasos:

1. Llama al método VideosClient.getCaptureOverlayIntent().
2. Si la llamada se realiza correctamente, los Servicios de juego de Google Play muestran un objeto Task que carga 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.

Aquí te mostramos un ejemplo de cómo activar 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.

Sugerencia	Descripción
Haz que la grabación de video sea fácil de encontrar	Destaca un botón de grabación en el menú principal Activar automáticamente la superposición desde una opción del menú del modo de grabación dedicada y claramente etiquetada
Promueve el uso de la función en tu ficha de Play Store y dentro del juego	Usa una captura de pantalla en la ficha de Play Store que muestre la superposición de grabación de video Promociona la función de grabación de video mediante promociones dentro del juego. Considera ofrecer recompensas en el juego por compartir la repetición
Haz participar a tu comunidad de jugadores con las competencias de repetición	Motiva a los jugadores a grabar y compartir repeticiones del juego con competencias de reproducción semanales, mensuales o anuales Reconocer a los videos y creadores principales en el juego o a través de las redes sociales