94 lines
4.2 KiB
Markdown
94 lines
4.2 KiB
Markdown
---
|
|
name: editar-por-voz
|
|
description: Edita um vídeo a partir da análise de voz — lê a timeline de voz (JSON) de uma gravação, separa o roteiro da conversa de bastidor, escolhe a melhor tomada de cada frase, decide cortes/zooms/textos e devolve a lista de decisões em JSON. Use quando o usuário pedir para editar por voz, montar um corte automático, limpar tomadas repetidas, escolher as melhores tomadas, ou marcar os momentos de ênfase de uma fala.
|
|
---
|
|
|
|
# Editar por voz
|
|
|
|
Você recebe um JSON com o que foi dito, por quem e **como**; devolve um JSON
|
|
com **o que fazer**. Quem aplica é o programa — você nunca escreve XML.
|
|
|
|
## Princípio
|
|
|
|
O sistema já mede *como* a pessoa falou, de forma reprodutível. Não
|
|
recalcule nada disso nem reestime tempos "no olho".
|
|
|
|
Seu trabalho é o que nenhum limiar resolve: **o que aquilo significa.** O
|
|
índice diz que uma palavra foi dita com força; só você sabe se ela é o
|
|
argumento central ou uma piada com o câmera.
|
|
|
|
## Entrada e saída
|
|
|
|
**Entrada:** `<mídia>_voice_timeline.json` (de `build_voice_timeline`). Se
|
|
não existir, rode a ferramenta; se existir, leia direto — a análise leva
|
|
minutos.
|
|
|
|
**Saída:** JSON com a lista de ações → `criterios/08-formato-de-saida.md`
|
|
|
|
`apply_voice_actions` aplica direto, mas é para **teste**. O produto do seu
|
|
trabalho é a lista de decisões.
|
|
|
|
## Ordem de trabalho
|
|
|
|
Siga nesta ordem. Pular a Fase 2 ou a 3 leva a decisões erradas.
|
|
|
|
| Fase | O que fazer | Critérios |
|
|
|---|---|---|
|
|
| **0** | Ler `layers` — saber o que rodou | `criterios/09-analise-incompleta.md` |
|
|
| **1** | Ler o JSON em camadas | `criterios/01-leitura-do-json.md` |
|
|
| **2** | Separar roteiro de conversa de bastidor | `criterios/02-triagem-roteiro-vs-conversa.md` |
|
|
| **3** | Escolher a melhor tomada de cada frase | `criterios/03-escolha-da-melhor-tomada.md` |
|
|
| **4** | **Reanalisar** o material que sobrou | `criterios/04-reanalise-do-material-restante.md` |
|
|
| **5** | Decidir zooms | `criterios/05-zoom.md` |
|
|
| **6** | Decidir textos, cortes e marcadores | `criterios/06-texto-corte-marcador.md` |
|
|
| **7** | Cortar a lista pelo ritmo | `criterios/07-ritmo.md` |
|
|
| **8** | Montar o JSON de saída | `criterios/08-formato-de-saida.md` |
|
|
|
|
## As três armadilhas
|
|
|
|
Cada uma já causou erro silencioso em material real:
|
|
|
|
1. **A conversa de bastidor tem a maior ênfase do vídeo.** O índice acústico
|
|
favorece a fala solta sobre o texto decorado. Separar é tarefa de texto,
|
|
nunca de limiar — e nem de diarização, já que costuma ser a mesma pessoa.
|
|
|
|
2. **Ênfase é relativa ao conjunto analisado.** Depois de cortar, os números
|
|
da análise bruta apontam para as palavras erradas. Sempre reanalise
|
|
(Fase 4) antes de escolher zooms.
|
|
|
|
3. **Tempos sempre na mídia original.** Nunca compense para "depois do
|
|
corte" — o programa faz isso sozinho, e compensar por conta própria joga
|
|
todo destaque no frame errado, sem erro visível.
|
|
|
|
## Ordem no sistema
|
|
|
|
Sua edição roda **primeiro, na timeline intacta**. Os posicionamentos (zoom,
|
|
texto, marcador) são deslocados a partir da *sua* lista de cortes; se outra
|
|
ferramenta já tiver rippado a timeline antes, esse deslocamento não sabe
|
|
disso e o efeito cai no frame errado — sem erro visível.
|
|
|
|
```
|
|
build_voice_timeline → [você decide] → refine_voice_timeline → [você corta
|
|
pelo ritmo] → apply_voice_actions → remove_media_silence →
|
|
generate_dynamic_subtitles
|
|
```
|
|
|
|
Vícios de linguagem e lacunas longas entram na **sua** lista, num ripple só
|
|
(`06-texto-corte-marcador.md`). Silêncio fino e legendas vêm depois.
|
|
|
|
`generate_dynamic_subtitles` nunca é o passo final por si só — sempre
|
|
seguido de `validate_subtitle_layout` antes de dar a legenda como pronta.
|
|
Detalhe do porquê e das regras específicas dessa etapa:
|
|
`code/Engine/docs/03_SERVER_TOOLS.md`, seção "Legendas dinâmicas".
|
|
|
|
## Ao relatar
|
|
|
|
Sempre em **português**, com o raciocínio e não só o resultado:
|
|
|
|
- quantas tomadas encontrou de cada frase e **qual escolheu, com o motivo**;
|
|
- o que descartou como bastidor;
|
|
- por que cada zoom caiu onde caiu (palavra + ênfase);
|
|
- **o que foi descartado ou rejeitado** — nunca relate só os acertos;
|
|
- o que você **não** conseguiu decidir. Em dúvida entre duas tomadas,
|
|
marque as duas e deixe para o editor.
|