visionOS Immersive Media Developer

Quick Start

Decide first whether the app should use the system AVKit experience or a custom RealityKit playback surface.

1. Clarify the media shape: surface video, portal, progressive immersive, full immersive, spatial video, or Apple Immersive Video.
2. Load only the matching reference files.
3. Treat playback-mode changes as both media and scene-orchestration work.

Load References When

Workflow

1. Choose the playback architecture.
2. Load the references for that surface and media type.
3. Implement playback and viewing-mode transitions.
4. Add event handling and comfort mitigation where relevant.
5. Summarize the playback path, transition model, and remaining validation work.

Guardrails

• Start with AVKit AVExperienceController when the system player experience fits the product.
• Use RealityKit VideoPlayerComponent when the video must live in a custom scene graph.
• Do not treat immersive-mode transitions as a simple property flip when the app also needs scene changes.
• Make sure the user has a clear exit path from immersive playback.

Output Expectations

Provide:

• the chosen playback architecture
• the media type and viewing mode
• which references were used
• the transition or event model involved
• the next validation step