<!--
{
  "documentType" : "article",
  "framework" : "AVFoundation",
  "identifier" : "/documentation/AVFoundation/avassettrack-deprecated-symbols",
  "metadataVersion" : "0.1.0",
  "role" : "collectionGroup",
  "title" : "Deprecated symbols"
}
-->

# Deprecated symbols

Review unsupported symbols and their replacements.

## Discussion

[`AVAssetTrack`](/documentation/AVFoundation/AVAssetTrack) doesn’t support using its synchronous property accessors that can block the calling thread. Instead, use the [`load(_:isolation:)`](/documentation/AVFoundation/AVAsynchronousKeyValueLoading/load(_:isolation:)) method to load [`AVAsyncProperty`](/documentation/AVFoundation/AVAsyncProperty) values asynchronously.

## Topics

### Accessing track information

[`var formatDescriptions: [Any]`](/documentation/AVFoundation/AVAssetTrack/formatDescriptions)

The format descriptions of the media samples that a track references.

[`var isPlayable: Bool`](/documentation/AVFoundation/AVAssetTrack/isPlayable)

A Boolean value that indicates whether the track is playable in the current environment.

[`var isDecodable: Bool`](/documentation/AVFoundation/AVAssetTrack/isDecodable)

A Boolean value that indicates whether the track is decodable in the current environment.

[`var isEnabled: Bool`](/documentation/AVFoundation/AVAssetTrack/isEnabled)

A Boolean value that indicates whether the track’s container enables it.

[`var isSelfContained: Bool`](/documentation/AVFoundation/AVAssetTrack/isSelfContained)

A Boolean value that indicates whether this track references sample data only within its container file.

[`var totalSampleDataLength: Int64`](/documentation/AVFoundation/AVAssetTrack/totalSampleDataLength)

The total number of bytes of sample data the track requires.

[`func hasMediaCharacteristic(AVMediaCharacteristic) -> Bool`](/documentation/AVFoundation/AVAssetTrack/hasMediaCharacteristic(_:))

Returns a Boolean value that indicates whether the track references media with the specified media characteristic.

### Accessing temporal information

[`var timeRange: CMTimeRange`](/documentation/AVFoundation/AVAssetTrack/timeRange)

The time range of the track within the overall timeline of the asset.

[`var naturalTimeScale: CMTimeScale`](/documentation/AVFoundation/AVAssetTrack/naturalTimeScale)

The natural time scale of the media that a track references.

[`var estimatedDataRate: Float`](/documentation/AVFoundation/AVAssetTrack/estimatedDataRate)

The estimated data rate, in bits per second, of the media that the track references.

### Accessing language support

[`var languageCode: String?`](/documentation/AVFoundation/AVAssetTrack/languageCode)

The language code of the track.

[`var extendedLanguageTag: String?`](/documentation/AVFoundation/AVAssetTrack/extendedLanguageTag)

The language tag of the track.

### Accessing visual characteristics

[`var naturalSize: CGSize`](/documentation/AVFoundation/AVAssetTrack/naturalSize)

The natural dimensions of the media data that the track references.

[`var preferredTransform: CGAffineTransform`](/documentation/AVFoundation/AVAssetTrack/preferredTransform)

The track’s transform preference to apply to its visual content during presentation or processing.

### Accessing audible characteristics

[`var preferredVolume: Float`](/documentation/AVFoundation/AVAssetTrack/preferredVolume)

The track’s volume preference for playing its audible media.

[`var hasAudioSampleDependencies: Bool`](/documentation/AVFoundation/AVAssetTrack/hasAudioSampleDependencies)

A Boolean value that indicates whether the track has sample dependencies.

### Accessing frame-based characteristics

[`var nominalFrameRate: Float`](/documentation/AVFoundation/AVAssetTrack/nominalFrameRate)

The frame rate of the track, in frames per second.

[`var minFrameDuration: CMTime`](/documentation/AVFoundation/AVAssetTrack/minFrameDuration)

The minimum duration of the track’s frames.

[`var requiresFrameReordering: Bool`](/documentation/AVFoundation/AVAssetTrack/requiresFrameReordering)

A Boolean value that indicates whether samples in the track may have different presentation and decode timestamps.

### Accessing metadata

[`var metadata: [AVMetadataItem]`](/documentation/AVFoundation/AVAssetTrack/metadata)

An array of metadata items for all metadata identifiers that have a value.

[`var commonMetadata: [AVMetadataItem]`](/documentation/AVFoundation/AVAssetTrack/commonMetadata)

An array of metadata items for all common metadata keys that have a value.

[`var availableMetadataFormats: [AVMetadataFormat]`](/documentation/AVFoundation/AVAssetTrack/availableMetadataFormats)

An array of metadata formats available for the track.

[`func metadata(forFormat: AVMetadataFormat) -> [AVMetadataItem]`](/documentation/AVFoundation/AVAssetTrack/metadata(forFormat:))

Returns metadata items that a track contains for the specified format.

### Accessing track segments

[`var segments: [AVAssetTrackSegment]`](/documentation/AVFoundation/AVAssetTrack/segments)

The time mappings from the track’s media samples to its timeline.

[`func segment(forTrackTime: CMTime) -> AVAssetTrackSegment?`](/documentation/AVFoundation/AVAssetTrack/segment(forTrackTime:))

Retrieves a segment with a target time range that contains, or is closest to, the specified track time.

[`func samplePresentationTime(forTrackTime: CMTime) -> CMTime`](/documentation/AVFoundation/AVAssetTrack/samplePresentationTime(forTrackTime:))

Maps the specified track time through the appropriate time mapping and returns the resulting sample presentation time.

### Accessing track associations

[`var availableTrackAssociationTypes: [AVAssetTrack.AssociationType]`](/documentation/AVFoundation/AVAssetTrack/availableTrackAssociationTypes)

An array of association types that the track uses to associate with other tracks.

[`func associatedTracks(ofType: AVAssetTrack.AssociationType) -> [AVAssetTrack]`](/documentation/AVFoundation/AVAssetTrack/associatedTracks(ofType:))

Returns an array of associated tracks that have the specified association type.

### Creating sample cursors

[`var canProvideSampleCursors: Bool`](/documentation/AVFoundation/AVAssetTrack/canProvideSampleCursors)

A Boolean value that indicates whether the track can provide instances of sample cursors to traverse its media samples and discover information.



---

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)