<!--
{
  "availability" : [
    "macOS: 26.0.0 -",
    "visionOS: 26.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "ImmersiveMediaSupport",
  "identifier" : "/documentation/ImmersiveMediaSupport",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Immersive Media Support"
    ],
    "preciseIdentifier" : "ImmersiveMediaSupport"
  },
  "title" : "Immersive Media Support"
}
-->

# Immersive Media Support

Read and write essential Apple Immersive Video metadata.

## Overview

Immersive Media Support enables you to create custom workflows for processing Apple Immersive Video (AIV). Use it to read and write AIV-specific metadata and enable previewing content in editorial workflows.

## Topics

### Essentials

[Authoring Apple Immersive Video](/documentation/ImmersiveMediaSupport/authoring-apple-immersive-video)

Prepare and package immersive video content for delivery.

[Processing Apple Immersive Video with foveation](/documentation/ImmersiveMediaSupport/processing-apple-immersive-video-with-foveation)

Reduce a video’s data rate while maintaining high acuity in the center of the imagery by applying foveation to immersive video content.

### Camera metadata

[`VenueDescriptor`](/documentation/ImmersiveMediaSupport/VenueDescriptor)

The Apple Immersive Media Venue Descriptor is a collection of static metadata necessary
for every Apple Immersive Video.

[`ImmersiveCamera`](/documentation/ImmersiveMediaSupport/ImmersiveCamera)

A structure that holds the required information for an immersive media camera to process and render video frames.

[`ImmersiveCameraLensDefinition`](/documentation/ImmersiveMediaSupport/ImmersiveCameraLensDefinition)

This type holds the ILPD lens configuration parameters to generate a camera calibration type instance.

[`ImmersiveCameraCalibration`](/documentation/ImmersiveMediaSupport/ImmersiveCameraCalibration)

A structure that represents immersive media camera calibration data.

[`ImmersiveCameraMask`](/documentation/ImmersiveMediaSupport/ImmersiveCameraMask)

A structure that holds the camera mask type information and its relevant mask name.

[`ImmersiveDynamicMask`](/documentation/ImmersiveMediaSupport/ImmersiveDynamicMask)

A type that holds the information required to dynamically generate an immersive media mask at load time.

[`ImmersiveImageMask`](/documentation/ImmersiveMediaSupport/ImmersiveImageMask)

An object that holds all the information needed to load immersive media masks from image data or from a file.

### Presentation commands

[`PresentationCommand`](/documentation/ImmersiveMediaSupport/PresentationCommand)

A set of properties that define the interface for a presentation command.

[`FadeCommand`](/documentation/ImmersiveMediaSupport/FadeCommand)

A command type for color fading during immersive media playback.

[`FadeEnvironmentCommand`](/documentation/ImmersiveMediaSupport/FadeEnvironmentCommand)

A command type for opacity fading environment backdrops during immersive media playback.

[`SetCameraCommand`](/documentation/ImmersiveMediaSupport/SetCameraCommand)

A command type for immersive camera switching during playback.

[`ShotFlopCommand`](/documentation/ImmersiveMediaSupport/ShotFlopCommand)

A command type to flip the video frames horizontally (mirrored horizontally) during playback for the duration of the command.

[`ShotFlipCommand`](/documentation/ImmersiveMediaSupport/ShotFlipCommand)

A command type to flip the video frames vertically during playback for the duration of the command.

[`PresentationDescriptor`](/documentation/ImmersiveMediaSupport/PresentationDescriptor)

A structure that represents dynamic metadata used during playback or when outputting the metadata track for an immersive video file.

[`PresentationDescriptorReader`](/documentation/ImmersiveMediaSupport/PresentationDescriptorReader)

An object that provides the functionality required to understand and process immersive presentation commands.

### Parametric immersive support

[`ParametricImmersiveAssetInfo`](/documentation/ImmersiveMediaSupport/ParametricImmersiveAssetInfo)

An object that helps convert the original wide field of view video asset to parametric immersive asset.

### Immersive video rendering support

[`ImmersiveVideoFrame`](/documentation/ImmersiveMediaSupport/ImmersiveVideoFrame)

A type that represents an immersive video frame, including its layout, presentation time, and pixel buffer data.

[`ImmersiveCameraViewModel`](/documentation/ImmersiveMediaSupport/ImmersiveCameraViewModel)

A view model that holds all the resources needed to render an immersive camera view.

[`ImmersiveVideoMask`](/documentation/ImmersiveMediaSupport/ImmersiveVideoMask)

A video mask to use during video rendering to smooth the edges of the mesh.

### Preview

[`ImmersiveMediaPreviewMessagingProtocol`](/documentation/ImmersiveMediaSupport/ImmersiveMediaPreviewMessagingProtocol)

An object that represents the messaging protocol a remote preview sender and receiver use to communicate.

[`ImmersiveMediaRemotePreviewSender`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewSender)

An observable object that helps an app send the required data to all connected receiver applications to help facilitate the complete preview of the immersive media playback.

[`ImmersiveMediaRemotePreviewReceiver`](/documentation/ImmersiveMediaSupport/ImmersiveMediaRemotePreviewReceiver)

An observable object that helps applications handle receiving commands and data sent from an immersive media remote preview sender object.

[`ImmersivePreviewRenderer`](/documentation/ImmersiveMediaSupport/ImmersivePreviewRenderer)

An object that renders an immersive video frame into a texture and exposes the command buffer for presentation.

### Validation

[`AIVUValidator`](/documentation/ImmersiveMediaSupport/AIVUValidator)

A type to validate existing AIVU files to ensure that they meet the minimum requirements for AIV.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)