---
description: "Transforme uma webcam numa instalação interativa com o tdmcp — o movimento diante da câmera gera rastros de partículas brilhantes que você toca ao vivo e projeta."
level: intermediate
---

<script setup>
import { withBase } from "vitepress";
</script>

# Uma instalação interativa por câmera <Badge type="info" text="Intermediário" />

**Objetivo** — montar uma instalação com webcam em que o movimento de quem assiste
gera rastros de partículas brilhantes, prontos para projetar numa parede.

**O que você vai ver** — um campo escuro e atmosférico de partículas que se acendem
e deixam rastros onde há movimento diante da câmera. Fique parado e ele se acalma;
mexa-se e a sala se pinta sozinha.

<video :src="withBase('/examples/tutorial-camera-interactive-installation.mp4')" autoplay loop muted playsinline style="width:100%;max-width:480px;border-radius:8px;display:block"></video>

*O campo de partículas por fluxo óptico dirigido por um clipe de teste em movimento — com
a sua webcam, as partículas se agitam onde as pessoas se mexem. Capturado ao vivo da
própria saída da recipe.*

**Antes de começar**

- [tdmcp instalado](/pt/guide/install) para o seu cliente de IA.
- A [etapa da ponte do TouchDesigner](/pt/guide/install) concluída, com
  `bridge running` no Textport do TouchDesigner.
- Uma webcam. Sem webcam à mão? Todos os prompts abaixo podem usar uma **fonte de
  teste sintética**, para você montar e ensaiar todo o visual offline.

::: tip Kinect não é necessário
Isto usa uma webcam comum e fluxo óptico (detecção de movimento). Para câmeras de
profundidade e corpo inteiro, veja [Adaptadores MediaPipe](/pt/guide/mediapipe-adapters)
e [Instalações físicas](/pt/guide/physical-installations).
:::

## Passos

Copie cada prompt para o seu cliente de IA, um por vez. Espere cada um terminar
antes de enviar o próximo.

1. Confirme que o TouchDesigner está conectado e veja sua webcam:

   ```text
   Verifique se o TouchDesigner está conectado e me mostre a fonte da minha webcam. Se não houver câmera disponível, use uma fonte de teste sintética.
   ```

   → A IA confirma que a ponte está ativa e traz a imagem da câmera (ou de teste).

2. Monte a base reativa ao movimento a partir da receita:

   ```text
   Aplique a receita optical_flow_particles, alimentada pela minha webcam. Use o clipe de teste incluído se a minha câmera não estiver pronta.
   ```

   → Você recebe uma rede que lê o movimento da câmera como um campo de fluxo óptico
   e o injeta direto no render de partículas — o movimento diante da câmera já agita
   as partículas de imediato.

3. Deixe a reação mais forte e com mais deriva:

   ```text
   Faça as partículas reagirem mais ao movimento e derivarem depois de agitadas, para que o movimento diante da câmera realmente as pinte.
   ```

   → As partículas respondem com mais força ao movimento e continuam derivando depois
   de empurradas, deixando o campo vivo em vez de voltar ao lugar.

4. Defina a atmosfera da instalação:

   ```text
   Adicione rastros às partículas e dê um clima escuro e atmosférico — azuis profundos e violeta sobre quase-preto.
   ```

   → As partículas deixam rastros brilhantes e a cena vira uma peça de galeria, não
   uma demo técnica.

5. Exponha os dois controles que você realmente vai tocar:

   ```text
   Exponha um controle de sensibilidade do fluxo (Flow-sensitivity) e um de comprimento do rastro (Trail-length) para eu ajustar o quão reativo e o quão esfumado fica.
   ```

   → Aparecem dois knobs ao vivo. Flow-sensitivity define com que facilidade o
   movimento dispara partículas; Trail-length define quanto tempo os rastros duram.

6. Faça o preview e coloque em tela cheia para a instalação:

   ```text
   Me mostre uma prévia. Depois me diga como enviar esta saída em tela cheia para o meu projetor ou segundo display para a instalação.
   ```

   → Você vê o resultado, mais os passos para levar a saída ao projetor.

## Resultado esperado

Uma rede da esquerda para a direita: **câmera → campo de fluxo óptico → render de
partículas → saída**, com um preview mostrando partículas escuras que se acendem em
rastros brilhantes onde alguém se move. Flow-sensitivity e Trail-length ficam
expostos como knobs ao vivo. Enviar a saída em tela cheia transforma qualquer parede
na peça.

## Se algo der errado

- **Webcam não encontrada / imagem preta** → peça uma fonte de teste sintética e
  troque pela câmera depois. No macOS, conceda acesso à câmera — veja a
  [nota de permissão de câmera](/pt/guide/troubleshooting#macos-microphone-camera-permission).
- **Ruído demais — partículas disparando o tempo todo** → reduza a Flow-sensitivity,
  ou diga *"reaja só a movimentos maiores."*
- **Nada reage** → aumente a Flow-sensitivity e garanta luz suficiente e movimento
  real no enquadramento.
- **Projetor / tela cheia** → veja
  [Instalações físicas](/pt/guide/physical-installations) para fluxos confiáveis de
  projetor, calibração e sensores de sala.
- **Ainda travado?** → [Solução de problemas](/pt/guide/troubleshooting) e o
  [FAQ](/pt/guide/faq).