Problem
Remote guest joins from a mobile device whose orientation change interrupts the video feed.
Solution
Root Cause / Diagnostic:
Mobile operating systems reset WebRTC video capture pipelines and renegotiate hardware encoder resolutions when the device transitions between portrait and landscape modes. This renegotiation causes the video feed to freeze, distort its aspect ratio (e.g., squishing 9:16 into 16:9), or drop frames entirely inside the switcher capture canvas.
Actionable Fix:
1. Force Fixed Landscape Resolution via Ingestion Parameters: In VDO.ninja or browser-based callers, append forced resolution flags (e.g., &width=1920&height=1080&orientation=landscape) to the guest invite link.
2. Mandate Device Physical Mounting: Require remote guests connecting via mobile devices to lock their phone in an immovable tripod or clamp before joining the call, disabling auto-rotate in system settings.
3. Configure Switcher Transform Bounding Boxes: In OBS/vMix, set the guest video source transform to "Scale to inner bounds" with centering enabled so unexpected aspect changes pillarbox cleanly rather than distorting canvas layouts.
Pro Tip:
Provide guests joining from mobile with a simple cheat sheet instructing them to lock screen orientation in iOS Control Center or Android Quick Settings prior to opening their camera link, preventing accidental gyro-triggered canvas collapses.
Mobile operating systems reset WebRTC video capture pipelines and renegotiate hardware encoder resolutions when the device transitions between portrait and landscape modes. This renegotiation causes the video feed to freeze, distort its aspect ratio (e.g., squishing 9:16 into 16:9), or drop frames entirely inside the switcher capture canvas.
Actionable Fix:
1. Force Fixed Landscape Resolution via Ingestion Parameters: In VDO.ninja or browser-based callers, append forced resolution flags (e.g., &width=1920&height=1080&orientation=landscape) to the guest invite link.
2. Mandate Device Physical Mounting: Require remote guests connecting via mobile devices to lock their phone in an immovable tripod or clamp before joining the call, disabling auto-rotate in system settings.
3. Configure Switcher Transform Bounding Boxes: In OBS/vMix, set the guest video source transform to "Scale to inner bounds" with centering enabled so unexpected aspect changes pillarbox cleanly rather than distorting canvas layouts.
Pro Tip:
Provide guests joining from mobile with a simple cheat sheet instructing them to lock screen orientation in iOS Control Center or Android Quick Settings prior to opening their camera link, preventing accidental gyro-triggered canvas collapses.