<!--
{
  "availability" : [
    "iOS: 17.0.0 -",
    "iPadOS: 17.0.0 -",
    "macCatalyst: -",
    "macOS: 14.0.0 -",
    "tvOS: 17.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Cinematic",
  "identifier" : "/documentation/Cinematic",
  "metadataVersion" : "0.1.0",
  "role" : "Framework",
  "symbol" : {
    "kind" : "Framework",
    "modules" : [
      "Cinematic"
    ],
    "preciseIdentifier" : "Cinematic"
  },
  "title" : "Cinematic"
}
-->

# Cinematic

Integrate playback and editing of assets captured in Cinematic mode into your app.

## Overview

The Cinematic framework enables you to add professional-level editing and playback features to movies, recorded with the Camera app’s Cinematic mode, to your apps. These are the same features used in applications such as Final Cut Pro, Photos, and iMovie. For example, this enables your apps to change focus distance and aperture in movies, creating a bokeh effect, even after recording.

## Topics

### Essentials

[Playing and editing Cinematic mode video](/documentation/Cinematic/playing-and-editing-cinematic-mode-video)

Play and edit Cinematic mode video with an adjustable depth of field and focus points.

[`CNScript`](/documentation/Cinematic/CNScript-1ispe)

A collection of focus decisions, focus transitions, detections, and detection tracks associated with a movie captured in Cinematic mode and methods to change them.

[`CNScript`](/documentation/Cinematic/CNScript-9e1zn)

A collection of focus decisions, focus transitions, detections, and detection tracks associated with a movie captured in Cinematic mode and methods to change them.

[`CNScriptChanges`](/documentation/Cinematic/CNScriptChanges)

An object that represents a snapshot of the changes made to a movie script, including the added user decisions and detection tracks.

[`CNScriptFrame`](/documentation/Cinematic/CNScriptFrame)

An object that represents what to focus on, and where to focus, in a given movie frame.

### Reading and rendering

[`CNAssetInfo`](/documentation/Cinematic/CNAssetInfo-2ata2)

An object that provides Cinematic-specific information about an asset, including its tracks.

[`CNCompositionInfo`](/documentation/Cinematic/CNCompositionInfo-7eunn)

An object that enables you to add the appropriate number of tracks for a Cinematic asset.

[`CNRenderingSession`](/documentation/Cinematic/CNRenderingSession-1hzh8)

An object representing the context in which rendering occurs.

[`CNAssetInfo`](/documentation/Cinematic/CNAssetInfo-8ja4t)

An object that provides Cinematic-specific information about an asset, including its tracks.

[`CNCompositionInfo`](/documentation/Cinematic/CNCompositionInfo-vzoh)

An object that enables you to add the appropriate number of tracks for a Cinematic asset.

[`CNRenderingSession`](/documentation/Cinematic/CNRenderingSession-8yghc)

An object representing the context in which rendering occurs.

[`CNRenderingSessionAttributes`](/documentation/Cinematic/CNRenderingSessionAttributes)

A structure for movie-wide attributes required for proper rendering.

[`CNRenderingSessionFrameAttributes`](/documentation/Cinematic/CNRenderingSessionFrameAttributes)

Creates an object with the per frame attributes that control the appearance of a single frame of the Cinematic movie.

### Editing

[Editing Spatial Audio with an audio mix](/documentation/Cinematic/editing-spatial-audio-with-an-audio-mix)

Add Spatial Audio editing capabilities with the Audio Mix API in the Cinematic framework.

[`CNDetection`](/documentation/Cinematic/CNDetection-swift.struct)

A structure that represents a detected subject, face, torso or pet at a particular time.

[`CNDecision`](/documentation/Cinematic/CNDecision-swift.struct)

An object that represents a decision to focus on a particular detection, or group of detections, at a particular time.

[`CNDetectionTrack`](/documentation/Cinematic/CNDetectionTrack-2bxtd)

An object representing a series of detections of the same subject over time.

[`CNFixedDetectionTrack`](/documentation/Cinematic/CNFixedDetectionTrack-93rrw)

An object representing the fixed detection track.

[`CNCustomDetectionTrack`](/documentation/Cinematic/CNCustomDetectionTrack-9a2zo)

An object representing a discrete detection track composed of individual detections.

[`CNDetection`](/documentation/Cinematic/CNDetection-c.class)

A structure that represents a detected subject, face, torso or pet at a particular time.

[`CNDecision`](/documentation/Cinematic/CNDecision-c.class)

An object that represents a decision to focus on a particular detection, or group of detections, at a particular time.

[`CNDetectionTrack`](/documentation/Cinematic/CNDetectionTrack-61x7g)

An object representing a series of detections of the same subject over time.

[`CNFixedDetectionTrack`](/documentation/Cinematic/CNFixedDetectionTrack-5aei2)

An object representing the fixed detection track.

[`CNCustomDetectionTrack`](/documentation/Cinematic/CNCustomDetectionTrack-891hc)

An object representing a discrete detection track composed of individual detections.

[`CNDetectionType`](/documentation/Cinematic/CNDetectionType)

The type of object detected, such as face, torso, cat, dog and so on.

### Custom Object Tracking

[`CNBoundsPrediction`](/documentation/Cinematic/CNBoundsPrediction-swift.struct)

A structure representing the bounds of the predicted subject.

[`CNObjectTracker`](/documentation/Cinematic/CNObjectTracker-1n598)

An object that converts a normalized point or rectangle into a detection track that tracks an object over time.

[`CNObjectTracker`](/documentation/Cinematic/CNObjectTracker-7aliq)

An object that converts a normalized point or rectangle into a detection track that tracks an object over time.

[`CNBoundsPrediction`](/documentation/Cinematic/CNBoundsPrediction-c.class)

An object representing the bounds of the predicted subject.

### Structures

[`CNCinematicError`](/documentation/Cinematic/CNCinematicError)

### Reference

[Cinematic Enumerations](/documentation/Cinematic/Cinematic-enumerations)

[Cinematic Constants](/documentation/Cinematic/Cinematic-constants)

[Cinematic Data Types](/documentation/Cinematic/Cinematic-data-types)



---

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)