NEOiD · Companion · Manual do Usuário

Manual do Usuário — Câmeras PTZ NEOiD no Companion

Como operar a sua câmera PTZ NEOiD pelo Companion e Stream Deck · módulo neoid-ptz v1.6.5 · Agosto de 2026

01 O básico em uma página

A sua câmera PTZ NEOiD é controlada por um software gratuito chamado Bitfocus Companion, que transforma um painel de botões físico (como o Elgato Stream Deck) ou uma página no navegador em uma mesa de controle da câmera. Cada botão envia um comando pela rede; a câmera responde na hora.

Você não precisa entender de rede ou protocolo: isso é feito uma única vez pelo instalador (seção 12). O trabalho do operador se resume a três gestos:

Tocar — a maioria dos botões age com um toque simples (ir para uma posição, ligar uma função).
Segurar — botões de movimento contínuo (setas, ZOOM) agem enquanto o dedo está no botão.
Segurar para confirmar — pouquíssimos botões perigosos (apagar posições) exigem segurar até o botão ficar âmbar, para impedir toque acidental.

As posições de câmera (presets) ficam gravadas na própria câmera. O módulo NEOiD já vem com páginas prontas para quatro cenários — Culto, Plenária, Entrevista e Esporte — cada uma com as posições, velocidades e ajustes de imagem certos para aquele ambiente.

02 A convenção de cores

Todos os botões do módulo seguem um código de cores fixo. Aprenda as sete cores uma vez e qualquer página se torna legível de relance:

Cor	Significado
Azul	Ir para uma posição gravada (preset). Toque simples e a câmera se move.
Azul claro	Variação da posição principal — enquadramentos do mesmo grupo.
Verde	Enquadramento SEGURO: sempre pode ir ao ar. Na dúvida, aperte o verde.
Vermelho	Emergência: STOP congela todo movimento imediatamente. (Também marca ações destrutivas na página técnica.)
Âmbar	Função LIGADA. O botão de uma função acesa fica âmbar sozinho.
Cinza escuro	Função desligada (toque para ligar/desligar) ou indicador de estado.
Roxo	Ação momentânea: vale enquanto você segura, ou dispara um ajuste único (foco, steppers).
Cinza	Configuração e status: aplicar setup do cenário, salvar posição, mostradores de valores.

Atenção

Os botões âmbar merecem atenção: âmbar significa que a função está ATIVA agora. Se um botão que você não reconhece estiver âmbar, pergunte antes de tocar — desligar TRACK ou FREEZE no ar tem efeito imediato na imagem.

03 Cenário: Culto

A página Culto foi desenhada para o voluntário: nomes em português, poucas decisões, e um caminho seguro para qualquer momento do culto. Toque em um azul para enquadrar; o verde CONGREG. é o seu porto seguro.

Botões cinza de status exibem valores ao vivo da câmera; nas imagens aparecem como —.

Botão	O que faz
PREGADOR	Enquadra o pregador (posição principal).
PÚLPITO	Enquadra o púlpito.
PREG. CLOSE	Close no pregador.
LOUVOR WIDE	Plano aberto do louvor.
VOCAL	Enquadra o vocal.
BANDA	Enquadra a banda.
CONGREG.	Plano geral da congregação — enquadramento seguro, sempre pode ir ao ar.
CEIA BATISMO	Posição para ceia e batismo.
HOME	Volta a câmera à posição inicial — segure 0,5 s até confirmar (âmbar).
TRACK PREGADOR	Liga/desliga o rastreamento automático do pregador (âmbar = ligado).
AUTO ZOOM	Com o TRACK ligado, deixa a câmera abrir/fechar o zoom sozinha para manter o plano (âmbar = ligado).
CLOSE PREGADOR	Fecha o enquadramento do tracking no pregador (plano mais fechado).
FOCO 1x	Ajusta o foco uma vez e trava.
WB PUSH	Recalibra a cor (white balance) com um toque e mostra a temperatura atual no próprio botão.
SAFE CEIA	Transição segura para a ceia: congela a imagem, reposiciona, refoca e descongela — o ar nunca vê o movimento.
PRESET	Indicador do último preset chamado (só mostra, não age).
STOP	EMERGÊNCIA: para todo movimento da câmera imediatamente.
SETUP CULTO	Aplica de uma vez todos os ajustes de imagem do culto. Use antes de começar.

Fluxo de uma transmissão típica

Antes de começar, toque SETUP CULTO uma vez.
Com o povo chegando, deixe CONGREG. (verde) no ar.
Na abertura e avisos, PÚLPITO; no louvor, LOUVOR WIDE com closes de VOCAL e BANDA.
Na pregação, toque PREGADOR e ligue TRACK PREGADOR — a câmera segue sozinha; AUTO ZOOM mantém o plano e CLOSE PREGADOR fecha o quadro.
Para a ceia com a câmera no ar, use SAFE CEIA (congela, move, refoca, descongela); fora do ar, CEIA BATISMO direto.
Cor puxando amarelo ou azul? WB PUSH. Movimento estranho? STOP e depois um azul para recuperar.

A página de velocidade do Culto usa 5 níveis nomeados (de MUITO LENTO a MUITO RÁPIDO): cada toque em PAN +/− muda um nível, sem números técnicos. O botão PADRÃO devolve tudo ao normal.

Velocidade do Culto: níveis nomeados, um toque por nível.

04 Cenário: Plenária

Página para câmaras municipais e assembleias: posições institucionais fixas, rastreamento na tribuna e blindagem contra controles remotos IR da sala.

Botões cinza de status exibem valores ao vivo da câmera; nas imagens aparecem como —.

Botão	O que faz
MESA	Enquadra a mesa diretora.
PRESID.	Enquadra a presidência.
TRIBUNA	Enquadra a tribuna.
ORADOR	Orador em aparte.
BANC. 1 / BANC. 2	Bancadas 1 e 2.
VOTAÇÃO	Painel de votação.
PLANO GERAL	Plano geral do plenário — enquadramento seguro.
AF LOCK	Ajusta o foco uma vez e trava.
TRACK TRIBUNA	Rastreia automaticamente quem está na tribuna (âmbar = ligado).
AUTO TILT	Com o TRACK ligado, deixa a câmera inclinar sozinha para manter o enquadramento vertical (âmbar = ligado).
PLANO PA	Enquadra em Plano Americano (da cintura para cima) quando o tracking está ativo na tribuna.
WB PUSH	Recalibra a cor (white balance) com um toque e mostra a temperatura atual no próprio botão.
REPOSIC BANC.	Vai para a bancada sem mostrar o movimento: congela, recompõe o quadro e descongela.
IR OFF	Desliga o receptor de controle remoto da câmera (evita interferência na sessão).
TALLY	Indicador do tally: vermelho = no ar (PGM), verde = preparada (PVW). Só mostra, não age.
PRESET	Indicador do último preset chamado (só mostra, não age).
STOP	EMERGÊNCIA: para todo movimento imediatamente.
SETUP PLENÁRIA	Aplica todos os ajustes de imagem da sessão. Use antes de abrir os trabalhos.

Fluxo de uma transmissão típica

Antes da sessão, toque SETUP PLENÁRIA e depois IR OFF.
Sessão fechada? Deixe PLANO GERAL (verde) no ar.
Na abertura, MESA e PRESID. conforme fala a presidência.
Discursos: TRIBUNA e ligue TRACK TRIBUNA (com AUTO TILT e PLANO PA); apartes com ORADOR.
Votação: VOTAÇÃO para o painel; para reações, REPOSIC BANC. leva à bancada sem o ar ver o movimento.
Emergência: STOP, depois PLANO GERAL.

05 Cenário: Entrevista / Jornalismo

Página de estúdio: enquadramentos clássicos de bancada e um recurso exclusivo — a transição segura, que congela a imagem no ar enquanto a câmera se reposiciona.

Página ao vivo — Cenário: Entrevista / Jornalismo.

Botões cinza de status exibem valores ao vivo da câmera; nas imagens aparecem como —.

Botão	O que faz
2-SHOT MESA	Âncora + convidado juntos (posição principal).
HOST ÂNCORA	Close no âncora.
GUEST 1 / GUEST 2 / GUEST 3	Close em cada convidado (três posições).
WIDE ESTÚDIO	Plano aberto do estúdio — enquadramento seguro.
CUTAWAY REACTION	Plano de reação.
OTS HOST	Over-the-shoulder do âncora.
INSERT DETALHE	Detalhe (mãos, objeto, telão).
SAFE →HOST	TRANSIÇÃO SEGURA para o âncora: congela a imagem, muda a posição, refoca e descongela — o ar nunca vê o movimento.
AF PUSH	Ajusta o foco uma vez e trava.
FREEZE	Congela/descongela a imagem manualmente (âmbar = congelada).
TRACK	Rastreamento pontual do apresentador (âmbar = ligado).
AUTO FRAME	Enquadramento automático: a câmera escolhe o corte conforme quem fala (âmbar = ligado).
TALLY / PRESET	Indicadores: cor do tally e último preset chamado (só mostram, não agem).
WB PUSH	Recalibra a cor (white balance) com um toque e mostra a temperatura atual no próprio botão.
STOP	EMERGÊNCIA: para todo movimento imediatamente.
SETUP ENTREVISTA	Aplica os ajustes do estúdio (inclui calibração de cor). Use antes de gravar.

Fluxo de uma transmissão típica

Antes de gravar, toque SETUP ENTREVISTA.
Abertura no WIDE ESTÚDIO ou 2-SHOT MESA.
Siga a conversa: HOST ÂNCORA, GUEST 1, GUEST 2, GUEST 3 — ou ligue AUTO FRAME para a câmera cortar sozinha.
Para mudar de posição COM a câmera no ar, use SAFE →HOST — nunca o preset direto.
Imagem com cor estranha? WB PUSH. Foco mole? AF PUSH.
Emergência: STOP, depois WIDE ESTÚDIO.

06 Cenário: Esporte

Página para quadra e campo: posições de jogo, rastreamento com sensibilidade alta e FREEZE para segurar a imagem em paradas.

Botões cinza de status exibem valores ao vivo da câmera; nas imagens aparecem como —.

Botão	O que faz
WIDE COURT	Quadra inteira — enquadramento seguro.
CENTER	Centro de quadra (posição principal do jogo).
GOAL L / GOAL R	Gol/cesta esquerda e direita.
BENCH A / BENCH B	Bancos das equipes.
SCORE PLACAR	Placar.
CROWD TORCIDA	Torcida.
AF PUSH	Ajusta o foco uma vez e trava.
TRACK	Rastreamento automático do jogo (âmbar = ligado).
FREEZE	Congela a imagem (intervalos, paradas técnicas).
AUTO ZOOM	Com o TRACK ligado, deixa a câmera abrir/fechar o zoom sozinha para acompanhar o lance (âmbar = ligado).
PLANO GERAL	Abre o enquadramento do tracking para o plano geral da quadra.
REPOSIC	Muda de enquadramento sem mostrar o movimento: congela, recompõe o quadro e descongela.
RESET SPD	Devolve a velocidade de movimento ao perfil normal.
STOP	EMERGÊNCIA: para todo movimento imediatamente.
SETUP ESPORTE	Aplica os ajustes de jogo (movimento rápido). Use antes da partida.

Fluxo de uma transmissão típica

Antes da partida, toque SETUP ESPORTE.
Aquecimento e intervalos: WIDE COURT (verde) ou CROWD TORCIDA.
Bola rolando: CENTER; ligue TRACK (com AUTO ZOOM) para a câmera acompanhar o jogo.
Lances de gol: GOAL L / GOAL R; para trocar sem o ar ver o movimento, REPOSIC.
Parada técnica: FREEZE, mostre SCORE PLACAR ou BENCH A/B, descongele.
Movimento rápido demais? RESET SPD. Emergência: STOP, depois WIDE COURT.

07 Luz e exposição sem sofrimento

Exposição é o quanto de luz a câmera deixa entrar. Na maior parte do tempo você não mexe nisso: o SETUP do cenário já deixa a câmera no automático certo. Quando a luz do ambiente muda de verdade, use as cenas de 1 toque:

Cenas de exposição: um toque resolve a situação de luz.

Botão	O que faz
CENA ESCURO	Ambiente escuro (culto à meia-luz, ginásio fraco): abre a entrada de luz.
CENA CLARO	Palco muito iluminado: fecha a entrada de luz para não estourar o branco.
CENA CONTRA	Contraluz (janela/telão atrás): compensa para o rosto não ficar escuro.
CENA AUTO	Volta TUDO para o automático de fábrica. É o botão de pânico da imagem (verde = seguro).

O botão EXP LOCK congela a exposição atual: a imagem para de "respirar" quando algo claro cruza o quadro. Toque de novo para soltar. O REBAL. CENA recalibra cor e trava a exposição de uma vez — bom ao mudar de ambiente.

08 Botões liga/desliga e o âmbar

Os botões cinza escuro são interruptores (toggles): um toque liga, outro desliga. Quando a função está ligada, o botão fica âmbar.

O retorno fica no botão que dispara: os interruptores cujo estado a câmera confirma mostram a resposta em texto no próprio botão — FOCUS exibe AF/MF e a posição do foco, TRACK e PWR exibem ligado/desligado. Não há mais botões separados só de status.

Estado otimista: os demais toggles mudam de cor no instante do toque, sem esperar a câmera responder — a cor reflete o comando enviado, não uma leitura ao vivo. Na prática o botão acerta quase sempre; se a cor parecer não bater com a imagem no ar, na dúvida, aperte de novo.

Página de toggles. Âmbar = função ligada.

Os que o operador realmente usa: FOCUS (foco automático), TRACK (rastreamento), FREEZE (congelar imagem), BLC (compensação de contraluz simples). Os demais são do técnico — na dúvida, não toque.

09 Emergências e segurança

STOP (vermelho) para TODO movimento na hora. Existe em todas as páginas ao vivo.
Depois do STOP, toque o enquadramento verde do cenário — ele é sempre seguro para o ar.
O indicador TALLY mostra o estado da câmera no switcher: vermelho = no ar (PGM), verde = preparada (PVW).

Crítico

Botões vermelhos da página técnica (RESET, CLEAR) apagam posições gravadas. Eles exigem segurar 0,8–1 s até ficarem âmbar antes de agir — se você não gravou as posições, não segure. Um toque acidental não faz nada; segurar, sim.

10 Antes de ir ao ar — checklist de 60 segundos

Um minuto antes de qualquer transmissão, percorra esta lista. Ela elimina os erros que mais geram chamados: setup errado, função esquecida ligada e velocidade desregulada.

Toque o SETUP do seu cenário (SETUP CULTO, SETUP PLENÁRIA...). Sempre, mesmo que "ninguém mexeu".
Olhe os botões da página: algum âmbar inesperado? TRACK ou FREEZE ligados de ontem são os suspeitos de sempre.
Toque o enquadramento verde e confira a imagem no ar: foco, cor, luz.
Teste UM preset azul e veja se a velocidade do movimento está confortável.
Localize o STOP com o dedo — em emergência não se procura, já se sabe onde está.
Confira o indicador TALLY: ele responde quando o switcher corta para a câmera?

O verso do Guia Rápido traz esta mesma lista em formato compacto, para colar na mesa.

11 O que eu aperto quando... (índice por tarefa)

Ninguém procura "capítulo 7" durante a transmissão — procura-se pelo problema. Esta tabela vai direto da tarefa ao botão; a última coluna aponta a seção deste artigo para ler mais quando houver tempo.

Quando...	Aperte / leia
Quero enquadrar alguém agora	Botão azul da posição (PREGADOR, TRIBUNA, HOST...) — seção do seu cenário.
Preciso de um plano seguro JÁ	O botão verde do cenário (CONGREG., PLANO GERAL, WIDE ESTÚDIO, WIDE COURT) — 09.
A câmera se mexeu sozinha / errado	STOP, depois o verde — 09.
Quero que a câmera siga a pessoa	TRACK do cenário (âmbar = seguindo) — seção do seu cenário.
Movimento rápido/lento demais	Página de velocidade do cenário (PAN/TILT/ZOOM +/−; PADRÃO no Culto) — 03–06.
Imagem escura / estourada	CENA ESCURO, CENA CLARO ou CENA CONTRA; desfazer com CENA AUTO — 07.
Cor amarelada/azulada	WB PUSH (Entrevista) ou WB AUTO; REBAL. CENA ao trocar de ambiente — 07.
A imagem "respira" com gente passando	EXP LOCK trava a exposição; toque de novo para soltar — 07.
O foco ficou mole	FOCO 1x / AF PUSH (foca uma vez e trava) — seção do seu cenário.
A imagem congelou do nada	FREEZE está âmbar? Toque para descongelar — 08.
Mudar de posição com a câmera no ar	SAFE →HOST (Entrevista): congela, move, refoca, descongela — 05.
Gravar uma posição nova	Página SAVE do Companion (SAVE 1–8); recall nos botões PRESET — 12.
Tracking corta a cabeça / descentraliza	Não é ao vivo: peça ao técnico o ajuste do Presenter Mode — 12.

12 Instalação e calibração (para o técnico)

Requisitos: Companion 4.3.2+, módulo neoid-ptz v1.6.5 (.tgz via Import module), câmera e Companion na mesma rede com UDP liberado. O controle usa VISCA over IP (UDP, porta padrão 1259) — movimento e status pela mesma porta.

Campo	Função
IP da câmera	Endereço IPv4 da câmera na rede.
Porta VISCA UDP	Padrão 1259. Só altere se a câmera foi reconfigurada.
Ciclo de polling	Intervalo em ms da leitura de status (padrão 2000). 0 desativa.

São só esses três campos — a comunicação CGI custom usa sempre a porta 80 da câmera. Companion 5.x usa este pacote (v1.6.5); Companion 4.3.x usa o pacote 1.6.3.

A página Setup Avançado reúne a calibração de instalação que não muda ao vivo: o enquadramento do tracking (Presenter Mode), o ajuste fino de Hue e as ações destrutivas de preset. Cada ajuste escreve na câmera imediatamente (VISCA Direct) — calibre na instalação e não toque durante a transmissão.

Migração da v1.4.0

Os steppers de Tracking Sensitivity, Controle de Teto e Motion Sync, os botões de posição do sujeito (ESQ / CENTRO / DIR) e o display de status do enquadramento saíram desta página. A sensibilidade e o Motion Sync agora viajam prontos dentro de cada macro SETUP; o enquadramento do tracking virou os botões de plano abaixo.

Enquadramento do Tracking — Presenter Mode

Quando o rastreamento (TRACK) está ligado, o Presenter Mode define como a câmera enquadra a pessoa seguida: o tipo de plano (PLANO PG, PA, FECHADO ou CUSTOM) e se o tracking controla o zoom (AUTO ZOOM) e o tilt (AUTO TILT). É calibração de instalador — ajuste uma vez conforme o palco/tribuna e trave. É aqui que se corrige "cabeça cortada" ou "sujeito grande/pequeno demais" que o operador reporta.

Presenter Mode: planos de enquadramento e auto-zoom / auto-tilt.

Cada plano é um valor na escala 80–290 (razão de preenchimento do sujeito no quadro, não milímetros de zoom): número maior = enquadramento mais fechado. Os pontos de referência são 110 (PG), 165 (PA) e 290 (Fechado); cada botão é editável e envia o valor no comando VISCA 81 0A 0F 01 08 nnnn. Para quem vem da v1.4.0, os antigos planos discretos equivalem a esses valores (Plano Geral → 110, Plano Americano → 165, Fechado → 290).

Imagem — ajustes finos (HUE, BRIGHT, SHARP, CONTR, SAT, GAMMA) com o valor vivo no rótulo.

Os botões SETUP de cada cenário são macros que aplicam toda a calibração de uma vez. Os valores reais (lidos do código): sensibilidade de tracking Culto 4 · Plenária 3 · Entrevista 2 · Esporte 8; Motion Sync ligado em todos, velocidade 4 (Entrevista 2); exposição Full Auto (Esporte usa Shutter Priority), anti-flicker 60 Hz, medição center-weighted, gain limit por cenário (Culto 6 · Esporte 5 · Plenária 4 · Entrevista 4). O SETUP não mexe em Presenter Mode, Controle de Teto nem Hue.

Os comandos de tracking usam a Tracking Feature Extension (família VISCA 81 0A 0F 01). As tabelas reais de exposição do modelo de referência (índice de íris para f-stop, shutter para tempo, gain 0–7 direto), a arquitetura de velocidades e a referência completa dos 229 botões estão no PDF do manual (Parte 2).

13 Importar os cenários prontos (Culto, Plenária, Jornalismo, Esporte)

Um cenário pronto (nicho) é uma configuração de Companion já montada para um tipo de produção: você importa um arquivo .companionconfig e ganha páginas nomeadas com presets, comando de PAN/TILT/ZOOM, imagem e rastreamento — tudo apontando para a sua câmera NEOiD. São quatro: Culto, Plenária, Jornalismo e Esporte.

Se o seu Companion já controla vMix, OBS ou ATEM, nada disso precisa tocar no que você construiu — desde que você importe do jeito certo. Três operações, riscos diferentes:

Operação	Risco
Instalar o módulo (.tgz)	ZERO. Só adiciona o módulo à biblioteca — não altera conexões nem botões.
Criar a conexão NEOiD	ZERO. Convive com as conexões existentes; vMix/OBS/ATEM continuam intactos.
Importar um cenário (.companionconfig)	AQUI MORA O RISCO. Importado do jeito errado (Full Import), substitui TODA a sua configuração.

Se você vem da v1.6.3

Os grupos de status dos cenários, o display consolidado de exposição, o display de HUE e o toggle COLOR MATRIX saíram — o retorno agora aparece no próprio botão que dispara (FOCUS, TRACK, PWR e WB PUSH mostram estado/valor ao vivo). Os campos Porta HTTP e URL de atualização saíram da configuração, e as variáveis de posição de zoom e pan/tilt foram descontinuadas. Exceções deliberadas: TALLY e PRESET das páginas ao vivo foram mantidos.

O que cada cenário traz

Culto — NEOiD-PTZ_Culto.companionconfig · 3 páginas

Página	O que traz
CULTO	Página no ar: presets de enquadramento (PREGADOR, PÚLPITO, PREG. CLOSE, LOUVOR WIDE, VOCAL, BANDA, CONGREGAÇÃO, CEIA/BATISMO), pad PAN/TILT, zoom, TRACK ON/OFF, transição suave, velocidades e SALVAR CENA.
AJUSTES	Ajustes ao vivo: foco (auto, perto/longe), contraluz, congelar imagem, tracking (pessoa/palco/fechado, sensibilidade, auto zoom/tilt, trocar alvo), Motion Sync, velocidade de pan, WB PUSH e SAFE CEIA.
TÉCNICO	Imagem fina: exposição (auto/manual, íris, shutter, ganho e limite, exp. comp), anti-flicker, medição spot, white balance (temperatura, one-push, trigger), AF por zona/sensibilidade e freeze.

Plenária — NEOiD-PTZ_Plenaria.companionconfig · 4 páginas

Página	O que traz
SESSAO	Página no ar: presets institucionais (MESA, PRESIDENTE, TRIBUNA, ORADOR, BANCADA 1/2, VOTAÇÃO, PLANO GERAL), transições seguras para tribuna e orador, tally, último preset e atalhos de imagem/foco/WB.
MOVIMENTO	Comando manual: pad completo, zoom, HOME, velocidades, Motion Sync, tracking (sensibilidade, troca de alvo, modo, auto zoom/tilt), enquadre plano geral e reposicionar bancada.
IMAGEM	Exposição e cor: íris, EXP LOCK, shutter, modo auto/manual, flicker 60 Hz, medição, ganho e limite, exp. comp, WB 4200K, foco far/near, one-push e AF por zona.
SETUP	Calibração e gravação: WB travado/one-push, IR, menu OSD, SALVAR de cada preset institucional, controle e modo de tally, power, reset de velocidade, Motion Sync e enquadres apertado/aberto.

Jornalismo — NEOiD-PTZ_Jornalismo.companionconfig · 4 páginas

Página	O que traz
AO VIVO	Página no ar do estúdio: presets de entrevista (2-SHOT MESA, GUEST 1/2/3, WIDE ESTÚDIO, CUTAWAY, OTS HOST, INSERT DETALHE), SAFE →HOST, salvar guests, freeze no ar, tally REC/PVW e AUTO FRAME.
MOVIMENTO	Comando manual: pad PAN/TILT, zoom tele/wide, foco longe/perto e one-push, STOP CENTRO, HOME, velocidades e salvar preset.
COR-EXPO	Cor e exposição: íris, shutter, gain, exp. comp, modo manual, anti-flicker, WB one-push e casado com o Guest 1, temperaturas 3200K e 5600K, e WIDE SEGURO.
TRACKING	Rastreamento: modo, sensibilidade, alvo anterior/próximo, auto zoom/tilt, Motion Sync, planos (PG 110, PA 165, Fechado 290), proporção custom e WIDE SEGURO.

Esporte — NEOiD-PTZ_Esporte.companionconfig · 4 páginas

Página	O que traz
JOGO	Página no ar da partida: velocidades slow/normal/fast, presets de quadra (WIDE COURT, GOAL L/R, CENTER, BENCH A/B, SCORE), SAFE→WIDE, salvar presets, último preset, tracking e zoom.
MOVIMENTO	Comando manual: velocidades, HOME, pad completo, zoom tele/wide, foco far/near e one-push, tilt +/- em hold.
IMAGEM	Exposição e cor: shutter priority, iris priority, íris, shutter, gain, exp. comp, EXP LOCK, WB auto e one-push, backlight e freeze.
TRACKING-SETUP	Rastreamento e calibração: modo pessoa, Motion Sync (e speed), sensibilidade, planos (Fechado/PG/PA), custom ratio, troca de alvo, auto zoom/tilt, reset de velocidade e reposicionar.

Crítico

Os arquivos de cenário NEOiD (NEOiD-PTZ_Culto, _Plenaria, _Jornalismo, _Esporte) são exports completos. Na tela de importação, a opção Full Import substitui a configuração INTEIRA — todas as suas conexões e todos os seus botões. Nunca use Full Import para adicionar um cenário a uma configuração existente — importe sempre página por página.

Importar com segurança, passo a passo

Antes de tudo, faça um backup. Na interface do Companion (no navegador), vá até a aba Import / Export e exporte a configuração completa. Guarde o arquivo em local seguro.
Garanta a base. Instale o módulo neoid-ptz e crie a conexão da câmera NEOiD (seção Instalação e calibração). Essa conexão nova convive com vMix/OBS/ATEM.
Descubra quantas páginas o cenário traz: Culto = 3; Plenária, Jornalismo e Esporte = 4 cada. Você vai precisar desse número de páginas VAZIAS.
Localize (ou crie) as páginas vazias. No Companion, navegue pelas páginas pelo controle de páginas no topo e ache páginas sem botões; se precisar, adicione páginas pelo mesmo controle. Anote os números.
Na aba Import / Export, inicie a importação e selecione o arquivo do cenário (ex.: NEOiD-PTZ_Culto.companionconfig).
Não clique em Full Import — ele apaga TODA a sua configuração. Em vez disso, importe uma página de cada vez: escolha uma página do arquivo e mande-a para uma das páginas VAZIAS.
Repita para cada página do cenário, uma por página vazia (Culto tem 3; os demais têm 4). Só termine quando todas tiverem sido importadas.
Quando o Companion perguntar sobre a conexão NEOiD_PTZ do arquivo, escolha usar a sua conexão NEOiD já existente (não crie outra). Assim os botões apontam para a sua câmera.
Confira as páginas importadas: os botões respondem? A navegação interna do cenário leva às páginas certas?
Só então acione o SETUP do cenário — ele grava calibração e presets na câmera. O Companion salva os botões sozinho. Suas conexões vMix/OBS/ATEM continuam intactas.

Alternativa sem importar arquivo: a aba Presets do Companion lista todas as grades deste manual; arrastar um preset ocupa apenas o botão onde você o solta. Prefira páginas vazias — soltar sobre um botão ocupado substitui aquele botão.

14 Troubleshooting

Sintoma	Ação
Câmera não responde	Confira IP e porta VISCA (1259), ping na câmera, firewall liberando UDP.
Status mostram — ou Unknown	Polling desativado (0) ou câmera sem responder inquiries. Restaure o polling para 2000 ms.
Toggle não muda de cor	Estado otimista em ação; se persistir, confira a rede.
Recall com velocidade falha	A câmera respondeu 90 60 02 FF — o módulo já cai sozinho para o recall padrão.
Imagem parada do nada	FREEZE ficou ligado (botão âmbar). Toque FREEZE para descongelar.

Estado otimista: 10 funções não são consultadas (BLC, Exposure Compensation, Tally Mode, IR Receive, Preset ISP, OSD Menu, Information Display, Mirror, Flip e AE Bright) — o botão reflete o último comando enviado. Se a cor parecer errada, aperte para reenviar; não é falha de rede. O TRACK é exceção deliberada: continua consultado, então a cor dele é confiável.

Antes de chamar o suporte NEOiD

Com estes cinco itens em mãos, a maioria dos chamados se resolve na primeira mensagem:

Versão do módulo (aparece na conexão, no Companion) e versão do Companion.
IP e porta configurados na conexão da câmera.
O sintoma exato: o que você tocou, o que esperava, o que aconteceu — e se é sempre ou às vezes.
O log do módulo (aba Log do Companion) no momento do problema — copie as linhas com erro.
O que você já tentou da tabela acima, e o resultado de cada tentativa.