<!--
{
  "availability" : [
    "tvOS: -",
    "visionOS: -"
  ],
  "documentType" : "symbol",
  "framework" : "AVKit",
  "identifier" : "/documentation/AVKit/AVInterfaceTimelineSegment",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "AVKit"
    ],
    "preciseIdentifier" : "c:objc(cs)AVInterfaceTimelineSegment"
  },
  "title" : "AVInterfaceTimelineSegment"
}
-->

# AVInterfaceTimelineSegment

Represents a contiguous segment of timeline content with specific playback characteristics.

```
@interface AVInterfaceTimelineSegment : NSObject
```

## Overview

Timeline segments divide media content into distinct regions, each with its own classification
and behavior rules. Segments are typically used to distinguish between primary content and
auxiliary content such as advertisements or bonus material, and to control whether users can
seek or skip through specific portions of the timeline.

## Topics

### Instance Properties

[`@property (nonatomic, readonly, getter=isAuxiliaryContent) BOOL auxiliaryContent;`](/documentation/AVKit/AVInterfaceTimelineSegment/auxiliaryContent)

Indicates whether this segment consists of auxiliary or main content. Returns YES for auxiliary content, such as advertisements, interludes, or bonus material, and NO for main content, such as the main program material.

[`@property (nonatomic, copy, readonly, nullable) NSString * identifier;`](/documentation/AVKit/AVInterfaceTimelineSegment/identifier)

Optional external identifier for tracking or analytics purposes. May correspond to advertisement IDs, chapter markers, or other external systems.

[`@property (nonatomic, readonly, getter=isMarked) BOOL marked;`](/documentation/AVKit/AVInterfaceTimelineSegment/marked)

Indicates whether this segment should be visually highlighted or marked in the timeline UI.

[`@property (nonatomic, readonly) BOOL requiresLinearPlayback;`](/documentation/AVKit/AVInterfaceTimelineSegment/requiresLinearPlayback)

Indicates whether this segment must be played sequentially without seeking or skipping. Typically used for advertisements or important announcements.

[`@property (nonatomic, readonly) CMTimeRange timeRange;`](/documentation/AVKit/AVInterfaceTimelineSegment/timeRange)

The time range defining the segment’s position and duration within the overall timeline.

### Instance Methods

[`- (instancetype) initWithTimeRange:(CMTimeRange) timeRange auxiliaryContent:(BOOL) auxiliaryContent marked:(BOOL) marked requiresLinearPlayback:(BOOL) requiresLinearPlayback identifier:(NSString *) identifier;`](/documentation/AVKit/AVInterfaceTimelineSegment/initWithTimeRange:auxiliaryContent:marked:requiresLinearPlayback:identifier:)

Initializes a new timeline segment with the specified characteristics.

## Relationships

### Conforms To

[`NSSecureCoding`](/documentation/Foundation/NSSecureCoding)

[`NSCopying`](/documentation/Foundation/NSCopying)

### Inherits From

[`NSObject-swift.class`](/documentation/ObjectiveC/NSObject-swift.class)

---

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)