AVFoundation tvOS 15.4 to 16.0 API Differences

AVAsset.h

Added AVURLAssetHTTPUserAgentKey

Added AVURLAssetPrimarySessionIdentifierKey

Added AVURLAsset.httpSessionIdentifier

Modified -[AVAsset trackWithTrackID:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset tracksWithMediaType:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset tracksWithMediaCharacteristic:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset metadataForFormat:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset chapterMetadataGroupsWithTitleLocale:containingItemsWithCommonKeys:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset chapterMetadataGroupsBestMatchingPreferredLanguages:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset mediaSelectionGroupForMediaCharacteristic:]

	Availability
From	Available
To	Deprecated

Modified -[AVURLAsset compatibleTrackForCompositionTrack:]

	Availability
From	Available
To	Deprecated

Modified -[AVFragmentedAsset trackWithTrackID:]

	Availability
From	Available
To	Deprecated

Modified -[AVFragmentedAsset tracksWithMediaType:]

	Availability
From	Available
To	Deprecated

Modified -[AVFragmentedAsset tracksWithMediaCharacteristic:]

	Availability
From	Available
To	Deprecated

AVAssetExportSession.h

Added AVAssetTrackGroupOutputHandling

Added AVAssetTrackGroupOutputHandlingNone

Added AVAssetTrackGroupOutputHandlingPreserveAlternateTracks

Added AVAssetTrackGroupOutputHandlingDefaultPolicy

Added AVAssetExportSession.audioTrackGroupHandling

Modified +[AVAssetExportSession exportPresetsCompatibleWithAsset:]

	Availability
From	Available
To	Deprecated

AVAssetImageGenerator.h

Added -[AVAssetImageGenerator generateCGImageAsynchronouslyForTime:completionHandler:]

Modified -[AVAssetImageGenerator copyCGImageAtTime:actualTime:error:]

	Availability
From	Available
To	Deprecated

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
From	Available
To	Deprecated

Modified -[AVAssetTrack samplePresentationTimeForTrackTime:]

	Availability
From	Available
To	Deprecated

Modified -[AVAssetTrack metadataForFormat:]

	Availability
From	Available
To	Deprecated

Modified -[AVAssetTrack associatedTracksOfType:]

	Availability
From	Available
To	Deprecated

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
From	Available
To	Deprecated

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
From	Available
To	Deprecated

Modified -[AVMovie tracksWithMediaType:]

	Availability
From	Available
To	Deprecated

Modified -[AVMovie tracksWithMediaCharacteristic:]

	Availability
From	Available
To	Deprecated

Modified -[AVFragmentedMovie trackWithTrackID:]

	Availability
From	Available
To	Deprecated

Modified -[AVFragmentedMovie tracksWithMediaType:]

	Availability
From	Available
To	Deprecated

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
From	Available
To	Deprecated

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

	Availability
From	Available
To	Deprecated

Modified AVPlayerInterstitialEvent.primaryItem

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

Modified AVPlayerInterstitialEvent.identifier

	Declaration
From	@property (nonatomic, readonly, nonnull) NSString *identifier
To	@property (nonatomic, readwrite, copy, nonnull) 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, nullable) NSDate *date
To	@property (nonatomic, readwrite, copy, nullable) NSDate *date

Modified AVPlayerInterstitialEvent.templateItems

	Declaration
From	@property (nonatomic, readonly, nonnull) NSArray<AVPlayerItem > templateItems
To	@property (nonatomic, readwrite, copy, nonnull) 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, nonnull) NSDictionary *userDefinedAttributes
To	@property (nonatomic, readwrite, copy, nonnull) NSDictionary *userDefinedAttributes

Modified AVPlayerInterstitialEventMonitor.events

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

AVPlayerItem.h

Modified AVPlayerItem.videoComposition

	Declaration
From	@property (nonatomic, copy, nullable) AVVideoComposition *videoComposition
To	@property (nonatomic, copy, nullable) AVVideoComposition *videoComposition

Modified AVPlayerItem.customVideoCompositor

	Declaration
From	@property (nonatomic, readonly, nullable) id<AVVideoCompositing> customVideoCompositor
To	@property (nonatomic, readonly, nullable) id<AVVideoCompositing> customVideoCompositor

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

AVSynchronizedLayer.h

Modified AVSynchronizedLayer.playerItem

	Declaration
From	@property (nonatomic, retain, nullable) AVPlayerItem *playerItem
To	@property (nonatomic, retain, nullable) AVPlayerItem *playerItem

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
From	Available
To	Deprecated

Modified +[AVVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:]

	Availability
From	Available
To	Deprecated

Modified +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:]

	Availability
From	Available
To	Deprecated

Modified +[AVMutableVideoComposition videoCompositionWithPropertiesOfAsset:prototypeInstruction:]

	Availability
From	Available
To	Deprecated

Modified +[AVMutableVideoComposition videoCompositionWithAsset:applyingCIFiltersWithHandler:]

	Availability
From	Available
To	Deprecated

Modified -[AVAsset unusedTrackID]

	Availability
From	Available
To	Deprecated

Modified -[AVVideoComposition isValidForAsset:timeRange:validationDelegate:]

	Availability
From	Available
To	Deprecated