Dépannage

Trouvez votre symptôme. Deux pièces jointes permettent de résoudre presque n’importe quel signalement : le journal OBS (Aide → Fichiers journaux → Voir le journal actuel) et Options → Diagnostic de la caméra depuis l’app.

Les sources n’apparaissent pas dans OBS#

Redémarrez OBS : les plugins se chargent une seule fois, au démarrage.
Vérifiez qu’OBS est en version 32 ou plus récente (Aide → À propos).
Linux, le journal indique libavcodec.so.60: cannot open shared object file : jusqu’à la v1.7.x, les archives tar étaient liées au FFmpeg de la machine de build, et ne se chargeaient donc que sur les distributions ayant exactement cette version majeure. Mettez à jour, ou compilez depuis les sources, ce qui utilise votre propre FFmpeg.
macOS, depuis le zip : retirez l’attribut de quarantaine, sinon OBS refuse silencieusement de le charger.

La source s’appelle « iOS Camera », ou les mises à jour semblent sans effet#

Une copie antérieure à la 1.0 (ios-camera-source.dll) est toujours installée et prend le pas sur la version actuelle ; le journal indique « Source 'ios_camera_source' already exists ». Supprimez ces deux éléments, puis redémarrez :

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

Le programme d’installation actuel la supprime automatiquement.

Appareil USB introuvable (Windows)#

Installez iTunes : il fournit le pilote de périphérique d’Apple. Impossible de s’en passer sous Windows.
Touchez Se fier, téléphone déverrouillé.
Utilisez un câble de données. Rien dans l’interface ne permet de distinguer un câble de charge seule d’un câble de données.

« Appareil détecté, mais l’app LensLink est injoignable » signifie que le câble et le pilote fonctionnent : l’app n’est pas au premier plan, ou le téléphone est verrouillé.

iOS exige l’autorisation Réseau local pour annoncer le nom du téléphone : acceptez-la quand elle est demandée, ou activez-la dans Réglages → Confidentialité et sécurité → Réseau local → LensLink. Saisir l’IP fonctionne dans tous les cas.

Vérifiez aussi que les deux appareils sont sur le même réseau, et qu’il ne s’agit ni d’un réseau invité ni d’un réseau avec isolation des clients.

L’app cesse de fonctionner au bout d’une semaine (installation manuelle uniquement)#

Avec un identifiant Apple gratuit, les apps installées manuellement expirent tous les 7 jours. Réinstallez pour renouveler (les réglages sont conservés), ou passez à la version App Store, qui n’expire pas.

« Dis Siri, lance le streaming avec LensLink » n’est pas reconnu (installation manuelle uniquement)#

La re-signature réécrit l’identifiant de bundle, ce qui rend orphelines les données de phrases compilées : Siri refuse, alors que la même action fonctionne depuis Raccourcis. Utilisez la version App Store, ou un raccourci avec lenslink://start. Vérifiez aussi que l’app a été lancée une fois et que « Utiliser avec Siri » est activé dans Réglages → Siri et recherche → LensLink.

Les effets vidéo du Centre de contrôle sont absents ou grisés#

Ce sont des effets d’iOS, activés dans le Centre de contrôle pendant qu’une app utilise la caméra. iOS ne les propose que sur certaines caméras et certains formats (généralement la caméra avant, rien au-delà de 1920×1440) et, sur de nombreux iPhone, les caméras arrière n’en ont aucun.

Options → Diagnostic de la caméra montre ce que propose votre appareil, par caméra et par format.
LensLink choisit déjà un format compatible avec les effets quand vos réglages le permettent.
Une commande grisée signifie que la fréquence d’images est trop élevée : baissez-la, et activez Options → Autoriser les effets vidéo du système.
Avant la 1.8.1, le panneau n’apparaissait jamais : iOS ne le remplit que pour les apps qui déclarent chaque effet dans Info.plist, ce que LensLink fait désormais.

Les filtres de l’app Appareil photo et les Styles photographiques d’Apple ne sont accessibles à aucune app tierce. Utilisez plutôt les filtres OBS (clic droit → Filtres).

La diffusion d’écran ne se connecte pas#

Versions installées manuellement : la re-signature peut casser l’extension sans prévenir ; sur l’écran d’accueil de l’app, la section Recopie de l’écran signale son absence. Les versions TestFlight et App Store ne sont pas concernées.
Vérifiez que la source est bien une source LensLink Screen : une source Camera qui reçoit une diffusion l’indique dans son champ État.

Pas d’audio, ou un audio que vous n’entendez pas#

Les apps protégées par DRM sont muettes pendant une diffusion : iOS coupe Apple Music, Spotify et Netflix. L’audio des jeux, des apps et du navigateur passe sans problème.
Enregistré mais inaudible : réglez Monitoring audio sur Monitoring et sortie dans les Propriétés audio avancées d’OBS.
Pas de micro du téléphone dans OBS : activez Envoyer le micro du téléphone à OBS. Si Référence de synchro labiale auto est activée, cet envoi ne l’est pas : un micro, un rôle.

Deux sources, un téléphone#

Un téléphone n’alimente qu’une source à la fois ; une deuxième source indique que l’appareil est déjà utilisé. L’exception est Se déconnecter quand cette source n’est affichée nulle part : une source masquée libère le téléphone, et des sources placées dans des scènes différentes peuvent donc le partager.

Pics de latence en Wi-Fi avec le zoom#

Le zoom numérique amplifie le bruit du capteur, qui se compresse mal et fait grimper le débit. Utilisez le téléobjectif, ou passez en USB.

« Connecté, mais cette version d’OBS ne peut pas décoder le flux »#

Cette version n’a pas de décodeur HEVC. Passez l’app en H.264 : même image, plus de bande passante.

L’image est entièrement verte#

C’est presque toujours l’écran vert virtuel qui fonctionne comme prévu sur un sujet qu’il ne trouve plus : le téléphone peint en vert d’incrustation tout ce qui n’est pas vous, donc si la segmentation vous perd (vous avez quitté le cadre, ou la distance du sujet est trop serrée), toute l’image devient de l’arrière-plan. Cela survit au redémarrage d’OBS et du téléphone, car le réglage est stocké sur le téléphone.

Désactivez Écran vert dans l’app pour en avoir le cœur net. Si vous voulez le garder, vérifiez qu’un filtre d’incrustation par chrominance est toujours présent sur la source : le plugin en ajoute un la première fois et ne rajoute jamais un filtre que vous avez supprimé. La ligne État de la source indique dans quel cas vous êtes.

Il demande aussi un vrai travail au téléphone à chaque image : si un appareil rame pendant la diffusion, essayez-le avec l’écran vert désactivé.

La source OBS affiche une image floutée avec un symbole de pause#

Le flux est en pause, pas en panne : le téléphone est toujours connecté et sa caméra tourne toujours, mais aucune vidéo ne sort. Soit quelqu’un l’a mis en pause (l’écran de direct du téléphone, le panneau web et les propriétés de la source ont tous ce bouton), soit iOS a interrompu la caméra, ce qui arrive quand une autre app l’ouvre à côté de LensLink sur un iPad. Reprenez depuis n’importe lequel de ces endroits ; en cas d’interruption, la reprise est automatique quand la caméra revient.

L’image se fige ou devient noire quand je change d’app sur le téléphone#

C’est normal : iOS suspend la capture caméra des apps qui ne sont pas à l’écran, donc LensLink arrête proprement le flux et la source se vide. Verrouiller le téléphone a le même effet. Une diffusion d’écran fait exception et continue d’une app à l’autre, et un iPad compatible continue de diffuser à côté d’une autre app en Split View, Slide Over ou Stage Manager.

La fenêtre n’a pas de boutons à elle (iOS a cessé de les dessiner pour ce type de fenêtre après iOS 15) : touchez-la pour revenir à LensLink. La pousser hors du bord de l’écran la met de côté, et iOS ne prête la caméra qu’à une fenêtre qu’il voit : la capture se met donc en pause, le point vert de la caméra s’éteint, et OBS garde la dernière image jusqu’à ce que vous rameniez la fenêtre ; le flux reprend alors tout seul. C’est la règle d’iOS pour la capture en arrière-plan, pas un réglage de LensLink. Pour arrêter ou mettre en pause sans revenir au téléphone, appuyez sur Arrêter ou Mettre en pause dans OBS ou dans le panneau web, ou demandez à Siri d’arrêter la diffusion.

Sur iPad, garder LensLink visible à côté de l’autre app (Split View, Slide Over ou Stage Manager) maintient la caméra active sur les modèles qui prennent en charge l’accès à la caméra en multitâche (iPadOS 16+). Là où un iPad ne peut pas partager la caméra, l’état indique Caméra en pause – cet iPad ne peut pas partager la caméra à l’écran ; utilisez alors LensLink en plein écran.

Rien ne correspond#

Outils → Paramètres LensLink → Copier un rapport de diagnostic, puis collez-le dans un ticket sur GitHub. Il rassemble les versions, le matériel, le périphérique graphique, les réglages et l’état de connexion de chaque source, y compris la dernière erreur de socket, qui permet de distinguer « l’app ne tournait pas » de « le système a refusé la connexion ». Ni vidéo, ni audio, ni données personnelles.

Sans l’interface Qt, ou depuis un script : curl localhost:9980/api/diagnostics. Le rapport est aussi écrit dans le journal OBS : Aide → Fichiers journaux → Mettre en ligne le fichier journal actuel le transmet donc aussi.

À joindre également : Options → Diagnostic de la caméra depuis l’app, et le journal OBS avec Diagnostic détaillé activé pendant que vous reproduisez le problème une fois.