AVFoundation tvOS xcode16.0 b4

#AVFoundation.framework

Manuel

diff -ruN /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetExportSession.h /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetExportSession.h
--- /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetExportSession.h	2024-06-29 01:51:36
+++ /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetExportSession.h	2024-07-17 00:39:51
@@ -264,7 +264,11 @@
 	@abstract					Cancels the execution of an export session.
 	@discussion					Cancel can be invoked when the export is running.
 */
-- (void)cancelExport;
+- (void)cancelExport
+#if defined(__swift__)
+API_DEPRECATED("Use Task.cancel() instead", macos(10.7, API_TO_BE_DEPRECATED), ios(4.0, API_TO_BE_DEPRECATED), tvos(9.0, API_TO_BE_DEPRECATED)) API_UNAVAILABLE(visionos)
+#endif
+;
 
 @end
 
diff -ruN /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVComposition.h /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVComposition.h
--- /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVComposition.h	2024-06-28 17:06:13
+++ /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVComposition.h	2024-07-17 00:33:07
@@ -205,7 +205,7 @@
     @param          timeRange
                     Specifies the timeRange of the asset to be inserted.
     @param          asset
-                    Specifies the asset that contains the tracks that are to be inserted. Only instances of AVURLAsset and AVComposition are supported (AVComposition starting in macOS 10.10 and iOS 8.0).
+                    Specifies the asset that contains the tracks that are to be inserted. Only instances of AVURLAsset and AVComposition are supported (AVComposition starting in macOS 10.10 and iOS 8.0). The asset should have its tracks loaded, and the tracks should have their formatDescriptions loaded before invoking this method to avoid blocking.
     @param          startTime
                     Specifies the time at which the inserted tracks are to be presented by the composition.
     @param          outError
@@ -218,7 +218,7 @@
       Existing content at the specified startTime will be pushed out by the duration of timeRange.
       Note that this operation only inserts one or more track segments into affected AVMutableCompositionTracks; it does not affect the values of other track properties, either to match the corresponding values of tracks in the source asset or for any other purpose.
 */
-- (BOOL)insertTimeRange:(CMTimeRange)timeRange ofAsset:(AVAsset *)asset atTime:(CMTime)startTime error:(NSError * _Nullable * _Nullable)outError API_DEPRECATED_WITH_REPLACEMENT("insertTimeRange:ofAsset:atTime:completionHandler:", macos(10.7, 15.0), ios(4.0, 18.0), tvos(9.0, 18.0), watchos(1.0, 11.0)) API_UNAVAILABLE(visionos);
+- (BOOL)insertTimeRange:(CMTimeRange)timeRange ofAsset:(AVAsset *)asset atTime:(CMTime)startTime error:(NSError * _Nullable * _Nullable)outError API_DEPRECATED_WITH_REPLACEMENT("insertTimeRange:ofAsset:atTime:completionHandler:", macos(10.7, 15.0), ios(4.0, 18.0), tvos(9.0, 18.0), watchos(1.0, 11.0), visionos(1.0, 2.0));
 
 /*!
 	@method         insertTimeRange:ofAsset:atTime:completionHandler:
@@ -238,25 +238,7 @@
 	  Existing content at the specified startTime will be pushed out by the duration of timeRange.
 	  Note that this operation only inserts one or more track segments into affected AVMutableCompositionTracks; it does not affect the values of other track properties, either to match the corresponding values of tracks in the source asset or for any other purpose.
 */
-- (void)insertTimeRange:(CMTimeRange)timeRange ofAsset:(AVAsset *)asset atTime:(CMTime)startTime completionHandler:(void (^ NS_SWIFT_SENDABLE)(NSError * _Nullable error))completionHandler API_DEPRECATED_WITH_REPLACEMENT("insertTimeRange:ofTracks:atTime:error:", macos(13.0, 15.0), ios(16.0, 18.0), tvos(16.0, 18.0), watchos(9.0, 11.0), visionos(1.0, 2.0));
-
-/*!
-	@method         insertTimeRange:ofTracks:atTime:completionHandler:
-	@abstract       Inserts all the tracks of a timeRange into a composition.
-	@param          timeRange
-					Specifies the timeRange of the asset to be inserted.
-	@param          tracks
-					Specifies the tracks that are to be inserted. Only tracks from instances of AVURLAsset and AVComposition are supported (AVComposition starting in macOS 10.10 and iOS 8.0).
-	@param          startTime
-					Specifies the time at which the inserted tracks are to be presented by the composition.
-	@discussion
-	  You provide a reference to a AVAssetTracks and the timeRange within it that you want to insert. You specify the start time in the destination composition at which the timeRange should be inserted.
-	  This method may add new tracks to ensure that all tracks of the asset are represented in the inserted timeRange.
-	  Note that the media data for the inserted timeRange will be presented at its natural duration and rate. It can be scaled to a different duration and presented at a different rate via -scaleTimeRange:toDuration:.
-	  Existing content at the specified startTime will be pushed out by the duration of timeRange.
-	  Note that this operation only inserts one or more track segments into affected AVMutableCompositionTracks; it does not affect the values of other track properties, either to match the corresponding values of tracks in the source asset or for any other purpose.
-*/
-- (BOOL)insertTimeRange:(CMTimeRange)timeRange ofTracks:(NSArray<AVAssetTrack *> *)tracks atTime:(CMTime)startTime error:(NSError * _Nullable * _Nullable)outError API_AVAILABLE(macos(15.0), ios(18.0), tvos(18.0), watchos(9.0), visionos(2.0));
+- (void)insertTimeRange:(CMTimeRange)timeRange ofAsset:(AVAsset *)asset atTime:(CMTime)startTime completionHandler:(void (^ NS_SWIFT_SENDABLE)(NSError * _Nullable error))completionHandler AVF_DEPRECATED_FOR_SWIFT_ONLY("Use insertTimeRange(_:of:at:isolation:) async instead", macos(13.0, 15.0), ios(16.0, 18.0), tvos(16.0, 18.0), watchos(9.0, 11.0), visionos(1.0, 2.0)) NS_SWIFT_DISABLE_ASYNC;
 
 /*!
     @method         insertEmptyTimeRange:
diff -ruN /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFoundation.apinotes /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFoundation.apinotes
--- /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFoundation.apinotes	2024-06-29 02:02:40
+++ /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFoundation.apinotes	2024-07-12 08:35:21
@@ -376,9 +376,6 @@
   - Selector: 'insertTimeRange:ofAsset:atTime:completionHandler:'
     SwiftName: insertTimeRange(_:of:at:completionHandler:)
     MethodKind: Instance
-  - Selector: 'insertTimeRange:ofTracks:atTime:error:'
-    SwiftName: insertTimeRange(_:of:at:)
-    MethodKind: Instance
   - Selector: 'insertEmptyTimeRange:'
     SwiftName: insertEmptyTimeRange(_:)
     MethodKind: Instance
diff -ruN /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVMetrics.h /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVMetrics.h
--- /Applications/Xcode_16.0.0-beta3.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVMetrics.h	2024-06-29 01:51:36
+++ /Applications/Xcode_16.0.0-beta4.app/Contents/Developer/Platforms/AppleTVOS.platform/Developer/SDKs/AppleTVOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVMetrics.h	2024-07-17 00:33:06
@@ -37,14 +37,14 @@
  @method publisher:didReceiveEvent:
  @abstract Delegate callback to receive metric events.
  @param event The metric event.
- @param publisher Publisher which genereated the current event.
+ @param publisher The publisher which generated the current event.
  */
 - (void)publisher:(id<AVMetricEventStreamPublisher>)publisher didReceiveEvent:(AVMetricEvent *)event;
 @end
 
 /*!
  @class AVMetricEventStream
- @abstract AVMetricEventStream allows clients to add publishers and then subscribe to specific metric event classes from those publishers. Publishers are AVFoundation instances implementing AVMetricEventStreamPublisher. The interface allows clients to receive metric events via a subscriber delegate which implement AVMetricEventStreamSubscriber.
+ @abstract AVMetricEventStream allows clients to add publishers and then subscribe to specific metric event classes from those publishers. Publishers are AVFoundation instances implementing AVMetricEventStreamPublisher. The interface allows clients to receive metric events via a subscriber delegate which implements AVMetricEventStreamSubscriber.
  */
 NS_REFINED_FOR_SWIFT
 API_AVAILABLE(macos(15), ios(18), tvos(18), watchos(11), visionos(2))
@@ -60,7 +60,7 @@
 
 /*!
  @method addPublisher:
- @abstract The publisher should be AVFoundation instance confirming to AVMetricEventStreamPublisher.
+ @abstract The publisher should be an AVFoundation instance conforming to AVMetricEventStreamPublisher.
  */
 - (BOOL)addPublisher:(id<AVMetricEventStreamPublisher>)publisher;
 
@@ -74,7 +74,7 @@
 
 /*!
  @method subscribeToMetricEvent:
- @abstract Subscribe to specific metric event class.
+ @abstract Subscribe to a specific metric event class.
  @param metricEventClass Type of metric event class to subscribe to.
  */
 - (void)subscribeToMetricEvent:(Class)metricEventClass;
@@ -213,13 +213,13 @@
 
 /*!
  @property errorEvent
- @abstract Returns the error event if any, encountered during the resource request. If no value is present, returns nil.
+ @abstract Returns the error event, if any, encountered during the resource request. If no value is present, returns nil.
  */
 @property (readonly, nullable) AVMetricErrorEvent *errorEvent;
 
 /*!
  @property networkTransactionMetrics
- @abstract Returns NSURLSessionTaskMetrics associated with the resource request. If no value is present, returns nil
+ @abstract Returns the NSURLSessionTaskMetrics associated with the resource request. If no value is present, returns nil
  */
 @property (readonly, nullable) NSURLSessionTaskMetrics *networkTransactionMetrics;
 @end
@@ -242,7 +242,7 @@
 
 /*!
  @property isMultivariantPlaylist
- @abstract Returns true if the playlist request is for multivariant playlist.
+ @abstract Returns true if the playlist request is for a multivariant playlist.
  */
 @property (readonly) BOOL isMultivariantPlaylist;
 
@@ -254,7 +254,7 @@
 
 /*!
  @property mediaResourceRequestEvent
- @abstract Returns the media resource request event which was used to satifiy the playlist.
+ @abstract Returns the media resource request event which was used to satisfy the playlist.
  */
 @property (readonly, nullable) AVMetricMediaResourceRequestEvent *mediaResourceRequestEvent;
 @end
@@ -277,7 +277,7 @@
 
 /*!
  @property isMapSegment
- @abstract Returns true if the media segment request is for map segment.
+ @abstract Returns true if the media segment request is for a map segment.
  */
 @property (readonly) BOOL isMapSegment;
 
@@ -330,7 +330,7 @@
 
 /*!
  @property isClientInitiated
- @abstract Returns whether the  content key resource request was initiated by the client.
+ @abstract Returns whether the content key resource request was initiated by the client.
  */
 @property (readonly) BOOL isClientInitiated;
 
@@ -375,8 +375,8 @@
 @end
 
 /*!
- @class AVMetricPlayerItemLikelyToKeepUpEvent
- @abstract Represents a metric event when playback was likely to play through without stalling.
+ @class AVMetricPlayerItemInitialLikelyToKeepUpEvent
+ @abstract Represents a metric event when playback was first likely to play through without stalling.
  @discussion Subclasses of this type that are used from Swift must fulfill the requirements of a Sendable type.
  */
 NS_SWIFT_SENDABLE
@@ -461,7 +461,7 @@
 @end
 
 /*!
- @class AVMetricPlayerItemSeekEvent
+ @class AVMetricPlayerItemSeekDidCompleteEvent
  @abstract Represents a metric event when playback seek completed.
  @discussion Subclasses of this type that are used from Swift must fulfill the requirements of a Sendable type.
  */
@@ -472,7 +472,7 @@
 
 /*!
  @property didSeekInBuffer
- @abstract Returns  whether the seek was performed within the available buffer.
+ @abstract Returns whether the seek was performed within the available buffer.
  */
 @property (readonly) BOOL didSeekInBuffer;
 
@@ -568,7 +568,7 @@
 
 /*!
  @property recoverableErrorCount
- @abstract Returns the total number of recoverable errors.
+ @abstract Returns the total count of recoverable errors encountered during playback. If no errors were encountered, returns 0.
  */
 @property (readonly) NSInteger recoverableErrorCount;