Gravação de vídeo em jogos para Android

Após a descontinuação da API Login do Google, vamos remover o SDK dos serviços relacionados a jogos v1 em 2026. A partir de fevereiro de 2025, não será mais possível publicar no Google Play títulos que foram integrados ao SDK dos serviços relacionados a jogos do Google Play V1. Recomendamos que você use o SDK do Google Play Games v2.
Embora os títulos atuais com as integrações anteriores da v1 de jogos continuem funcionando por alguns anos, recomendamos que você migre para a v2 a partir de junho de 2025.
Este guia é para usar o SDK dos serviços relacionados a jogos do Google Play v1. A gravação de vídeo não é compatível com o SDK dos serviços relacionados a jogos do Google Play v2.

Com a API Video Recording, você pode adicionar facilmente a gravação de vídeo ao seu jogo e permitir que os usuários compartilhem vídeos com amigos no YouTube em algumas etapas simples. Por exemplo, você pode adicionar um botão fora da tela de repetição de uma batalha que, quando pressionado, abre a experiência de gravação de vídeo do Play Games.

Este guia mostra como implementar a gravação de vídeo em jogos usando os serviços relacionados a jogos do Google Play. As APIs podem ser encontradas nos pacotes com.google.android.gms.games.video e com.google.android.gms.games.

Antes de começar

Antes de começar a usar a API Video Recording:

Acessar o cliente de vídeos

Para começar a usar a API Video Recording, o jogo precisa ter um objeto VideosClient. Para isso, chame o método Games.getVideosClient() e transmita a atividade e o GoogleSignInAccount do player atual. Para saber como recuperar as informações da conta do jogador, consulte Login em jogos Android.

Noções básicas da API de gravação de vídeo

Você pode usar a API de gravação de vídeo para integrar uma experiência de gravação diretamente no jogo.

A experiência de gravação de vídeo para usuários inclui o seguinte:

  • A sobreposição de gravação de vídeo, que tem três botões:

    1. Iniciar / parar gravação
    2. Ativar / desativar o microfone
    3. Ativar / desativar a câmera frontal

  • Um botão fornecido pelo desenvolvedor para iniciar a gravação ou um gatilho alternativo de gravação

  • Um aviso clicável que aparece no final da gravação e permite que os jogadores façam upload do vídeo para o YouTube ou assistam o conteúdo pelo app Fotos. (Observação: os vídeos gravados são armazenados na categoria ScreenCasts do Fotos.)

Iniciar a sobreposição de gravação de vídeo

Para iniciar a gravação de vídeo do jogador conectado no momento, siga estas etapas:

  1. Chame o método VideosClient.getCaptureOverlayIntent().
  2. Se a chamada for bem-sucedida, os serviços relacionados a jogos do Google Play vão retornar um objeto Task que carrega de forma assíncrona uma intent para iniciar a sobreposição de gravação de vídeo.
  3. Use a intent da etapa anterior para iniciar uma atividade.

Confira um exemplo de como abrir a sobreposição de gravação de vídeo:

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);
        }
      });
}

Dicas para usar dados de gravação de vídeo

A API de gravação de vídeo permite integrar uma experiência de gravação diretamente no seu jogo.

Dica Descrição
Facilite a descoberta do gatilho de gravação de vídeo
  • Coloque um botão de gravação em destaque fora do menu principal
  • Ativar automaticamente a sobreposição em uma opção de menu de modo de gravação dedicada e claramente rotulada
Promova o uso do recurso na página "Detalhes do app" e dentro do jogo.
  • Use uma captura de tela na página "Detalhes do app" que mostre a sobreposição da gravação de vídeo
  • Promova o recurso de gravação de vídeo com promoções no jogo
  • Considere oferecer recompensas no jogo por compartilhar replays
Incentive a comunidade de jogadores com competições de replays
  • Incentive os jogadores a gravar e compartilhar replays de jogos com competições semanais, mensais ou anuais.
  • Reconhecer os melhores vídeos e criadores de conteúdo no jogo ou nas redes sociais