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

A API Video Recording permite adicionar facilmente a gravação de vídeo ao seu jogo e deixar que os usuários compartilhem os vídeos com amigos no YouTube em algumas etapas simples. Por exemplo, você pode adicionar um botão fora de uma tela de repetição de batalha que, quando pressionado, mostra a experiência de gravação de vídeo do Google 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 de gravação de vídeo:

• Faça o download e analise o exemplo de código (em inglês).

• Familiarize-se com as recomendações descritas na Lista de verificação de qualidade.

Acessar o cliente de vídeos

Para começar a usar a API de gravação de vídeo, o jogo precisa ter um objeto VideosClient. Para fazer isso, chame o método Games.getVideosClient() e transmita a atividade e o GoogleSignInAccount para o player atual. Para saber como extrair as informações da conta do jogador, consulte Fazer login em jogos Android.

Noções básicas sobre a API Video Recording

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

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

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

  1. Iniciar / parar a 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 acionador de gravação alternativo

• Uma mensagem popover clicável que aparece no final da gravação e permite que os jogadores enviem o vídeo para o YouTube ou assistam o conteúdo no app Fotos. Observação: os vídeos gravados são armazenados na categoria ScreenCasts no app 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 exibir 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 de vídeo diretamente no jogo.