Communitygithub.com

android-launch-video

Produza um vídeo promocional de qualidade profissional para um app Android, gravado a 60 fps no emulador, junto com os ativos da Google Play. Use quando for solicitado um vídeo promocional para a Play Store, trailer de lançamento, vídeo para redes sociais (Reels, Shorts, TikTok), vídeo vertical 9:16, vídeo com ou sem narração por IA, capturas de tela da Play Store, graphic feature ou 'faça um vídeo do meu app Android'.

O que é android-launch-video?

Esta skill transforma a gravação real de um aplicativo Android rodando em um emulador a 60 qps em um vídeo promocional de nível profissional, pronto para a Google Play e para as redes sociais. Ela se baseia na skill **product-launch-motion** (de AbubakrChan, MIT), adaptando-a para o Android com indicadores de toque no lugar do cursor, captura real em 60 fps em vez de movimento reconstruído, superfícies opacas para elementos que flutuam sobre a tela, verificação de artefatos de chop vocal na música, narração verificada por reconhecimento de fala e conformidade com as regras da Play Store. A skill gera quatro vídeos mestres (16:9 e 9:16, com e sem narração), capturas de tela, graphic feature e imagens para redes sociais, seguindo um fluxo de produção com aprovações, storyboard e revisões. Ela é compatível com Windows (com GPU host) para captura, utiliza ffmpeg, Playwright, Gemini TTS e faster-whisper, e exige que a skill **product-launch-motion** esteja instalada previamente.

Funciona com✓Claude Code~Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/andrecuellar/android-launch-video/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeo de lançamento para Android

Um método e um kit de ferramentas para criar o vídeo promocional da Google Play (16:9), o corte vertical para redes sociais (9:16), cada um com e sem narração, e as imagens da loja, a partir do aplicativo real rodando em um emulador. O padrão é um filme de agência finalizado, não uma gravação de tela.

Esta skill adapta product-launch-motion (de AbubakrChan, MIT) para Android. Essa skill é um requisito e não está incluída: instale-a de https://github.com/AbubakrChan/product-launch-motion (testada no commit edbfb105) e leia, antes de escrever qualquer código de filme:

  • SKILL.md
  • references/technique.md
  • references/prompts.md
  • legacy/references/03-word-locked-sync.md
  • legacy/references/07-sound-and-master.md

O que muda para o Android: indicadores de toque no lugar do cursor, captura real em 60 fps em vez de movimento reconstruído, superfícies opacas para tudo que é levantado da tela, música verificada quanto a artefatos de chop vocal, narração verificada por reconhecimento de fala e as regras da Play Store.

As ferramentas estão em tools/ (índice em references/tools.md). Detalhes longos estão em references/; este arquivo é o método e as regras.

1. Entregas

PeçaEspecificação
Vídeo para Play / YouTube1920x1080, 60 fps, H.264, AAC 48 kHz, -14 LUFS integrados, pico verdadeiro <= -1 dBTP
Vídeo vertical para redes sociais1080x1920, mesmas especificações, composto independentemente (nunca um corte do 16:9)
Cada um com e sem narraçãoQuatro mestres. O corte narrado é feito separadamente e nunca substitui o corte apenas com música
Capturas de tela da PlayAté 8, 1080x1920, PNG 24 bits sem alfa (ou JPEG)
Graphic feature1024x500 sem alfa; mantenha o centro (aproximadamente x 362 a 662) livre: a Play coloca o botão de reprodução ali
Imagens para redes sociais1080x1920
Pré-visualizações14 MB no máximo cada, para exibi-las em um Artifact

Duração: cerca de 40 s, nunca mais de 50 s.

No formato 9:16, nada importante (texto, logotipo, botão) nas faixas que Reels, Shorts e TikTok cobrem com sua interface: os 14 % superiores, os 20 % inferiores e cerca de 120 px da borda direita.

2. Regras de produção (aprove-as, depois cumpra-as)

  • Produto finalizado. Julgue cada quadro como um filme de agência pago.
  • Movimento real. Tudo que se move dentro do telefone é o aplicativo gravado a 60 fps. Nenhum movimento é reconstruído a partir de capturas de tela animadas. Um clipe que gagueja é gravado novamente.
  • Sem cursor. O Android não tem mouse. Cada toque é marcado com um disco suave e a ondulação do Material, no local e no momento do toque real (a partir do registro de toques da captura).
  • Nenhum outro aplicativo na tela (aplicativos de mensagens, mapas, navegador, seletor de conta). Se o aplicativo nomeia outro aplicativo em um botão, a palavra pode ser lida; o outro aplicativo nunca aparece.
  • Nada flutua sem uma superfície. Qualquer coisa levantada da tela do telefone fica em sua própria superfície opaca: o próprio cartão ou o contêiner do aplicativo para aquela seção, com seu raio, cor e uma sombra suave. Nenhum texto repousa sobre o telefone, e nenhum texto se sobrepõe a outro.
  • Idêntico ao aplicativo. Um elemento levantado começa como um recorte exato do quadro visível e, no ar, cruza com um pequeno desfoque para uma réplica vetorial calibrada em relação a esse recorte. Nenhum emblema, ícone, botão ou dado inventado.
  • Nada que não esteja na marca ou no aplicativo. Nenhum glifo de reprodução no botão final, nenhum wipe de tela cheia, nenhuma caixa atrás de um texto para torná-lo legível: ajuste os tamanhos.
  • A marca abre e fecha, centralizada em seu eixo em ambos os formatos.
  • Movimento vivo. Traços longos que esticam, afinam e cruzam no ritmo são melhores do que blocos rígidos.
  • Dados verossímeis: valores de mercado reais para o domínio do aplicativo, nunca dados pessoais reais.
  • Cópia no idioma da listagem com diacríticos corretos, sem travessões.
  • O revisor aprova o roteiro, a música, a voz e a pronúncia da marca antes da produção, e não vê nada que não tenha sido verificado primeiro (seção 11).

3. Funções e aprovações

  • Diretor (a sessão principal): conversa com o revisor, lança subagentes, revisa e publica. Perguntas ao revisor passam por AskUserQuestion.
  • Subagente de análise: produto, marca, fluxos, ambiente local, dados de amostra, plano de gravação e roteiro. Ele não compila o aplicativo nem inicia o emulador.
  • Aprovações: storyboard em um Artifact (quadros-chave desenhados com Playwright e visualizados antes de mostrá-los), roteiro por compassos, música, escolha de voz, pronúncia da marca e permissão para girar o monitor durante a gravação.
  • Subagente de produção: compilação, emuladores, captura, filme, áudio, narração, renderização, imagens, verificações e entregas. Ele registra o progresso em PROGRESS.md no diretório de trabalho.
  • Fechamento: o diretor revisa e publica; as anotações do revisor voltam para a produção (SendMessage) até serem aprovadas.

4. Ambiente local e dados

  • Apenas emuladores locais. Antes de semear, verifique se todas as variáveis de host do emulador estão definidas: semear por meio de um SDK de administrador com uma variável ausente escreve na produção.
  • Dados verossímeis para o mercado-alvo: nomes, lugares, preços e fotos. Fotos com licença que permita uso comercial, fonte anotada, sem marcas de terceiros.
  • Localização: adb -s <serial> emu geo fix <longitude> <latitude>.
  • Compilação de release ou profile, sem sobreposições de depuração e apontada para os emuladores. Um patch que existe apenas para gravação (ocultar um banner de ambiente, pular uma espera) permanece não commitado e é revertido no final.
  • Telemetria (relatórios de falha, análise) desligada nessa compilação, ou comprovado que não atinge a produção.
  • Barra de status limpa com o modo de demonstração do SystemUI (tools/capture/demo.sh): 9:41, bateria cheia e wifi, sem notificações.
  • Escalas de animação do sistema em 1 durante a gravação; em 0, o aplicativo não se move como um telefone.
  • Backends compartilhados: se algo compartilhado (um banco de dados de staging) receber gravações, conte as linhas antes e depois. Uma API local com provedores simulados pode deixar dados inventados em um banco de dados compartilhado.

5. Captura real em 60 fps

screenrecord dentro do emulador não é suficiente: cerca de 41 fps em 1080x2400 (53 em 720x1600), e rolagens parecem entrecortadas. Use-o apenas para testes (tools/capture/clip.py). Opções:

  1. Host Windows + GPU (testado). Emulador no Windows com -gpu host, o monitor girado para retrato para que o telefone caiba em 1:1, ddagrab do ffmpeg (Desktop Duplication) a 60 fps cortado para a tela do telefone e girado, codificado quase sem perdas com hevc_amf (AMD; testado) ou h264_nvenc / hevc_nvenc (NVIDIA; não testado). tools/capture/capture.py (ClipGPU) grava, registra cada toque e deslize com o relógio do emulador e move o clipe para o WSL.
  2. Telefone físico com scrcpy (NÃO TESTADO). scrcpy --record na taxa de atualização do telefone; o registro de toques e a sincronização precisariam ser adaptados.
  3. Hosts macOS / Linux: não cobertos.

Em seguida, sync60.py alinha cada toque com a mudança visual que ele causa, measure2.py, stutter.py e jumps.py medem o resultado (a configuração testada deu 53 a 59 quadros únicos por segundo), e app_fps.sh informa se o próprio aplicativo renderiza a 60 dentro do emulador. Passo a passo, com as verificações do Windows (sessão desbloqueada, tempo limite da tela, memória livre): references/capture-60fps.md.

6. O filme

Escreva DIRECTION.md (cores e fontes da marca do tema do aplicativo, logotipo, conceito, roteiro por compassos, regras), depois PLAN.md, e só então code. Uma página HTML (film/index.html?f=16x9 ou ?f=9x16) onde tudo é uma função pura de seek(t): molas em forma fechada, sem transições CSS, sem temporizadores. tools/video/film/core.js é o mecanismo (molas, faixas, dígitos giratórios). Dentro de uma moldura de telefone vetorial genérica (sem marca do fabricante), apenas a gravação real é reproduzida, quadro a quadro a partir de seek(t), com os indicadores de toque desenhados a partir do registro de toques.

Renderize com Playwright: 4 subquadros por quadro, com média usando tmix do ffmpeg a 60 fps, em segmentos paralelos dimensionados para liberar memória. Rascunhos a 30 fps e meia escala. Folhas de contato por compasso e quadros individuais para revisão. Dígitos giratórios são verificados quadro a quadro: eles nunca devem mostrar lixo entre eles. Detalhe: references/film.md.

7. Música

  • Faixas do Mixkit sob a licença Mixkit (https://mixkit.co/license/); título e autor vão nos créditos. O diretor escolhe, o revisor ouve antes da edição. tools/music/ tem um catálogo (título, autor, gênero, duração, link) e uma análise de andamento/energia; nenhum áudio está incluído.
  • Grade de batidas própria (video/scripts/grid.py): andamento medido e fase da primeira batida. Os cortes caem na batida com crossfades de igual potência de cerca de 14 ms na depressão antes do ataque.
  • Verificação de chop vocal. Algumas faixas carregam batidas vocais picotadas que soam como palavras (às vezes rudes) para o ouvido. fingerprint.py e music_check.py comparam a impressão digital espectral da batida (40 bandas log de 250 Hz a 6 kHz, similaridade de cosseno) com cada batida da edição: nenhuma pode atingir 0,88. Esses compassos são mantidos fora e seus ecos são reduzidos.
  • Efeitos sonoros sintetizados, afinados na escala da faixa e colocados no pico medido (audio.py).
  • Mixagem ponto de partida: faixa x 0,5 + efeitos x 0,62, -14 LUFS, pico verdadeiro <= -1 dBTP. Detalhe: references/audio.md.

8. Narração

  • Gemini TTS, modelo gemini-3.8-flash-tts. A chave vem apenas da variável de ambiente GEMINI_API_KEY: nunca impressa, nunca na linha de comando, nunca em um repositório ou em um chat. tts.py a envia apenas em um cabeçalho e a remove dos erros.
  • Poucas gerações gratuitas por dia. Cada solicitação é registrada; um 429 é relatado e não repetido. Orce-as: uma pequena linha de teste por voz, depois o roteiro inteiro em uma solicitação por take.
  • Escolha: uma voz natural, calorosa, não robótica. Bons candidatos: Sulafat (calorosa), Laomedeia (viva), Leda (jovem).
  • Pronúncia da marca: pergunte ao revisor antes de gerar; ela vai nas notas do diretor do prompt ("pronuncia-se ..., como ..."), nunca na tela. faster-whisper large-v3 (transcribe.py) verifica com e sem uma dica. O modelo não está incluído: https://huggingface.co/Systran/faster-whisper-large-v3
  • Voz primeiro. Cada linha tem sua janela no filme e sua palavra-chave cai na mudança visual que ela nomeia (segment.py, place.py, timing_table.py, pace.py).
  • Mixagem narrada (narrated_mix.py): a música diminui sob cada linha para 9 a 12 dB abaixo da voz, com rampas. check_margin.py encontra onde a voz perde, audio_artifacts.py encontra cliques e cortes. Detalhe: references/narration.md.

9. Imagens da loja e metadados da Play

  • Capturas de tela: quadros limpos do filme 9:16 (store_shots.mjs, um único seek(t) por quadro, sem desfoque de movimento) ou telas reais com um título. 1080x1920, PNG de 24 bits sem alfa (png_srgb.py). A primeira declara a proposta de valor.
  • Graphic feature 1024x500: marca, uma linha e o telefone, centro mantido livre.
  • Imagens para redes sociais 1080x1920, respeitando as faixas seguras da seção 1.
  • Regras de metadados da Play, que também se aplicam ao vídeo: sem "#1", "melhor", prêmios, depoimentos, chamadas para baixar, ofertas datadas ou palavras-chave repetidas, e nada que o aplicativo não faça. Detalhe: references/store-assets.md.

10. Entrega

  • Artifact principal: as quatro pré-visualizações, as imagens, os textos da listagem e os créditos musicais.
  • Uma página de download por formato (capacidade downloads do Artifact). Os mestres são divididos em partes de 14 MB (tools/delivery/split.sh), remontados no navegador e verificados com SHA-256 antes de oferecer para salvá-los (tools/delivery/downloads/index.html, testado com tools/editor/test-downloads.mjs). Uma publicação envia até 64 MB: carregue as partes em vários lotes para a mesma URL.
  • Opcionalmente, copie os mestres para uma pasta do Windows (masters_dir_wsl na configuração).
  • Faça upload para a Play ou redes sociais apenas quando o revisor solicitar.

11. Antes de mostrar qualquer coisa

Observe você mesmo cada folha de contato, no tamanho real e no contexto, e execute as verificações de references/checks.md: filme (overlaps.mjs, purity.mjs, errors.mjs), renderização (jumps.py, stutter.py), áudio (-14 LUFS, pico verdadeiro, sem batida com formato vocal, voz completa de acordo com o Whisper) e a lista visual (sem cursor, sem outro aplicativo, sem banners de depuração, barra de status limpa, sem dados pessoais, sem texto cortado, sem erros ortográficos).

12. Cuidado com a máquina

Antes de cada lote pesado, verifique uptime, free -g e a memória livre do Windows. As renderizações são executadas dentro de um escopo com limite de memória, uma compilação Gradle por vez, temperaturas monitoradas em lotes longos (pausa acima de 85 C na CPU ou 80 C na GPU), Windows nunca abaixo de 2 GB livres. Nunca mate processos ou emuladores de outras sessões. Detalhe: references/checks.md, seção "Cuidado com a máquina".

13. Limpeza

Desligue o emulador do Android e quaisquer outros emuladores iniciados, restaure o monitor e o tempo limite de tela, reverta patches apenas para gravação e configuração temporária, esvazie a pasta de captura do Windows e diga claramente o que ainda está pendente.

Referências

  • references/capture-60fps.md: captura no host Windows, passo a passo.
  • references/film.md: contrato da página do filme, mecanismo, renderização, folhas de revisão.
  • references/audio.md: escolha de música, grade de batidas, verificação de chop vocal, efeitos, mixagem.
  • references/narration.md: Gemini TTS, escolha de voz, verificações do Whisper, posicionamento, mixagem narrada.
  • references/store-assets.md: capturas de tela, graphic feature, regras da Play.
  • references/checks.md: lista de verificação pré-revisão e cuidado com a máquina.
  • references/lessons.md: lições aprendidas, como regras.
  • references/tools.md: cada ferramenta, o que faz e como chamá-la.

Habilidades Relacionadas