Camera Capture Diagnostics

Systematic troubleshooting for AVFoundation camera issues: frozen preview, wrong rotation, slow capture, session interruptions, and permission problems.

Overview

Core Principle: When camera doesn't work, the problem is usually:

1. Threading (session work on main thread) - 35%
2. Session lifecycle (not started, interrupted, not configured) - 25%
3. Rotation (deprecated APIs, missing coordinator) - 20%
4. Permissions (denied, not requested) - 15%
5. Configuration (wrong preset, missing input/output) - 5%

Always check threading and session state BEFORE debugging capture logic.

Red Flags

Symptoms that indicate camera-specific issues: