<!--
{
  "availability" : [
    "iOS: 18.0.0 -",
    "iPadOS: 18.0.0 -",
    "macCatalyst: 18.0.0 -",
    "macOS: 15.0.0 -",
    "tvOS: 18.0.0 -",
    "visionOS: 2.0.0 -",
    "watchOS: 11.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVPlayerItemIntegratedTimelineSnapshot"
  },
  "title" : "AVPlayerItemIntegratedTimelineSnapshot"
}
-->

# AVPlayerItemIntegratedTimelineSnapshot

An immutable representation of inspectable details of an integrated timeline object.

```
class AVPlayerItemIntegratedTimelineSnapshot
```

## Overview

A snapshot doesn’t reflect the new timeline state as playback progresses. You can request a new snapshot instance from an [`AVPlayerItemIntegratedTimeline`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline) that reflect the latest timeline state.

## Topics

### Inspecting the snapshot

[`duration`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/duration)

The total duration of the primary item and scheduled interstitial events.

[`currentSegment`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/currentSegment)

The currently playing segment.

[`segments`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/segments)

The segments for this snapshot.

[`AVPlayerItemSegment`](/documentation/AVFoundation/AVPlayerItemSegment)

An immutable object that represents a segment of time on the integrated timeline.

[`currentTime`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/currentTime)

The current time on the integrated timeline when the system created the snapshot.

[`currentDate`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/currentDate)

The current date on the integrated timeline when the system created the snapshot.

### Time mapping

[`segmentAndOffsetIntoSegment(forTimelineTime:)`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/segmentAndOffsetIntoSegment(forTimelineTime:))

[`mapTime:toSegment:atSegmentOffset:`](/documentation/AVFoundation/AVPlayerItemIntegratedTimelineSnapshot/mapTime:toSegment:atSegmentOffset:)


---

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)