Gravação de Vídeo do Navegador
Modelo de Dependência
Separe o fluxo de trabalho em três camadas:
- Controle do navegador e quadros de origem: Use o navegador Codex in-app através do skill/MCP de Navegador. Não use o Chrome quando o usuário solicitar o navegador Codex ou quando o projeto especificar que não deve usar. A camada do navegador fornece screenshots reais e estados reais de clique/rolagem/navegação.
- Renderizador de vídeo local: Use o script Python empacotado para renderizar screenshots em um MP4 com cursor macOS natural, escala sutil de clique e enquadramento calmo com zoom automático. Isso não requer um MCP de gravação de tela.
- Integração opcional de gravador nativo: Use um MCP de gravação nativa apenas quando puder ser chamado e for explicitamente útil para iniciar/parar uma gravação real do aplicativo ou abrir um projeto gerado. Se estiver indisponível, bloqueado ou incapaz de capturar a superfície do navegador Codex, recorra ao renderizador de screenshots para vídeo e explique a mudança.
Execução Autocontida
Este skill é suficiente para que outra instância do Codex realize a renderização Python, desde que a pasta completa do skill esteja instalada, incluindo scripts/render_browser_demo.py. O Codex deve executar o script empacotado em vez de recriar o renderizador.
Ferramentas locais necessárias:
python3- Pacote Python
Pillow ffmpegeffprobe
A extração opcional do cursor macOS usa swift e /usr/sbin/screencapture. Se esses não estiverem disponíveis, forneça um PNG transparente através de cursor_asset e defina cursor_hotspot na configuração.
O skill/MCP de Navegador ainda é necessário para screenshots frescos do navegador Codex in-app. Se não estiver disponível, use a melhor fonte disponível de automação de navegador para screenshots e informe a mudança.
Suporte Opcional para Gravador Nativo
Para gravação nativa de aplicativos, verifique se o MCP suporta:
- Usar
frameRate: 60. - Usar
resolutionRawValue: "4K". - Usar
ratioPresetRawValue: "4:3"para gravações de região. - Usar um
selectedRegionOnScreenexplícito ao cortar para a viewport do navegador incorporado.
Para o renderizador local, 4K 4:3 significa 3840x2880. Se um gravador nativo expor um enum 4K, trate-o como um preset de resolução do lado do aplicativo e combine-o com a seleção de região 4:3 ao fazer a gravação através desse MCP.
Fluxo de Captura
Use browser:control-in-app-browser primeiro. Após carregar sua documentação, controle o navegador in-app com a API Node/navegador:
- Defina a viewport para
1920x1440para saída 4:3 4K e, em seguida, redefina-a antes de finalizar. - Navegue até a página solicitada e execute cliques reais, voltas, pesquisas e rolagens.
- Salve screenshots apenas do navegador após cada mudança importante de estado. Use nomes como
01-resultados-topo.png,02-apos-clique-card.png,03-voltar-resultados.png. - Registre as coordenadas da viewport de cada destino de clique/rolagem. O caminho final do cursor deve pousar nesses pontos, pausar, clicar e, em seguida, mover para o próximo ponto relevante.
Evite automação de coordenadas do desktop, a menos que o usuário solicite explicitamente a interface do sistema. A visibilidade do navegador Codex pode não expor uma superfície macOS capturável; as screenshots da API do navegador são a fonte confiável.
Regras de Movimento
Faça o cursor parecer intencional:
- Use caminhos de cursor esparsos e principalmente retos.
- Faça uma pausa breve no alvo antes de clicar.
- Não vagar sobre elementos de interface não relacionados.
- Deixe a transição da página acontecer após o clique, não antes.
- Use apenas feedback sutil de clique: queda/ressalto de escala, nenhum anel decorativo, a menos que solicitado.
- Mantenha o zoom automático mais calmo que o cursor. A câmera deve enquadrar o conteúdo clicado, não perseguir cada pequeno movimento do mouse.
Alvo visual padrão:
- Ponteiro macOS real extraído do compositor, ou um asset de cursor transparente existente.
- Escala do cursor
3.0, correspondendo ao estilo de cursor grande comumente usado em gravações de demonstração editadas. - Força da animação de clique
15para uma leve queda de escala. - Força de rotação de até
8deg, somente a partir da velocidade horizontal.
Script de Renderização
Use scripts/render_browser_demo.py para saída determinística a 60 fps 4:3 4K:
python3 /caminho/para/gravacao-video-navegador/scripts/render_browser_demo.py \
--config /tmp/config-demo-navegador.json \
--output /tmp/demo-navegador-4x3-4k-60fps.mp4
Gere uma configuração inicial:
python3 /caminho/para/gravacao-video-navegador/scripts/render_browser_demo.py --write-template
A configuração fornece:
shots: mapa de nomes de estado para caminhos de PNG de screenshot.scene_starts: entradas[tempo, nomeShot, transicao].cursor_keys: entradas[tempo, x, y]de coordenadas da viewport.camera_keys: entradas[tempo, x, y, zoom].click_times: timestamps de clique.duration,fps,output_size,source_size,cursor_scale.
Padrões preferenciais:
{
"fps": 60,
"output_size": [3840, 2880],
"source_size": [1920, 1440]
}
Se cursor_asset for omitido, o script exibe brevemente uma sobreposição de cor sólida e usa screencapture para extrair o cursor macOS real atual em um PNG transparente. Isso é suporte de renderização local, não uma dependência de MCP.
Verificação
Sempre verifique o vídeo entregue:
ffprobe -v error \
-show_entries stream=codec_name,width,height,r_frame_rate \
-show_entries format=duration,size \
-of json /caminho/para/saida.mp4
Extraia pelo menos um thumbnail no meio do vídeo e inspecione:
ffmpeg -y -ss 8 -i /caminho/para/saida.mp4 -frames:v 1 -update 1 /tmp/thumbnail-demo-navegador.png
Confirme:
- A resolução é a solicitada, geralmente
3840x2880para 4:3 4K. - A taxa de quadros é
60/1ou equivalente. - A duração corresponde à solicitação.
- O cursor está visível, natural e no alvo.
- O vídeo está cortado para o conteúdo do navegador, não para o desktop.
- A substituição da viewport do navegador foi redefinida.