Why does the camera stop working on iPad in Split View?

iPadOS restricts camera access when multiple foreground apps are active; developers must handle the specific videoDeviceNotAvailableWithMultipleForegroundApps interruption reason.

Why does my app freeze when the camera opens?

This is often caused by calling session.startRunning() on the main thread; this skill provides patterns to move capture work to a dedicated background queue to keep the UI responsive.

How do I fix camera rotation issues on iOS 17?

Modern xOS apps should use the AVCaptureDevice.RotationCoordinator API to synchronize the horizon level for both the preview layer and the final photo output connection.

Is the front camera supposed to mirror photos?

Standard behavior mirrors the preview for user comfort, but the final captured photo is typically not mirrored so that text and environments appear correctly to others.

Why is my camera preview showing a black screen?

A black screen usually indicates the session hasn't started, inputs are missing, permissions were denied, or the preview layer isn't properly connected to the view hierarchy.

Camera Capture Diagnostics

Name: Camera Capture Diagnostics
Author: CharlesWiltgen

byCharlesWiltgen

•

233

•

Mobile Development

Diagnoses and resolves AVFoundation camera issues including preview freezes, rotation errors, and session interruptions for Apple platforms.

This diagnostic skill provides a systematic framework for troubleshooting AVFoundation camera capture implementations on iOS, iPadOS, and macOS. It helps developers identify the root cause of common issues—such as main-thread blocking, session lifecycle failures, and permission conflicts—which account for the majority of camera-related bugs. With built-in support for modern iOS 17+ APIs like RotationCoordinator and comprehensive decision trees for symptoms like black previews or slow capture, it enables rapid debugging and implementation of battle-tested patterns for media-heavy xOS applications.

主要功能

01Systematic threading and session state verification

02Interruption handling patterns for phone calls and iPad Split View

03Implementation guidance for the iOS 17+ RotationCoordinator API

04Thermal pressure and permission state monitoring

05Automated diagnostic patterns for common symptoms like black previews and UI freezes

06233 GitHub stars

使用场景

01Optimizing slow capture performance by adjusting photo quality prioritization settings

02Fixing a frozen camera preview during app launch or state transitions

03Correcting 90-degree rotation errors in both real-time preview and final photo output

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add charleswiltgen/axiom axiom-camera-capture-diag

For use in Claude.ai and ChatGPT

Download Skill