Fehlerbehebung

Such dein Symptom. Zwei Anhänge machen fast jeden Bericht lösbar: das OBS-Log (Hilfe → Logdateien → Aktuelles Log ansehen) und Optionen → Kameradiagnose aus der App.

Die Quellen erscheinen nicht in OBS#

• Starte OBS neu – Plugins werden nur einmal geladen, beim Start.
• Prüfe, ob OBS in Version 32 oder neuer vorliegt (Hilfe → Über).
• Linux, das Log meldet libavcodec.so.60: cannot open shared object file: Tarballs bis v1.7.x waren gegen das FFmpeg der Build-Maschine gelinkt und ließen sich daher nur auf Distributionen mit genau dieser Hauptversion laden. Aktualisiere oder baue aus dem Quellcode; dann wird gegen dein eigenes FFmpeg gelinkt.
• macOS, aus dem ZIP: Entferne das Quarantäne-Attribut, sonst verweigert OBS das Laden kommentarlos.

Die Quelle heißt „iOS Camera“, oder Updates scheinen nicht zu greifen#

Eine Kopie aus der Zeit vor 1.0 (ios-camera-source.dll) ist noch installiert und setzt sich gegen die aktuelle durch – das Log meldet „Source 'ios_camera_source' already exists“. Lösche beides und starte neu:

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

Der aktuelle Installer entfernt sie automatisch.

USB-Gerät nicht gefunden (Windows)#

• Installiere iTunes – es liefert den Gerätetreiber von Apple. Unter Windows führt daran kein Weg vorbei.
• Tippe auf „Vertrauen“, während das Smartphone entsperrt ist.
• Nutze ein Datenkabel. Nichts in der Oberfläche kann ein reines Ladekabel von einem Datenkabel unterscheiden.

„Gerät gefunden, aber die LensLink-App ist nicht erreichbar“ heißt, dass Kabel und Treiber in Ordnung sind: Die App ist nicht im Vordergrund, oder das Smartphone ist gesperrt.

Das Smartphone erscheint nicht im Auswahlfeld „Telefon“#

iOS verlangt für die Namensankündigung die Berechtigung Lokales Netzwerk: Erlaube sie, wenn danach gefragt wird, oder unter Einstellungen → Datenschutz & Sicherheit → Lokales Netzwerk → LensLink. Die IP einzutippen funktioniert in jedem Fall.

Prüfe außerdem, ob beide Geräte im selben Netzwerk sind und ob es sich nicht um ein Gastnetzwerk oder eines mit Client-Isolation handelt.

Die App funktioniert nach einer Woche nicht mehr (nur Sideloading)#

Bei kostenlosen Apple-IDs laufen per Sideloading installierte Apps nach 7 Tagen ab. Installiere sie neu, um sie aufzufrischen (die Einstellungen bleiben erhalten), oder wechsle zum Build aus dem App Store, der nicht abläuft.

„Hey Siri, starte den Stream mit LensLink“ wird nicht erkannt (nur Sideloading)#

Beim Neusignieren wird die Bundle-ID umgeschrieben, wodurch die kompilierten Befehlsdaten verwaisen: Siri verweigert den Dienst, obwohl dieselbe Aktion in der Kurzbefehle-App funktioniert. Nutze den Build aus dem App Store oder einen Kurzbefehl mit lenslink://start. Prüfe außerdem, dass die App einmal gestartet wurde und dass „Mit Siri verwenden“ unter Einstellungen → Siri & Suchen → LensLink aktiviert ist.

Videoeffekte im Kontrollzentrum fehlen oder sind ausgegraut#

Das sind iOS-Effekte, die du im Kontrollzentrum einschaltest, während eine App die Kamera nutzt. iOS bietet sie nur für bestimmte Kameras und Formate an – meist die Frontkamera, nichts über 1920×1440 –, und auf vielen iPhones bekommen die rückseitigen Kameras keinen davon.

• Optionen → Kameradiagnose zeigt, was dein Gerät pro Kamera und Format anbietet.
• LensLink wählt bereits ein effektfähiges Format, wenn deine Einstellungen das zulassen.
• Ein ausgegrauter Schalter bedeutet, dass die Bildrate zu hoch ist: Senke sie und schalte Optionen → Systemvideoeffekte erlauben ein.
• Vor 1.8.1 erschien das Feld überhaupt nicht – iOS füllt es nur für Apps, die jeden Effekt in Info.plist deklarieren, und das tut LensLink inzwischen.

Die Filter der Kamera-App und die Fotografischen Stile von Apple stehen keiner Drittanbieter-App zur Verfügung. Nutze stattdessen OBS-Filter (Rechtsklick → Filter).

Die Bildschirmübertragung stellt keine Verbindung her#

• Per Sideloading installierte Builds: Das Neusignieren kann die Erweiterung unbemerkt beschädigen; der Einrichtungsbildschirm der App warnt unter „Bildschirm spiegeln“, wenn sie fehlt. Builds aus TestFlight und dem App Store sind nicht betroffen.
• Prüfe, ob die Quelle eine LensLink Screen-Quelle ist – eine Kameraquelle, die eine Übertragung erhält, meldet das in ihrem Statusfeld.

Kein Ton, oder Ton, den du nicht hörst#

• DRM-Apps sind während einer Übertragung stumm: iOS schaltet Apple Music, Spotify und Netflix stumm. Ton aus Spielen, Apps und dem Browser ist kein Problem.
• Aufgezeichnet, aber nicht zu hören: Stell in den Erweiterten Audioeigenschaften von OBS das Audiomonitoring auf Monitoring aktiviert.
• Kein Smartphone-Mikrofon in OBS: Schalte Smartphone-Mikro an OBS senden ein. Ist Automatische Lippensynchron-Referenz an, geht es nicht – ein Mikrofon, eine Aufgabe.

Zwei Quellen, ein Smartphone#

Ein Smartphone beliefert immer nur eine Quelle; eine zweite meldet, dass das Gerät belegt ist. Die Ausnahme ist Trennen, wenn diese Quelle nirgends angezeigt wird: Eine ausgeblendete Quelle gibt das Smartphone frei, sodass sich Quellen in verschiedenen Szenen das Gerät teilen können.

Latenzspitzen über WLAN beim Zoomen#

Digitalzoom vergrößert das Sensorrauschen, das sich schlecht komprimieren lässt und die Bitrate hochtreibt. Nutze das Teleobjektiv oder wechsle zu USB.

„Verbunden, aber dieser OBS-Build kann den Stream nicht dekodieren“#

Diesem Build fehlt ein HEVC-Decoder. Stell die App auf H.264 um – dasselbe Bild, mehr Bandbreite.

Das Bild ist komplett grün#

Fast immer ist das der virtuelle Greenscreen, der wie vorgesehen arbeitet, aber sein Motiv nicht mehr findet: Das Smartphone malt alles, was nicht du bist, in Chroma-Grün an. Wenn die Segmentierung dich verliert – du hast das Bild verlassen, oder der Motivabstand ist zu knapp eingestellt –, ist das ganze Bild Hintergrund. Das übersteht einen Neustart von OBS und des Smartphones, weil die Einstellung auf dem Smartphone gespeichert ist.

Schalte zur Kontrolle Greenscreen in der App aus. Wenn du ihn nutzen willst, prüfe, ob auf der Quelle noch ein Chroma-Key-Filter liegt – das Plugin fügt beim ersten Mal einen hinzu und fügt einen gelöschten Filter nie erneut hinzu. Die Status-Zeile der Quelle sagt dir, welcher Fall vorliegt.

Er kostet das Smartphone außerdem bei jedem Bild echte Rechenarbeit; bei einem Gerät, das beim Streamen ruckelt, lohnt sich deshalb ein Test mit ausgeschaltetem Greenscreen.

Die OBS-Quelle zeigt ein unscharfes Bild mit Pause-Symbol#

Der Stream ist pausiert, nicht kaputt: Das Smartphone ist noch verbunden und seine Kamera läuft noch, aber es wird kein Video gesendet. Entweder hat ihn jemand pausiert – der Live-Bildschirm des Smartphones, das Browser-Steuerfeld und die Eigenschaften der Quelle haben alle die Schaltfläche –, oder iOS hat die Kamera unterbrochen. Das passiert, wenn auf einem iPad eine andere App sie neben LensLink öffnet. Setze den Stream von einer dieser Stellen aus fort; bei einer Unterbrechung geht es von selbst weiter, sobald die Kamera wieder verfügbar ist.

Das Bild friert ein oder wird schwarz, wenn ich auf dem Smartphone die App wechsle#

Das ist zu erwarten: iOS hält die Kameraaufnahme für Apps an, die nicht auf dem Bildschirm sind, deshalb beendet LensLink den Stream sauber, und die Quelle wird leer. Das Sperren des Smartphones hat dieselbe Wirkung. Eine Bildschirmübertragung ist die Ausnahme und läuft über App-Wechsel hinweg weiter, und ein unterstütztes iPad streamt neben einer anderen App in Split View, Slide Over oder Stage Manager weiter.

Das Fenster hat keine eigenen Schaltflächen – iOS zeichnet sie für diese Art Fenster seit iOS 15 nicht mehr –, also tippe darauf, um zu LensLink zurückzukehren. Schiebst du es über den Bildschirmrand hinaus, wird es geparkt, und iOS überlässt die Kamera nur einem Fenster, das es sehen kann: Die Aufnahme pausiert, der grüne Kamerapunkt erlischt, und OBS hält das letzte Bild, bis du das Fenster zurückziehst; dann läuft der Stream von selbst weiter. Das ist die Regel von iOS für Aufnahmen im Hintergrund, keine Einstellung von LensLink. Um zu stoppen oder zu pausieren, ohne überhaupt zum Smartphone zurückzugehen, drücke Stoppen oder Pausieren in OBS oder im Browser-Steuerfeld, oder bitte Siri, das Streaming zu stoppen.

Auf dem iPad hält es die Kamera am Laufen, LensLink neben der anderen App auf dem Bildschirm zu lassen – Split View, Slide Over oder Stage Manager –, sofern das Modell Kamerazugriff im Multitasking unterstützt (iPadOS 16+). Wo ein iPad die Kamera nicht teilen kann, lautet der Status Kamera pausiert – dieses iPad kann die Kamera auf dem Bildschirm nicht teilen; nutze LensLink dort im Vollbild.

Nichts davon passt#

Werkzeuge → LensLink-Einstellungen → Diagnosebericht kopieren, dann füge ihn in ein Issue auf GitHub ein. Er sammelt Versionen, Hardware, Grafikgerät, Einstellungen und den Verbindungszustand jeder Quelle – einschließlich des letzten Socket-Fehlers, der „die App lief nicht“ von „das Betriebssystem hat die Verbindung abgelehnt“ unterscheidet. Kein Video, kein Ton, keine persönlichen Daten.

Ohne die Qt-Oberfläche oder aus einem Skript: curl localhost:9980/api/diagnostics. Der Bericht landet auch im OBS-Log, sodass Hilfe → Logdateien → Aktuelle Logdatei hochladen ihn mitliefert.

Lohnt sich zusätzlich: Optionen → Kameradiagnose aus der App und das OBS-Log mit aktivierter Option Ausführliche Diagnose, während du das Problem einmal reproduzierst.