Grabación de video en juegos para Android

Después de la baja de la API de Acceso a Google, quitaremos el SDK de juegos v1 en 2026. Después de febrero de 2025, no podrás publicar títulos que se hayan integrado recientemente con el SDK de juegos v1 en Google Play. Te recomendamos que uses el SDK de juegos v2.
Si bien los títulos existentes con las integraciones de la versión 1 de los juegos anteriores seguirán funcionando durante un par de años, te recomendamos que migres a la versión 2 a partir de junio de 2025.
Esta guía se aplica al uso del SDK de la versión 1 de los Servicios de juego de Play. La grabación de video no es compatible con el SDK de la versión 2 de los Servicios de juego de Play.

La API de grabación de video te permite agregar fácilmente la grabación de video a tu juego y permitir que los usuarios compartan sus videos con amigos en YouTube en unos pocos pasos simples. 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.

Nota: La clase VideosClient usa la clase Task de los Servicios de Google Play para mostrar resultados de forma asíncrona. Si quieres 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 o detener la grabación
  2. Activar o desactivar el micrófono
  3. Activar o desactivar la cámara frontal
  Nota: Si haces clic en la pantalla de la cámara frontal de la superposición, aparecerán los tres botones mencionados anteriormente.

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

Sugerencia	Descripción
Haz que el activador de grabación de video sea fácil de detectar	Coloca un botón de grabación de forma destacada en el menú principal Activar automáticamente la superposición desde una opción de menú del modo de grabación dedicada y claramente etiquetada
Promociona el uso de la función en la ficha de Play Store y dentro del juego	Usa una captura de pantalla en tu ficha de Play Store que muestre la superposición de grabación de video. Promociona la función de grabación de video con promociones en el juego Considera proporcionar recompensas en el juego por compartir repeticiones
Capta la atención de tu comunidad de jugadores con competiciones de repetición	Anima a los jugadores a grabar y compartir las repeticiones de los partidos con competiciones semanales, mensuales o anuales Reconocer los videos y creadores más populares en el juego o a través de las redes sociales