<!--
{
  "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/AVPlayerItemIntegratedTimeline",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVFoundation"
    ],
    "preciseIdentifier" : "c:objc(cs)AVPlayerItemIntegratedTimeline"
  },
  "title" : "AVPlayerItemIntegratedTimeline"
}
-->

# AVPlayerItemIntegratedTimeline

An object that models the timeline and playback sequence of a primary player item and scheduled interstitial events.

```
class AVPlayerItemIntegratedTimeline
```

## Overview

The timeline models all regions to traverse during playback. A player may not present portions of the primary item when exiting an interstitial event with a positive resumption offset.

## Topics

### Inspecting snapshots

[`currentSnapshot`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/currentSnapshot)

An immutable representation of the timeline state at time of request.

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

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

[`snapshotsOutOfSyncNotification`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/snapshotsOutOfSyncNotification)

A notification the system posts when the snapshot objects provided by this timeline become out of sync with the current timeline state.

### Inspecting the time and date

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

The current time on the integrated timeline.

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

The current date of playback.

### Seeking

[`seek(to:toleranceBefore:toleranceAfter:completionHandler:)`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/seek(to:toleranceBefore:toleranceAfter:completionHandler:))

Seeks to a particular time in the integrated time domain.

[`seek(to:completionHandler:)`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/seek(to:completionHandler:))

Seeks to a particular date in the integrated time domain.

### Observing time changes

[`periodicTimes(forInterval:)`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/periodicTimes(forInterval:))

Returns an asynchronous sequence of times periodically as playback progresses.

[`boundaryTimes(for:offsetsIntoSegment:)`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/boundaryTimes(for:offsetsIntoSegment:))

Returns an asynchronous sequence of times whenever playback reaches a segment time in the segment.

[`AVPlayerItemIntegratedTimeline.BoundaryTimes`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/BoundaryTimes)

An asynchronous sequence of boundary time values.

[`AVPlayerItemIntegratedTimeline.PeriodicTimes`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/PeriodicTimes)

An asynchronous sequence of periodic time values.

[`addPeriodicTimeObserverForInterval:queue:usingBlock:`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/addPeriodicTimeObserverForInterval:queue:usingBlock:)

Requests invocation of a block during playback to report changing time.

[`addBoundaryTimeObserverForSegment:offsetsIntoSegment:queue:usingBlock:`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/addBoundaryTimeObserverForSegment:offsetsIntoSegment:queue:usingBlock:)

Requests invocation of a block when traversing an offset in a segment during playback.

[`removeTimeObserver:`](/documentation/AVFoundation/AVPlayerItemIntegratedTimeline/removeTimeObserver:)

Cancels a previously registered time observer.

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

A protocol for objects that perform timeline observations.


---

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)