Solução de problemas

Encontre o seu sintoma. Dois anexos tornam quase qualquer relato solucionável: o log do OBS (Ajuda → Arquivos de registro → Ver arquivo de registro atual) e Opções → Diagnóstico da câmera, do app.

As fontes não aparecem no OBS#

Reinicie o OBS: os plugins são carregados uma única vez, na inicialização.
Confira se o OBS é a versão 32 ou mais recente (Ajuda → Sobre).
Linux, o log diz libavcodec.so.60: cannot open shared object file: os tarballs até a v1.7.x eram vinculados ao FFmpeg da máquina de build, então só carregavam em distribuições com exatamente aquela versão principal. Atualize ou compile a partir do código-fonte, que vincula o seu próprio FFmpeg.
macOS, instalado pelo zip: remova o atributo de quarentena, ou o OBS se recusa a carregá-lo sem avisar.

A fonte se chama "iOS Camera", ou as atualizações parecem não ter efeito#

Uma cópia anterior à 1.0 (ios-camera-source.dll) ainda está instalada e tem prioridade sobre a atual; o log diz "Source 'ios_camera_source' already exists". Apague estes dois itens e reinicie:

obs-plugins\64bit\ios-camera-source.dll
data\obs-plugins\ios-camera-source\

O instalador atual a remove automaticamente.

Dispositivo USB não encontrado (Windows)#

Instale o iTunes: ele fornece o driver de dispositivo da Apple. No Windows, não há como contornar isso.
Toque em Confiar, com o celular desbloqueado.
Use um cabo de dados. Nada na interface consegue diferenciar um cabo só de carga de um cabo de dados.

"Dispositivo encontrado, mas o app LensLink não está acessível" significa que o cabo e o driver estão funcionando: o app não está em primeiro plano, ou o celular está bloqueado.

O iOS exige a permissão de Rede Local para a divulgação do nome: permita quando for solicitado, ou em Ajustes → Privacidade e Segurança → Rede Local → LensLink. Digitar o IP funciona de qualquer forma.

Confira também se os dois aparelhos estão na mesma rede, e se ela não é uma rede de convidados nem uma com isolamento de clientes.

O app para de funcionar depois de uma semana (somente sideload)#

Com Contas Apple gratuitas, os apps instalados por sideload expiram a cada 7 dias. Reinstale para renovar (os ajustes são mantidos) ou mude para a versão da App Store, que não expira.

"E aí Siri, comece a transmitir com o LensLink" não é reconhecido (somente sideload)#

A reassinatura reescreve o ID do pacote, deixando órfãos os dados de frases compilados: a Siri recusa, mesmo que a mesma ação funcione pelos Atalhos. Use a versão da App Store, ou um atalho com lenslink://start. Verifique também se o app já foi aberto uma vez e se "Usar com a Siri" está ativado em Ajustes → Siri e Busca → LensLink.

Os efeitos de vídeo da Central de Controle não aparecem ou estão acinzentados#

São efeitos do iOS, ativados na Central de Controle enquanto um app usa a câmera. O iOS só os oferece em certas câmeras e formatos (normalmente a câmera frontal, nada acima de 1920×1440), e em muitos iPhones as câmeras traseiras não recebem nenhum.

Opções → Diagnóstico da câmera mostra o que o seu aparelho oferece, por câmera e formato.
O LensLink já escolhe um formato compatível com efeitos quando os seus ajustes permitem.
Um botão acinzentado indica que a taxa de quadros está alta demais: reduza-a e ative Opções → Permitir efeitos de vídeo do sistema.
Antes da 1.8.1, o painel nem aparecia: o iOS só o preenche para apps que declaram cada efeito no Info.plist, o que o LensLink agora faz.

Os filtros do app Câmera e os Estilos Fotográficos da Apple não estão disponíveis para nenhum app de terceiros. Use os filtros do OBS (clique com o botão direito → Filtros).

A transmissão de tela não conecta#

Versões instaladas por sideload: a reassinatura pode quebrar a extensão sem aviso; a seção Espelhamento de tela da tela principal do app avisa quando ela está faltando. As versões do TestFlight e da App Store não são afetadas.
Confira se a fonte é uma fonte LensLink Screen: uma fonte Camera que recebe uma transmissão de tela avisa isso no campo Status.

Sem áudio, ou áudio que você não consegue ouvir#

Apps com DRM ficam mudos durante uma transmissão: o iOS silencia Apple Music, Spotify e Netflix. O áudio de jogos, apps e do navegador funciona normalmente.
Gravado, mas inaudível: defina o Monitoramento de áudio como Monitoramento ativado nas Propriedades de áudio avançadas do OBS.
Sem o microfone do celular no OBS: ative Enviar microfone do celular ao OBS. Se a Referência automática de sincronia labial estiver ativada, ele não é enviado: um microfone, uma função.

Duas fontes, um celular#

Um celular alimenta uma fonte por vez; uma segunda fonte avisa que o aparelho está em uso. A exceção é Desconectar quando esta fonte não aparecer em lugar nenhum: uma fonte oculta libera o celular, então fontes em cenas diferentes podem compartilhá-lo.

Picos de latência no Wi-Fi com zoom#

O zoom digital amplia o ruído do sensor, que comprime mal e faz a taxa de bits disparar. Use a lente Teleobjetiva ou mude para USB.

"Conectado, mas esta versão do OBS não consegue decodificar o vídeo"#

Essa versão não tem decodificador HEVC. Mude o app para H.264: a mesma imagem, com mais banda.

A imagem está totalmente verde#

Quase sempre é a tela verde virtual funcionando como deveria com um assunto que ela não encontra mais: o celular pinta de verde chroma tudo o que não é você, então, se a segmentação perde você (você saiu do quadro, ou a distância do assunto está apertada demais), o quadro inteiro vira fundo. Isso continua mesmo depois de reiniciar o OBS e o celular, porque a configuração fica no celular.

Desative a Tela verde no app para confirmar. Se você quer mantê-la ativada, confira se ainda há um filtro chroma key na fonte: o plugin adiciona um na primeira vez e nunca volta a adicionar um filtro que você excluiu. A linha Status da fonte diz em qual caso você está.

Ela também dá bastante trabalho ao celular a cada quadro, então vale testar com a tela verde desativada um aparelho que fica lento durante a transmissão.

A fonte no OBS mostra uma imagem desfocada com um símbolo de pausa#

A transmissão está pausada, não quebrada: o celular continua conectado e a câmera continua rodando, mas nenhum vídeo está saindo. Ou alguém a pausou (a tela Ao vivo do celular, o painel web e as propriedades da fonte têm o botão), ou o iOS interrompeu a câmera, o que acontece quando outro app a abre ao lado do LensLink em um iPad. Retome a partir de qualquer um desses lugares; no caso da interrupção, a transmissão é retomada sozinha quando a câmera volta.

A imagem congela ou fica preta quando troco de app no celular#

É o esperado: o iOS suspende a captura da câmera dos apps que não estão na tela, então o LensLink para a transmissão de forma limpa e a fonte fica vazia. Bloquear o celular tem o mesmo efeito. Uma transmissão de tela é a exceção e continua rodando entre apps, e um iPad compatível continua transmitindo ao lado de outro app em Split View, Slide Over ou no Organizador Visual.

A janela não tem botões próprios (o iOS deixou de desenhá-los nesse tipo de janela depois do iOS 15), então toque nela para voltar ao LensLink. Empurrá-la para fora da lateral da tela a estaciona, e o iOS só empresta a câmera a uma janela que ele consegue ver; por isso a captura pausa, o ponto verde da câmera se apaga e o OBS mantém o último quadro até você puxar a janela de volta, e aí a transmissão é retomada sozinha. Essa é a regra do iOS para captura em segundo plano, não uma configuração do LensLink. Para parar ou pausar sem voltar ao celular, use Parar ou Pausar no OBS ou no painel web, ou peça à Siri para parar a transmissão.

No iPad, manter o LensLink na tela junto com o outro app (Split View, Slide Over ou Organizador Visual) mantém a câmera rodando nos modelos compatíveis com acesso à câmera em multitarefa (iPadOS 16+). Onde o iPad não consegue compartilhar a câmera, o status mostra Câmera pausada: este iPad não pode compartilhar a câmera na tela; lá, use o LensLink em tela cheia.

Nada aqui corresponde ao seu caso#

Ferramentas → Configurações do LensLink → Copiar um relatório de diagnóstico e cole em uma issue no GitHub. Ele reúne as versões, o hardware, o dispositivo gráfico, as configurações e o estado da conexão de cada fonte, incluindo o último erro de socket, que distingue "o app não estava rodando" de "o sistema operacional recusou a conexão". Sem vídeo, áudio nem dados pessoais.

Sem a interface Qt, ou a partir de um script: curl localhost:9980/api/diagnostics. O relatório também vai para o log do OBS, então Ajuda → Arquivos de registro → Carregar arquivo de registro atual o inclui.

Vale acrescentar: Opções → Diagnóstico da câmera, do app, e o log do OBS com Diagnóstico detalhado ativado enquanto você reproduz o problema uma vez.