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

Com a API de gravação de vídeos, você pode adicionar facilmente gravações 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 batalha que, quando pressionado, abriria a experiência de gravação de vídeo do Play Games.

Este guia mostra como implementar a gravação 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:

Como conseguir o cliente de vídeos

Para começar a usar a API de gravação de vídeo, primeiro seu jogo precisa ter um objeto VideosClient. Você pode fazer isso chamando o método Games.getVideosClient() e transmitindo a atividade e o GoogleSignInAccount para o jogador atual. Para saber como recuperar as informações da conta do jogador, consulte Fazer login no Android Games.

Princípios básicos da 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 gravação
    2. Ativar / desativar microfone
    3. Ativar / desativar câmera frontal

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

  • Um aviso clicável que aparece no final da gravação que permite aos jogadores fazer upload do vídeo no YouTube ou visualizá-lo no app Fotos. Observação: os vídeos gravados são armazenados na categoria ScreenCasts no 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.

Veja 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 de vídeo diretamente no seu jogo.

Dica Descrição
Facilite a detecção do acionador de gravação de vídeo
  • Colocar em destaque um botão de gravação no menu principal
  • Acionar a sobreposição automaticamente com a opção de menu de modo de gravação dedicada e claramente marcada
Promova o uso da funcionalidade na página "Detalhes do app" e no jogo
  • Usar uma captura de tela na página "Detalhes do app" que mostre a sobreposição de gravação de vídeo
  • Promova o recurso de gravação de vídeo com promoções no jogo
  • Considere oferecer recompensas no jogo para o compartilhamento de repetição
Envolva a comunidade de jogadores com a repetição de competições
  • Incentive os jogadores a gravar e compartilhar repetições do jogo com competições semanais / mensais / anuais
  • Reconhecer os principais vídeos e criadores de conteúdo no jogo ou nas mídias sociais