Solución de problemas

Busca tu síntoma. Con dos archivos adjuntos casi cualquier informe se puede resolver: el registro de OBS (Ayuda → Archivos de registro → Ver registro actual) y Opciones → Diagnóstico de cámara de la app.

Las fuentes no aparecen en OBS#

Reinicia OBS: los plugins se cargan una sola vez, al iniciarse.
Comprueba que tienes OBS 32 o posterior (Ayuda → Acerca de).
Linux, el registro dice libavcodec.so.60: cannot open shared object file: los tarballs hasta la v1.7.x se enlazaban con el FFmpeg de la máquina de compilación, así que solo se cargaban en distribuciones con esa misma versión mayor. Actualiza o compila desde el código fuente, que enlaza con el tuyo.
macOS, desde el zip: quita el atributo de cuarentena, o OBS se negará a cargarlo sin avisar.

La fuente se llama “iOS Camera”, o las actualizaciones no parecen aplicarse#

Sigue instalada una copia anterior a la 1.0 (ios-camera-source.dll) que se impone a la actual; el registro dice “Source 'ios_camera_source' already exists”. Elimina estas dos rutas y reinicia:

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

El instalador actual la elimina automáticamente.

No se encuentra el dispositivo USB (Windows)#

Instala iTunes: incluye el controlador de dispositivos de Apple. En Windows no hay otra forma.
Toca Confiar, con el teléfono desbloqueado.
Usa un cable de datos. Nada en la interfaz permite distinguir un cable solo de carga de uno de datos.

“Dispositivo encontrado, pero no se puede acceder a la app LensLink” significa que el cable y el controlador están bien: la app no está en primer plano o el teléfono está bloqueado.

iOS exige el permiso de Red local para anunciar el nombre: concédelo cuando se te pida, o en Configuración → Privacidad y seguridad → Red local → LensLink. Escribir la IP funciona de todos modos.

Comprueba también que los dos dispositivos estén en la misma red, y que no sea una red de invitados ni una con aislamiento de clientes.

La app deja de funcionar al cabo de una semana (solo con instalación manual)#

Con un Apple ID gratuito, las apps instaladas manualmente (sideload) caducan cada 7 días. Vuelve a instalarla para renovarla (los ajustes se conservan), o cambia a la versión de la App Store, que no caduca.

“Oye Siri, empieza a transmitir con LensLink” no se reconoce (solo con instalación manual)#

Al volver a firmar la app se reescribe el identificador de paquete (bundle ID), lo que deja huérfanos los datos compilados de las frases: Siri se niega aunque la misma acción funcione desde Atajos. Usa la versión de la App Store, o un atajo con lenslink://start. Comprueba también que la app se haya abierto al menos una vez y que “Usar con Siri” esté activado en Configuración → Siri y búsqueda → LensLink.

Los efectos de video del Centro de control faltan o están atenuados#

Son efectos de iOS que se activan en el Centro de control mientras una app usa la cámara. iOS solo los ofrece en ciertas cámaras y formatos (normalmente la cámara frontal, y nada por encima de 1920×1440), y en muchos iPhone las cámaras traseras no tienen ninguno.

Opciones → Diagnóstico de cámara muestra lo que ofrece tu dispositivo, por cámara y formato.
LensLink ya elige un formato compatible con efectos cuando tus ajustes lo permiten.
Si un interruptor está atenuado, la velocidad de fotogramas es demasiado alta: bájala y activa Opciones → Permitir efectos de video del sistema.
Antes de la 1.8.1, el panel no aparecía nunca: iOS solo lo muestra para las apps que declaran cada efecto en Info.plist, cosa que LensLink ya hace.

Los filtros de la app Cámara de Apple y los Estilos fotográficos no están disponibles para ninguna app de terceros. Usa en su lugar los filtros de OBS (clic derecho → Filtros).

La transmisión de pantalla no se conecta#

Versiones instaladas manualmente: volver a firmar la app puede romper la extensión sin avisar; la sección Duplicado de pantalla de la pantalla principal avisa cuando falta. Las versiones de TestFlight y de la App Store no se ven afectadas.
Comprueba que la fuente sea una fuente LensLink Screen: si una fuente Camera recibe una transmisión de pantalla, lo indica en su campo Estado.

No hay audio, o hay audio que no oyes#

Las apps con DRM quedan en silencio durante una transmisión: iOS silencia Apple Music, Spotify y Netflix. El audio de juegos, apps y navegador funciona bien.
Se graba pero no se oye: configura la Monitorización de audio como Monitor y salida en las Propiedades de audio avanzadas de OBS.
No llega el micrófono del teléfono a OBS: activa Enviar micrófono del teléfono a OBS. Si Referencia de sincronía labial automática está activada, no llegará: un micrófono, una función.

Dos fuentes, un teléfono#

Un teléfono alimenta una sola fuente a la vez; una segunda indica que el dispositivo está en uso. La excepción es Desconectar cuando esta fuente no se muestre en ninguna parte: una fuente oculta libera el teléfono, así que fuentes de escenas distintas pueden compartirlo.

Picos de latencia por Wi-Fi con zoom#

El zoom digital amplía el ruido del sensor, que se comprime mal y dispara la tasa de bits. Usa la lente Teleobjetivo o cambia a USB.

“Conectado, pero esta versión de OBS no puede decodificar la transmisión”#

Esa versión no tiene decodificador HEVC. Cambia la app a H.264: la misma imagen, con más ancho de banda.

La imagen es completamente verde#

Casi siempre es la pantalla verde virtual funcionando como debe con un sujeto que ya no encuentra: el teléfono pinta de verde croma todo lo que no eres tú, así que si la segmentación te pierde (porque saliste del encuadre o porque la distancia del sujeto es demasiado corta), todo el encuadre pasa a ser fondo. Sobrevive a reiniciar OBS y el teléfono, porque el ajuste está en el teléfono.

Desactiva Pantalla verde en la app para confirmarlo. Si la quieres activada, comprueba que la fuente siga teniendo un filtro de croma: el plugin añade uno la primera vez y nunca vuelve a añadir un filtro que hayas eliminado. La línea Estado de la fuente indica en qué caso estás.

Además, supone un trabajo real para el teléfono en cada fotograma, así que si un dispositivo va lento al transmitir, vale la pena probarlo con la pantalla verde desactivada.

La fuente de OBS muestra una imagen desenfocada con un símbolo de pausa#

La transmisión está en pausa, no rota: el teléfono sigue conectado y su cámara sigue en marcha, pero no sale video. O alguien la pausó (la pantalla En vivo del teléfono, el panel web y las propiedades de la fuente tienen ese botón), o iOS interrumpió la cámara, algo que ocurre en un iPad cuando otra app la abre junto a LensLink. Reanúdala desde cualquiera de esos sitios; en el caso de la interrupción, se reanuda sola cuando vuelve la cámara.

La imagen se congela o se pone en negro al cambiar de app en el teléfono#

Es lo esperado: iOS suspende la captura de cámara de las apps que no están en pantalla, así que LensLink detiene la transmisión limpiamente y la fuente queda vacía. Bloquear el teléfono tiene el mismo efecto. Una transmisión de pantalla es la excepción y sigue funcionando al cambiar de app, y un iPad compatible sigue transmitiendo junto a otra app en Split View, Slide Over u Organizador visual.

La ventana no tiene botones propios (iOS dejó de dibujarlos en este tipo de ventana después de iOS 15), así que tócala para volver a LensLink. Si la empujas fuera del borde de la pantalla, queda aparcada, y iOS solo presta la cámara a una ventana que puede ver: la captura se pausa, el punto verde de la cámara se apaga y OBS mantiene el último fotograma hasta que vuelves a sacar la ventana, momento en el que la transmisión se reanuda sola. Es la regla de iOS para la captura en segundo plano, no un ajuste de LensLink. Para detener o pausar sin tener que volver al teléfono, pulsa Detener o Pausar en OBS o en el panel web, o pídele a Siri que deje de transmitir.

En iPad, mantener LensLink en pantalla junto a la otra app (Split View, Slide Over u Organizador visual) mantiene la cámara en marcha en los modelos que admiten el acceso a la cámara en multitarea (iPadOS 16 o posterior). Donde un iPad no puede compartir la cámara, el estado indica Cámara en pausa: este iPad no puede compartir la cámara en pantalla; ahí, usa LensLink a pantalla completa.

Nada de esto coincide#

Herramientas → Ajustes de LensLink → Copiar un informe de diagnóstico, y luego pégalo en una incidencia en GitHub. Reúne las versiones, el hardware, el dispositivo gráfico, los ajustes y el estado de conexión de cada fuente, incluido el último error de socket, que distingue entre “la app no se estaba ejecutando” y “el sistema operativo rechazó la conexión”. Sin video, audio ni datos personales.

Sin la interfaz Qt, o desde un script: curl localhost:9980/api/diagnostics. El informe también va al registro de OBS, así que Ayuda → Archivos de registro → Cargar el archivo de registro actual lo incluye.

Conviene añadir también: Opciones → Diagnóstico de cámara de la app, y el registro de OBS con Diagnóstico detallado activado mientras reproduces el problema una vez.