AVFoundation macOS 12.3 to 13.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:]

AVAssetResourceLoader.h

Added AVAssetResourceLoadingContentInformationRequest.entireLengthAvailableOnDemand

AVAssetTrack.h

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

AVCaption.h

Added -[AVCaptionRegion encodeWithCoder:]

Added -[AVCaptionRegion isEqual:]

Added -[AVCaptionRegion mutableCopyWithZone:]

AVCaptureDevice.h

Added AVCaptureDeviceTypeDeskViewCamera

Added AVCaptureDevice.userPreferredCamera

Added AVCaptureDevice.systemPreferredCamera

Added AVCaptureDevice.continuityCamera

Added AVCaptureDevice.companionDeskViewCamera

Added AVCaptureDevice.studioLightEnabled

Added AVCaptureDevice.studioLightActive

Added AVCaptureDeviceFormat.studioLightSupported

Added AVCaptureDeviceFormat.videoFrameRateRangeForStudioLight

AVCaptureMetadataOutput.h

Added AVCaptureMetadataOutput

Added -[AVCaptureMetadataOutput init]

Added +[AVCaptureMetadataOutput new]

Added -[AVCaptureMetadataOutput setMetadataObjectsDelegate:queue:]

Added AVCaptureMetadataOutput.metadataObjectsDelegate

Added AVCaptureMetadataOutput.metadataObjectsCallbackQueue

Added AVCaptureMetadataOutput.availableMetadataObjectTypes

Added AVCaptureMetadataOutput.metadataObjectTypes

Added AVCaptureMetadataOutput.rectOfInterest

Added AVCaptureMetadataOutputObjectsDelegate

Added -[AVCaptureMetadataOutputObjectsDelegate captureOutput:didOutputMetadataObjects:fromConnection:]

AVCapturePhotoOutput.h

Added AVCapturePhotoQualityPrioritizationSpeed

Added AVCapturePhotoQualityPrioritizationBalanced

Added AVCapturePhotoQualityPrioritizationQuality

Added AVCapturePhotoOutput.maxPhotoQualityPrioritization

Added AVCapturePhotoOutput.supportedFlashModes

Added AVCapturePhotoSettings.flashMode

Added AVCapturePhotoSettings.photoQualityPrioritization

Added AVCapturePhotoSettings.highResolutionPhotoEnabled

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 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 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 createSampleBufferForRequest:error:]

Added -[AVSampleBufferGenerator makeBatch]

Added -[AVSampleBufferGenerator createSampleBufferForRequest:addingToBatch:error:]

Added AVSampleBufferGeneratorBatch

Added -[AVSampleBufferGeneratorBatch makeDataReadyWithCompletionHandler:]

Added -[AVSampleBufferGeneratorBatch cancel]

Modified -[AVSampleBufferGenerator createSampleBufferForRequest:]

	Availability	Deprecation Message
From	Available	none
To	Deprecated	Use -createSampleBufferForRequest: error:, passing NULL for the error if not required

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: