# Troca de câmeras

> Coloque cada corte de um podcast ou entrevista multicâmera na câmera de quem está falando, a partir de uma transcrição com falantes. O som nunca muda.

Source: https://nodaro.ai/pt-BR/docs/nodes/video/camera-switch

O nó **Troca de câmeras** escolhe qual câmera mostra cada corte de uma edição, de acordo com quem está falando. Ele lê uma edição do [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan) e uma transcrição com os falantes identificados, coloca cada trecho na câmera da pessoa que está falando e entrega a edição com as câmeras trocadas ao [**Aplicar EDL**](https://nodaro.ai/docs/nodes/video/apply-edl) para renderizar. O som nunca muda, e a mesma edição, transcrição e configuração sempre geram os mesmos cortes.

- Found in: Video › Cut & Assemble
- API type: `camera-switch`

O Troca de câmeras é executado no Nodaro Cloud. Em uma instalação auto-hospedada, [conecte a instalação ao Nodaro Cloud](https://nodaro.ai/docs/self-hosting/cloud-connect), em **Integrações › nodaro.ai** ou com uma chave de API, e o nó repassa cada execução para a nuvem. Sem conexão, o nó fica salvo no canvas, mas não pode ser executado.

## Quando usar
- Editar um podcast ou uma entrevista gravada com várias câmeras.
- Cortar para o close de cada pessoa enquanto ela fala e usar um plano geral nos momentos entre as falas.
- Fazer clipes curtos de um episódio multicâmera, cada um com trocas de câmera.
- Legendar uma edição multicâmera com os nomes reais dos falantes.

## Início rápido
Uma cadeia multicâmera típica tem cinco nós. O **Sincronizar áudio** alinha as gravações, o **Transcrever** identifica os falantes, o **Plano de edição** escreve a edição, o **Troca de câmeras** escolhe as câmeras e o **Aplicar EDL** renderiza o resultado.

### Preparar a edição e a transcrição
Conecte todas as gravações ao [**Sincronizar áudio**](https://nodaro.ai/docs/nodes/audio/audio-sync) e às **Origens** de um nó [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan), como descrito em [Gravações com várias câmeras](https://nodaro.ai/docs/nodes/video/edit-plan#multicam-recordings). Transcreva a gravação principal com um nó [**Transcrever**](https://nodaro.ai/docs/nodes/audio/transcribe), com **Identificação de falantes** ativada.

### Adicionar o nó
Pressione Tab no canvas e escolha **Vídeo › Corte e montagem › Troca de câmeras**.

### Conectar a edição e a transcrição
Conecte a saída EDL do Plano de edição à entrada **Edição (EDL)** e a transcrição do Transcrever à entrada **Transcrição**.

### Dar nome aos falantes e executar
Abra o painel de configurações. Em **Falantes**, dê a cada falante um nome e uma câmera. A tabela vem preenchida na ordem, então uma execução também funciona sem mudanças. Clique em **Executar**.

### Renderizar a edição com as câmeras trocadas
Conecte a saída **Edição com troca de câmeras (EDL)** a um nó [**Aplicar EDL**](https://nodaro.ai/docs/nodes/video/apply-edl) e execute-o. Para legendas com os nomes dos falantes, conecte a saída **Transcrição (com nomes)** à entrada **Transcrição** do Aplicar EDL ou do [**Adicionar legendas**](https://nodaro.ai/docs/nodes/video/add-captions).

Workflow: O Sincronizar áudio alinha as gravações, o Plano de edição escreve a edição, o Troca de câmeras coloca cada corte na câmera de quem fala e o Aplicar EDL renderiza o resultado.

- Sincronizar áudio → Plano de edição (Deslocamentos)
- Plano de edição → Troca de câmeras (EDL)
- Transcrever → Troca de câmeras (Transcrição)
- Troca de câmeras → Aplicar EDL (EDL)

O template **Multicam Cut** do marketplace de templates é essa cadeia, pronta para preencher: duas câmeras de close, uma câmera de plano geral e uma faixa de áudio principal. Adicione ou apague nós de câmera para ter de 2 a 6 gravações no total, e conecte cada uma ao nó Sincronizar áudio e às **Origens** do Plano de edição.

## Entradas
| Entrada | Obrigatória | O que conectar |
| --- | --- | --- |
| **Edição (EDL)** | Sim | Uma edição do [**Plano de edição**](https://nodaro.ai/docs/nodes/video/edit-plan), no modo **Enxugar** ou **Clipes**. No modo Clipes, cada clipe executa o Troca de câmeras separadamente. Um plano de capítulos é recusado. |
| **Transcrição** | Sim | A transcrição palavra por palavra com os falantes identificados, de um nó [**Transcrever**](https://nodaro.ai/docs/nodes/audio/transcribe) com **Identificação de falantes** ativada. |

## Saídas
| Saída | O que leva |
| --- | --- |
| **Edição com troca de câmeras (EDL)** | A edição com cada corte na câmera de quem fala. Conecte-a ao [**Aplicar EDL**](https://nodaro.ai/docs/nodes/video/apply-edl). Depois de um plano no modo Clipes, ela traz uma edição trocada por clipe, e a conexão dela fica em **Cada item** por padrão, então o Aplicar EDL renderiza todos os clipes. |
| **Transcrição (com nomes)** | A transcrição com os nomes que você deu aos falantes. Conecte-a à entrada **Transcrição** do Aplicar EDL ou do [**Adicionar legendas**](https://nodaro.ai/docs/nodes/video/add-captions) para que as legendas mostrem os nomes. Ela é a mesma para todos os clipes. |

## Como a troca funciona
- **A fala de um falante corta para a câmera dele** um pouco antes de ele começar, 0,2 segundo por padrão. A fala precisa durar pelo menos o **Plano mais curto (s)**, 2,5 segundos por padrão. Uma fala mais curta, como um “é” rápido, nunca causa um corte, e um “aham” de quem escuta não interrompe uma resposta longa.
- **Falantes e câmeras.** Vários falantes podem dividir uma câmera, por exemplo em um plano a dois. Um falante definido como **Sem câmera própria**, ou um falante depois da última câmera, aparece na câmera de plano geral: a origem com o papel **Plano geral** no Plano de edição. Sem câmera de plano geral, o falante aparece em qualquer câmera que o filmou.
- **Cada corte tem o nome do seu falante.** Quando o falante muda mas a câmera não, a edição é dividida ali mesmo assim. Nada muda na imagem, e cada parte leva o nome do próprio falante.
- **Uma câmera sem imagem.** Quando a câmera do falante começou tarde ou parou cedo, esse trecho mostra a câmera de plano geral, se ela tiver imagem, ou senão a primeira câmera que tiver. Um trecho que nenhuma câmera filmou sai da edição e entra na lista de cortes descartados como `no-picture`. Um intervalo de até meio segundo logo depois que uma câmera para fica congelado no último quadro.
- **Pausas no plano geral.** Com uma câmera de plano geral, a edição corta para ela depois de 20 segundos em uma câmera, por um plano mais curto, e depois volta. **Aberta a cada N cortes** manda cada N-ésimo corte para o plano geral.
- **O som fica.** Cada corte mantém o som que o trecho tinha na edição, normalmente a gravação principal. A trilha sonora nunca troca de microfone junto com a imagem.
- **Um falante, ou menos de 2 câmeras.** A edição volta sem mudanças, com um aviso nas notas da edição.

## Configurações
| Configuração | Padrão | O que faz |
| --- | --- | --- |
| **Falantes** | Preenchido na ordem | Uma linha por rótulo de falante da transcrição: um nome de exibição, de até 80 caracteres, e uma câmera ou **Sem câmera própria**. O falante 1 fica com a primeira câmera, o falante 2 com a segunda, e assim por diante. |
| **Plano mais curto (s)** | 2,5 | Uma fala mais curta que isso nunca causa um corte. De 0,5 a 60 segundos. |
| **Cortar antes (s)** | 0,2 | Quanto tempo antes de o novo falante começar o corte acontece. De 0 a 5 segundos. |
| **Pausa na aberta após (s)** | 20 | Com uma câmera de plano geral, corta para ela depois desse tempo em uma câmera. 0 desativa. Até 600 segundos. |
| **Aberta a cada N cortes** | 0 (desativado) | Com uma câmera de plano geral, cada N-ésimo corte vai para ela. De 0 a 20. |
| **Sugestões de layout** | Desativado | Quando duas pessoas falam ao mesmo tempo por mais de 1,2 segundo, sugere um layout lado a lado nesses cortes, ou empilhado em um vídeo vertical. |

Um valor fora da faixa vai para o limite mais próximo quando você sai do campo. A pausa no plano geral e **Aberta a cada N cortes** precisam de uma origem com o papel **Plano geral** no Plano de edição.

As **Sugestões de layout** só são desenhadas pelo [**Visão de falantes**](https://nodaro.ai/docs/nodes/video/speaker-view). O Aplicar EDL renderiza edições com cortes simples e recusa uma edição com sugestões de layout. Com as sugestões ativadas, o painel de configurações oferece trocar cada Aplicar EDL que recebe a edição por um nó Visão de falantes.

## Créditos
O Troca de câmeras tem um preço fixo por execução, qualquer que seja a duração da gravação ou o número de câmeras. O botão **Executar** do nó mostra o preço.

No modo **Clipes** do Plano de edição, o Troca de câmeras é executado uma vez por clipe, e cada execução é cobrada. Um plano com 8 clipes custa 8 execuções.

Estes casos são recusados antes de qualquer cobrança de créditos:

- Uma transcrição sem nenhum falante identificado.
- Falta a edição ou a transcrição.
- Uma edição que não é uma única edição no relógio da gravação: um conjunto inteiro de clipes, um plano de capítulos ou o EDL de uma saída renderizada.

## Dicas
- **Execute o Sincronizar áudio primeiro.** O Troca de câmeras precisa saber onde cada câmera está no relógio da gravação principal para mostrar o momento certo. Conecte o Sincronizar áudio à entrada **Deslocamentos (Sincronizar áudio)** do Plano de edição.
- **Marque o plano geral.** Dê à câmera de plano geral o papel **Plano geral** na lista de origens do Plano de edição. A câmera de plano geral vira a câmera reserva e o plano das pausas.
- **Use nomes reais.** Dê nome aos falantes no painel de configurações e conecte a saída **Transcrição (com nomes)** ao Adicionar legendas para legendar com esses nomes.

## Solução de problemas
| Problema | Causa e solução |
| --- | --- |
| A execução é recusada porque a transcrição não tem falantes. | A transcrição foi feita sem identificar os falantes. Ative **Identificação de falantes** no Transcrever, execute de novo e conecte a nova transcrição. |
| A edição volta sem mudanças. | A transcrição tem só um falante, ou a edição tem menos de 2 câmeras. As notas da edição dizem qual dos dois. |
| A edição é recusada. | A entrada não é uma única edição no relógio da gravação. Conecte a saída EDL do Plano de edição direto ao Troca de câmeras, e não o EDL de uma saída renderizada ou um plano de capítulos. |
| Os cortes mostram o momento errado. | As câmeras não estão alinhadas com a gravação principal. Meça os deslocamentos com o Sincronizar áudio, ou confira os deslocamentos digitados no Plano de edição. |
| A pausa no plano geral nunca acontece. | Nenhuma origem tem o papel **Plano geral** no Plano de edição, ou **Pausa na aberta após (s)** está em 0. |

## Pela API
`POST /v1/camera-switch` executa o nó por código. Envie `edl`, um EDL como objeto ou como string JSON, e `transcript`, com os opcionais `speakerMap`, `speakerNames`, `minShotMs`, `leadMs`, `maxShotMs`, `wideEvery` e `layoutHints`. `speakerMap` associa um rótulo de falante a um id de origem do EDL, e `""` significa sem câmera própria.

Um conjunto de clipes, um plano de capítulos ou o EDL de uma saída renderizada responde `400 invalid_edl`. Uma transcrição sem falantes identificados responde `422 no_speakers`, antes de qualquer cobrança. Na tarefa concluída, `output_data.json` é o EDL com as câmeras trocadas, e `output_data.transcript` é a transcrição com nomes.

O método do SDK é `client.edit.cameraSwitch`, o comando da CLI é `nodaro edit switch-cameras` e a ferramenta MCP é `switch_cameras`. Veja [Executar um único nó](https://nodaro.ai/docs/developers/api/nodes) e [Tarefas](https://nodaro.ai/docs/developers/api/jobs).

## Perguntas frequentes

### O que faz o nó Troca de câmeras?

O Troca de câmeras lê uma edição do Plano de edição e uma transcrição com os falantes identificados. Ele coloca cada trecho da edição na câmera da pessoa que está falando e retorna a edição com as câmeras trocadas para o Aplicar EDL renderizar.

### O Troca de câmeras muda o som?

Não. Cada corte mantém o som que o trecho já tinha na edição, normalmente a gravação principal. Só a imagem troca de câmera.

### Por que o Troca de câmeras recusa a minha transcrição?

A transcrição não tem os falantes identificados. Ative Identificação de falantes no nó Transcrever, execute de novo e conecte a nova transcrição ao Troca de câmeras. A recusa acontece antes de qualquer cobrança de créditos.

### Quanto custa o Troca de câmeras?

O Troca de câmeras tem um preço fixo por execução, qualquer que seja a duração da gravação ou o número de câmeras. O botão Executar mostra o preço. No modo Clipes do Plano de edição, o nó é executado uma vez por clipe, e cada execução é cobrada.

### Uma resposta curta como “é” causa um corte?

Não. A fala de um falante só causa um corte quando dura pelo menos o Plano mais curto, 2,5 segundos por padrão. Uma fala mais curta mantém a câmera atual na tela.