AVFoundation tvOS 15.4 to 16.0 API Differences

AVAsset.h

Added AVURLAssetHTTPUserAgentKey

Added AVURLAssetPrimarySessionIdentifierKey

Added AVURLAsset.httpSessionIdentifier

Modified -[AVAsset trackWithTrackID:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTrackWithTrackID:completionHandler:

Modified -[AVAsset tracksWithMediaType:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaType:completionHandler:

Modified -[AVAsset tracksWithMediaCharacteristic:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaCharacteristic:completionHandler:

Modified -[AVAsset metadataForFormat:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadMetadataForFormat:completionHandler:

Modified -[AVAsset chapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadChapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:completionHandler:

Modified -[AVAsset chapterMetadataGroupsBestMatchingPreferredLanguages:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadChapterMetadataGroupsBestMatchingPreferredLanguages:completionHandler

Modified -[AVAsset mediaSelectionGroupForMediaCharacteristic:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadMediaSelectionGroupForMediaCharacteristic:completionHandler:

Modified -[AVURLAsset compatibleTrackForCompositionTrack:]

	Availability	Replacement
From	Available	none
To	Deprecated	findCompatibleTrackForCompositionTrack:completionHandler:

Modified -[AVFragmentedAsset trackWithTrackID:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTrackWithTrackID:completionHandler:

Modified -[AVFragmentedAsset tracksWithMediaType:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaType:completionHandler:

Modified -[AVFragmentedAsset tracksWithMediaCharacteristic:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaCharacteristic:completionHandler:

AVAssetExportSession.h

Added AVAssetTrackGroupOutputHandling

Added AVAssetTrackGroupOutputHandlingNone

Added AVAssetTrackGroupOutputHandlingPreserveAlternateTracks

Added AVAssetTrackGroupOutputHandlingDefaultPolicy

Added AVAssetExportSession.audioTrackGroupHandling

Modified +[AVAssetExportSession exportPresetsCompatibleWithAsset:]

	Availability	Replacement
From	Available	none
To	Deprecated	determineCompatibilityOfExportPreset:withAsset:outputFileType:completionHandler:

AVAssetImageGenerator.h

Added -[AVAssetImageGenerator generateCGImageAsynchronouslyForTime:completionHandler:]

Modified -[AVAssetImageGenerator copyCGImageAtTime:actualTime:error:]

	Availability	Replacement
From	Available	none
To	Deprecated	generateCGImageAsynchronouslyForTime:completionHandler:

AVAssetPlaybackAssistant.h

Added AVAssetPlaybackConfigurationOption

Added AVAssetPlaybackConfigurationOptionStereoVideo

Added AVAssetPlaybackConfigurationOptionStereoMultiviewVideo

Added AVAssetPlaybackAssistant

Added +[AVAssetPlaybackAssistant assetPlaybackAssistantWithAsset:]

Added -[AVAssetPlaybackAssistant loadPlaybackConfigurationOptionsWithCompletionHandler:]

AVAssetReaderOutput.h

Removed AVAssetReaderOutputCaptionAdaptor (AVAssetReaderCaptionValidation)

Removed AVAssetReaderOutputCaptionAdaptor.validationDelegate

AVAssetResourceLoader.h

Added AVAssetResourceLoadingContentInformationRequest.entireLengthAvailableOnDemand

AVAssetTrack.h

Added AVAssetTrack.canProvideSampleCursors

Added -[AVAssetTrack makeSampleCursorWithPresentationTimeStamp:]

Added -[AVAssetTrack makeSampleCursorAtFirstSampleInDecodeOrder]

Added -[AVAssetTrack makeSampleCursorAtLastSampleInDecodeOrder]

Modified -[AVAssetTrack segmentForTrackTime:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadSegmentForTrackTime:completionHandler:

Modified -[AVAssetTrack samplePresentationTimeForTrackTime:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadSamplePresentationTimeForTrackTime:completionHandler:

Modified -[AVAssetTrack metadataForFormat:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadMetadataForFormat:completionHandler:

Modified -[AVAssetTrack associatedTracksOfType:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadAssociatedTracksOfType:completionHandler:

AVBase.h

Added #def AVF_DEPRECATED_FOR_SWIFT_ONLY

Added #def AVF_DEPLOYING_TO_2022_RELEASES_AND_LATER

AVComposition.h

Added -[AVMutableComposition insertTimeRange:ofAsset:atTime:completionHandler:]

Added -[AVComposition metadataForFormat:]

Added -[AVComposition chapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:]

Added -[AVComposition chapterMetadataGroupsBestMatchingPreferredLanguages:]

Added -[AVComposition mediaSelectionGroupForMediaCharacteristic:]

Added -[AVComposition unusedTrackID]

Modified -[AVMutableComposition insertTimeRange:ofAsset:atTime:error:]

	Availability	Replacement
From	Available	none
To	Deprecated	insertTimeRange:ofAsset:atTime:completionHandler:

AVCompositionTrack.h

Added -[AVCompositionTrack hasMediaCharacteristic:]

Added -[AVCompositionTrack samplePresentationTimeForTrackTime:]

Added -[AVCompositionTrack metadataForFormat:]

Added -[AVCompositionTrack associatedTracksOfType:]

AVError.h

Added AVErrorInvalidSampleCursor

Added AVErrorFailedToLoadSampleData

Added AVErrorAirPlayReceiverTemporarilyUnavailable

AVGeometry.h

Added NSValue (NSValueCMVideoDimensionsExtensions)

Added +[NSValue valueWithCMVideoDimensions:]

Added NSValue.CMVideoDimensionsValue

AVMovie.h

Added AVMutableMovie (SynchronousAssetInterface)

Added -[AVMutableMovie metadataForFormat:]

Added -[AVMutableMovie chapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:]

Added -[AVMutableMovie chapterMetadataGroupsBestMatchingPreferredLanguages:]

Added -[AVMutableMovie mediaSelectionGroupForMediaCharacteristic:]

Added -[AVMutableMovie unusedTrackID]

Modified -[AVMovie trackWithTrackID:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTrackWithTrackID:completionHandler:

Modified -[AVMovie tracksWithMediaType:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaType:completionHandler:

Modified -[AVMovie tracksWithMediaCharacteristic:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaCharacteristic:completionHandler:

Modified -[AVFragmentedMovie trackWithTrackID:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTrackWithTrackID:completionHandler:

Modified -[AVFragmentedMovie tracksWithMediaType:]

	Availability	Replacement
From	Available	none
To	Deprecated	loadTracksWithMediaType:completionHandler:

Modified -[AVFragmentedMovie tracksWithMediaCharacteristic:]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	loadTracksWithMediaCharacteristic:completionHandler:

AVMovieTrack.h

Added AVMutableMovieTrack (SynchronousTrackInterface)

Added -[AVMutableMovieTrack hasMediaCharacteristic:]

Added -[AVMutableMovieTrack segmentForTrackTime:]

Added -[AVMutableMovieTrack samplePresentationTimeForTrackTime:]

Added -[AVMutableMovieTrack metadataForFormat:]

Added -[AVMutableMovieTrack associatedTracksOfType:]

AVPlayer.h

Added AVPlayer.defaultRate

AVPlayerInterstitialEventController.h

Added AVPlayerInterstitialEventCue

Added AVPlayerInterstitialEventNoCue

Added AVPlayerInterstitialEventJoinCue

Added AVPlayerInterstitialEventLeaveCue

Added +[AVPlayerInterstitialEvent interstitialEventWithPrimaryItem:time:]

Added +[AVPlayerInterstitialEvent interstitialEventWithPrimaryItem:date:]

Added AVPlayerInterstitialEvent.alignsStartWithPrimarySegmentBoundary

Added AVPlayerInterstitialEvent.alignsResumptionWithPrimarySegmentBoundary

Added AVPlayerInterstitialEvent.cue

Added AVPlayerInterstitialEvent.willPlayOnce

Modified AVPlayerInterstitialEvent

	Protocols
From	none
To	NSCopying

Modified +[AVPlayerInterstitialEvent interstitialEventWithPrimaryItem:identifier:time:templateItems:restrictions:resumptionOffset:playoutLimit:userDefinedAttributes:]

	Availability	Replacement
From	Available	none
To	Deprecated	interstitialEventWithPrimaryItem:time:

Modified +[AVPlayerInterstitialEvent interstitialEventWithPrimaryItem:identifier:date:templateItems:restrictions:resumptionOffset:playoutLimit:userDefinedAttributes:]

	Availability	Replacement
From	Available	none
To	Deprecated	interstitialEventWithPrimaryItem:date:

Modified AVPlayerInterstitialEvent.primaryItem

	Declaration
From	@property (nonatomic, readonly, weak) AVPlayerItem *primaryItem
To	@property (nonatomic, readwrite, weak) AVPlayerItem *primaryItem

Modified AVPlayerInterstitialEvent.identifier

	Declaration
From	@property (nonatomic, readonly) NSString *identifier
To	@property (nonatomic, readwrite, copy) NSString *identifier

Modified AVPlayerInterstitialEvent.time

	Declaration
From	@property (nonatomic, readonly) CMTime time
To	@property (nonatomic, readwrite) CMTime time

Modified AVPlayerInterstitialEvent.date

	Declaration
From	@property (nonatomic, readonly) NSDate *date
To	@property (nonatomic, readwrite, copy) NSDate *date

Modified AVPlayerInterstitialEvent.templateItems

	Declaration
From	@property (nonatomic, readonly) NSArray<AVPlayerItem > templateItems
To	@property (nonatomic, readwrite, copy) NSArray<AVPlayerItem > templateItems

Modified AVPlayerInterstitialEvent.restrictions

	Declaration
From	@property (nonatomic, readonly) AVPlayerInterstitialEventRestrictions restrictions
To	@property (nonatomic, readwrite) AVPlayerInterstitialEventRestrictions restrictions

Modified AVPlayerInterstitialEvent.resumptionOffset

	Declaration
From	@property (nonatomic, readonly) CMTime resumptionOffset
To	@property (nonatomic, readwrite) CMTime resumptionOffset

Modified AVPlayerInterstitialEvent.playoutLimit

	Declaration
From	@property (nonatomic, readonly) CMTime playoutLimit
To	@property (nonatomic, readwrite) CMTime playoutLimit

Modified AVPlayerInterstitialEvent.userDefinedAttributes

	Declaration
From	@property (nonatomic, readonly) NSDictionary *userDefinedAttributes
To	@property (nonatomic, readwrite, copy) NSDictionary *userDefinedAttributes

Modified AVPlayerInterstitialEventMonitor.events

	Declaration
From	@property (readonly) NSArray<AVPlayerInterstitialEvent > events
To	@property (readonly, copy) NSArray<AVPlayerInterstitialEvent > events

AVSampleBufferGenerator.h

Added AVSampleBufferGenerator

Added -[AVSampleBufferGenerator initWithAsset:timebase:]

Added -[AVSampleBufferGenerator createSampleBufferForRequest:error:]

Added -[AVSampleBufferGenerator makeBatch]

Added -[AVSampleBufferGenerator createSampleBufferForRequest:addingToBatch:error:]

Added +[AVSampleBufferGenerator notifyOfDataReadyForSampleBuffer:completionHandler:]

Added AVSampleBufferRequest

Added -[AVSampleBufferRequest initWithStartCursor:]

Added AVSampleBufferRequest.startCursor

Added AVSampleBufferRequest.direction

Added AVSampleBufferRequest.limitCursor

Added AVSampleBufferRequest.preferredMinSampleCount

Added AVSampleBufferRequest.maxSampleCount

Added AVSampleBufferRequest.mode

Added AVSampleBufferRequest.overrideTime

Added AVSampleBufferGeneratorBatch

Added -[AVSampleBufferGeneratorBatch makeDataReadyWithCompletionHandler:]

Added -[AVSampleBufferGeneratorBatch cancel]

AVSampleCursor.h

Removed AVSampleCursor (AVSampleCursorTemporalPosition)

Removed AVSampleCursor (AVSampleCursorCurrentSampleInfo)

Removed AVSampleCursor (AVSampleCursorSampleStorageInfo)

Added AVSampleCursor

Added -[AVSampleCursor stepInDecodeOrderByCount:]

Added -[AVSampleCursor stepInPresentationOrderByCount:]

Added -[AVSampleCursor stepByDecodeTime:wasPinned:]

Added -[AVSampleCursor stepByPresentationTime:wasPinned:]

Added AVSampleCursor.currentSampleDependencyAttachments

Added AVSampleCursor.currentSampleAudioDependencyInfo

Added AVSampleCursor.samplesRequiredForDecoderRefresh

AVVideoComposition.h

Added +[AVVideoComposition videoCompositionWithPropertiesOfAsset:completionHandler:]

Added +[AVVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:completionHandler:]

Added +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:completionHandler:]

Added +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:prototypeInstruction:completionHandler:]

Added +[AVMutableVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:completionHandler:]

Added -[AVVideoComposition determineValidityForAsset:timeRange:validationDelegate:completionHandler:]

Modified +[AVVideoComposition videoCompositionWithPropertiesOfAsset:]

	Availability	Replacement
From	Available	none
To	Deprecated	videoCompositionWithPropertiesOfAsset:completionHandler:

Modified +[AVVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:]

	Availability	Replacement
From	Available	none
To	Deprecated	videoCompositionWithAsset:applyingCIFiltersWithHandler:completionHandler:

Modified +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:]

	Availability	Replacement
From	Available	none
To	Deprecated	videoCompositionWithPropertiesOfAsset:completionHandler:

Modified +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:prototypeInstruction:]

	Availability	Replacement
From	Available	none
To	Deprecated	videoCompositionWithPropertiesOfAsset:prototypeInstruction:completionHandler:

Modified +[AVMutableVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:]

	Availability	Replacement
From	Available	none
To	Deprecated	videoCompositionWithAsset:applyingCIFiltersWithHandler:completionHandler:

Modified -[AVAsset unusedTrackID]

	Availability	Replacement
From	Available	none
To	Deprecated	findUnusedTrackIDWithCompletionHandler:

Modified -[AVVideoComposition isValidForAsset:timeRange:validationDelegate:]

	Availability	Replacement
From	Available	none
To	Deprecated	determineValidityForAsset:timeRange:validationDelegate:completionHandler: