What's new in ImmersiveMediaSupport

extension ImmersivePreviewRenderer : Sendable {
}

extension ImmersivePreviewRenderer.Eye : Equatable {
}

extension ImmersivePreviewRenderer.Eye : Hashable {
}

public struct ShotFlipCommand {

    /// A unique command ID for the immersive media file.
    public var id: Int { get }

    /// The time this command starts during playback.
    public var time: CMTime

    /// The duration of the command.
    public var duration: CMTime

    /// The offset from the start time of this command.
    public var offset: CMTime?

    /// Creates a command instance for a certain time, duration and offset.
    /// - Parameters:
    ///   - id: The unique ID of this command.
    ///   - time: The time for this command to start during playback.
    ///   - duration: The duration of this command during playback.
    ///   - offset: The offset from the start time of this command.
    public init(id: Int, time: CMTime, duration: CMTime, offset: CMTime? = nil)

    public init(from decoder: any Decoder) throws

    public func encode(to encoder: any Encoder) throws
}

extension ShotFlipCommand : Sendable {
}

public struct Overrides : Codable, Sendable {

    /// Camera rotation to override the rotation in ``ImmersiveCamera/pose``.
    ///
    /// This rotation is applied uniformly to both eyes of a stereo frame as
    /// an image reorientation. It does not remap eye assignment, reproject parallax, or account
    /// for the stereo baseline encoded in the source video.
    ///
    /// For stereo content, only rotations that keep the stereo baseline horizontal in viewer
    /// space produce comfortable fusion:
    /// - **Yaw** (rotation about the viewer-up axis) — safe at any magnitude, though yaw angles
    ///   approaching ±180° invert the parallax sign (depth appears reversed).
    /// - **Pitch** (rotation about the camera's local right / baseline axis) — safe at any
    ///   magnitude; the baseline is the rotation axis and remains invariant.
    /// - **Roll** (rotation about the camera-forward axis) — rotates the baseline out of
    ///   horizontal, creating vertical disparity between eyes. Small roll angles cause eye
    ///   strain; larger angles (≥ a few degrees) prevent fusion entirely.
    /// - Any mixed rotation that decomposes to a non-zero roll component exhibits the same
    ///   failure proportional to the roll magnitude.
    ///
    /// For mono content there are no stereo constraints and the full rotation space is valid.
    public var rotation: Rotation3DFloat?

    /// Inline lens definition (ILPD) data to override lens calibration
    public var lensDefinitionData: ImmersiveCameraLensDefinition?

    /// Dynamic mask data to override camera mask
    public var maskData: ImmersiveDynamicMask?

    public init(rotation: Rotation3DFloat? = nil, lensDefinitionData: ImmersiveCameraLensDefinition? = nil, maskData: ImmersiveDynamicMask? = nil)

    /// Encodes this value into the given encoder.
    ///
    /// If the value fails to encode anything, `encoder` will encode an empty
    /// keyed container in its place.
    ///
    /// This function throws an error if any values are invalid for the given
    /// encoder's format.
    ///
    /// - Parameter encoder: The encoder to write data to.
    public func encode(to encoder: any Encoder) throws

    /// Creates a new instance by decoding from the given decoder.
    ///
    /// This initializer throws an error if reading from the decoder fails, or
    /// if the data read is corrupted or otherwise invalid.
    ///
    /// - Parameter decoder: The decoder to read data from.
    public init(from decoder: any Decoder) throws
}