Skip to content

AVFoundation iOS xcode15.0 rc

Manuel de la Pena edited this page Nov 1, 2023 · 2 revisions

#AVFoundation.framework

mandel

diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetWriter.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetWriter.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetWriter.h	2023-08-22 07:46:47
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVAssetWriter.h	2023-08-19 00:01:27
@@ -401,6 +401,8 @@
  @discussion
 	When movie fragments are used, a partially written asset whose writing is unexpectedly interrupted can be successfully opened and played up to multiples of the specified time interval. The default value of this property is kCMTimeInvalid, which indicates that movie fragments should not be used.
 
+	When using movie fragments, for best writing performance to external storage devices, set the movieFragmentInterval to 10 seconds or greater.
+
 	This property cannot be set after writing has started.
  */
 @property (nonatomic) CMTime movieFragmentInterval;
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureDevice.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureDevice.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureDevice.h	2023-08-22 13:50:58
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureDevice.h	2023-08-19 21:19:42
@@ -57,6 +57,7 @@
 @class AVCaptureDeviceInputSource;
 @class AVCaptureSystemPressureState;
 @class AVCaptureDeviceInternal;
+@class AVZoomRange;
 
 /*!
  @class AVCaptureDevice
@@ -2023,18 +2024,21 @@
  @enum AVCaptureColorSpace
  @abstract
     Constants indicating active or supported video color space.
-
+ 
  @constant AVCaptureColorSpace_sRGB
     The sRGB color space ( https://www.w3.org/Graphics/Color/srgb )
  @constant AVCaptureColorSpace_P3_D65
     The P3 D65 wide color space which uses Illuminant D65 as the white point.
  @constant AVCaptureColorSpace_HLG_BT2020
     The BT2020 wide color space which uses Illuminant D65 as the white point and Hybrid Log-Gamma as the transfer function.
+ @constant AVCaptureColorSpace_AppleLog
+    The Apple Log Color space, which uses BT2020 as the color primaries, and an Apple defined Log curve as a transfer function. When this is set as the active color space on an AVCaptureDevice, any AVCapturePhotoOutput or AVCaptureStillImageOutput connected to the same AVCaptureDevice will have its video connection disabled.
  */
 typedef NS_ENUM(NSInteger, AVCaptureColorSpace) {
     AVCaptureColorSpace_sRGB       = 0,
     AVCaptureColorSpace_P3_D65     = 1,
     AVCaptureColorSpace_HLG_BT2020 API_AVAILABLE(ios(14.1), macCatalyst(14.1), tvos(17.0)) API_UNAVAILABLE(macos, visionos) = 2,
+    AVCaptureColorSpace_AppleLog API_AVAILABLE(ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(macos, visionos) = 3,
 } API_AVAILABLE(macos(10.15), ios(10.0), macCatalyst(14.0), tvos(17.0)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos);
 
 
@@ -2681,6 +2685,8 @@
     Indicates that video should be stabilized using the cinematic stabilization algorithm for more dramatic results. Cinematic video stabilization has a reduced field of view compared to standard video stabilization. Enabling cinematic video stabilization introduces much more latency into the video capture pipeline than standard video stabilization and consumes significantly more system memory. Use narrow or identical min and max frame durations in conjunction with this mode.
  @constant AVCaptureVideoStabilizationModeCinematicExtended
     Indicates that the video should be stabilized using the extended cinematic stabilization algorithm. Enabling extended cinematic stabilization introduces longer latency into the video capture pipeline compared to the AVCaptureVideoStabilizationModeCinematic and consumes more memory, but yields improved stability. It is recommended to use identical or similar min and max frame durations in conjunction with this mode.
+ @constant AVCaptureVideoStabilizationModePreviewOptimized
+    Indicates that video should be stabilized using the preview optimized stabilization algorithm. Preview stabilization is a low latency and low power algorithm which is supported only on connections which either have an associated preview layer or have a preview-sized VideoDataOutput.
  @constant AVCaptureVideoStabilizationModeAuto
     Indicates that the most appropriate video stabilization mode for the device and format should be chosen.
  */
@@ -2689,6 +2695,7 @@
     AVCaptureVideoStabilizationModeStandard  = 1,
     AVCaptureVideoStabilizationModeCinematic = 2,
     AVCaptureVideoStabilizationModeCinematicExtended API_AVAILABLE(ios(13.0), macCatalyst(14.0), tvos(17.0)) API_UNAVAILABLE(visionos) = 3,
+    AVCaptureVideoStabilizationModePreviewOptimized API_AVAILABLE(ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(macos, visionos) = 4,
     AVCaptureVideoStabilizationModeAuto      = -1,
 } API_AVAILABLE(ios(8.0), macCatalyst(14.0), tvos(17.0)) API_UNAVAILABLE(macos, visionos) API_UNAVAILABLE(watchos);
 
@@ -2966,7 +2973,7 @@
  @discussion
     Virtual devices support limited zoom factors when delivering depth data to any output. If this device format has no -supportedDepthDataFormats, this property returns an empty array.
  */
-@property(nonatomic, readonly) NSArray<NSNumber *> *supportedVideoZoomFactorsForDepthDataDelivery API_AVAILABLE(ios(16.0), macCatalyst(16.0), tvos(17.0)) API_UNAVAILABLE(macos, visionos) API_UNAVAILABLE(watchos) NS_REFINED_FOR_SWIFT;
+@property(nonatomic, readonly) NSArray<NSNumber *> *supportedVideoZoomFactorsForDepthDataDelivery API_DEPRECATED_WITH_REPLACEMENT("supportedVideoZoomRangesForDepthDataDelivery", ios(16.0, 17.0), macCatalyst(16.0, 17.0), tvos(17.0, 18.0)) API_UNAVAILABLE(macos, visionos) API_UNAVAILABLE(watchos) NS_REFINED_FOR_SWIFT;
 
 
 
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureFileOutput.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureFileOutput.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureFileOutput.h	2023-08-22 23:15:44
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureFileOutput.h	2023-08-19 21:30:42
@@ -389,11 +389,13 @@
  @property movieFragmentInterval
  @abstract
     Specifies the frequency with which movie fragments should be written.
-
+ 
  @discussion
     When movie fragments are used, a partially written QuickTime movie file whose writing is unexpectedly interrupted can be successfully opened and played up to multiples of the specified time interval. A value of kCMTimeInvalid indicates that movie fragments should not be used, but that only a movie atom describing all of the media in the file should be written. The default value of this property is ten seconds.
-
+ 
     Changing the value of this property will not affect the movie fragment interval of the file currently being written, if there is one.
+
+    For best writing performance on external storage devices, set the movieFragmentInterval to 10 seconds or greater.
  */
 @property(nonatomic) CMTime movieFragmentInterval;
 
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCapturePhotoOutput.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCapturePhotoOutput.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCapturePhotoOutput.h	2023-08-22 12:02:48
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCapturePhotoOutput.h	2023-08-20 23:07:01
@@ -61,17 +61,17 @@
  @method capturePhotoWithSettings:delegate:
  @abstract
     Method for initiating a photo capture request with progress monitoring through the supplied delegate.
-
+ 
  @param settings
     An AVCapturePhotoSettings object you have configured. May not be nil.
  @param delegate
     An object conforming to the AVCapturePhotoCaptureDelegate protocol. This object's delegate methods are called back as the photo advances from capture to processing to finished delivery. May not be nil.
-
+ 
  @discussion
     This method initiates a photo capture. The receiver copies your provided settings to prevent unintentional mutation. It is illegal to re-use settings. The receiver throws a NSInvalidArgumentException if your settings.uniqueID matches that of any previously used settings. This method is used to initiate all flavors of photo capture: single photo, RAW capture with or without a processed image (such as a JPEG), bracketed capture, and Live Photo.
-
+ 
     Clients need not wait for a capture photo request to complete before issuing another request. This is true for single photo captures as well as Live Photos, where movie complements of adjacent photo captures are allowed to overlap.
-
+ 
     This method validates your settings and enforces the following rules in order to ensure deterministic behavior. If any of these rules are violated, a NSInvalidArgumentException is thrown.
     RAW rules:
         See +isBayerRAWPixelFormat: and +isAppleProRAWPixelFormat: on the difference between Bayer RAW and Apple ProRAW pixel formats.
@@ -110,6 +110,8 @@
         - For auto exposure brackets, exposureTargetBias value must be within the source device's minExposureTargetBias and maxExposureTargetBias values.
     Deferred Photo Delivery rules:
      - If the receiver's autoDeferredPhotoDeliveryEnabled is YES, your delegate must respond to -captureOutput:didFinishCapturingDeferredPhotoProxy:error:.
+    Color space rules:
+        - Photo capture is not supported when AVCaptureDevice has selected AVCaptureColorSpace_AppleLog as color space.
 */
 - (void)capturePhotoWithSettings:(AVCapturePhotoSettings *)settings delegate:(id<AVCapturePhotoCaptureDelegate>)delegate;
 
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureSystemPressure.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureSystemPressure.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureSystemPressure.h	2023-08-22 08:43:47
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureSystemPressure.h	2023-08-20 23:07:01
@@ -63,12 +63,15 @@
     Indicates that the system's peak power requirements exceed the battery's current capacity and may result in a system power off.
  @constant AVCaptureSystemPressureFactorDepthModuleTemperature
     Indicates that the module capturing depth information is operating at an elevated temperature. As system pressure increases, depth quality may become degraded.
+ @constant AVCaptureSystemPressureFactorCameraTemperature
+    Indicates that the camera module is operating at an elevated temperature.
  */
 typedef NS_OPTIONS(NSUInteger, AVCaptureSystemPressureFactors) {
     AVCaptureSystemPressureFactorNone                   = 0UL,
     AVCaptureSystemPressureFactorSystemTemperature      = (1UL << 0),
     AVCaptureSystemPressureFactorPeakPower              = (1UL << 1),
     AVCaptureSystemPressureFactorDepthModuleTemperature = (1UL << 2),
+    AVCaptureSystemPressureFactorCameraTemperature API_AVAILABLE(ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(macos) API_UNAVAILABLE(watchos) = (1UL << 3),
 } API_AVAILABLE(ios(11.1), macCatalyst(14.0), tvos(17.0)) API_UNAVAILABLE(macos, visionos) API_UNAVAILABLE(watchos);
 
 @class AVCaptureSystemPressureStateInternal;
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureVideoDataOutput.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureVideoDataOutput.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureVideoDataOutput.h	2023-08-22 06:32:26
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVCaptureVideoDataOutput.h	2023-08-19 21:19:42
@@ -149,6 +149,38 @@
  */
 - (nullable NSDictionary<NSString *, id> *)recommendedVideoSettingsForVideoCodecType:(AVVideoCodecType)videoCodecType assetWriterOutputFileType:(AVFileType)outputFileType API_AVAILABLE(macos(10.15), ios(11.0), macCatalyst(14.0), tvos(17.0)) API_UNAVAILABLE(visionos);
 
+/*!
+ @method recommendedVideoSettingsForVideoCodecType:assetWriterOutputFileType:outputFileURL:
+ @abstract
+	Specifies the recommended settings for a particular video codec type with output file URL, to be used with an AVAssetWriterInput.
+
+ @param videoCodecType
+	Specifies the desired AVVideoCodecKey to be used for compression (see AVVideoSettings.h).
+ @param outputFileType
+	Specifies the UTI of the file type to be written (see AVMediaFormat.h for a list of file format UTIs).
+ @param outputFileURL
+	Specifies the output URL of the file to be written.
+
+	If you wish to capture onto an external storage device get an externalStorageDevice of type AVExternalStorageDevice (as defined in AVExternalStorageDevice.h):
+		[AVExternalStorageDeviceDiscoverySession sharedSession] externalStorageDevices]
+
+	Then use [externalStorageDevice nextAvailableURLsWithPathExtensions:pathExtensions error:&error] to get the output file URL.
+
+ @result
+	A fully populated dictionary of keys and values that are compatible with AVAssetWriter.
+
+ @discussion
+	The value of this property is an NSDictionary containing values for compression settings keys defined in AVVideoSettings.h. This dictionary is suitable for use as the "outputSettings" parameter when creating an AVAssetWriterInput, such as,
+
+	   [AVAssetWriterInput assetWriterInputWithMediaType:AVMediaTypeVideo outputSettings:outputSettings sourceFormatHint:hint];
+
+	The dictionary returned contains all necessary keys and values needed by AVAssetWriter (see AVAssetWriterInput.h, -initWithMediaType:outputSettings: for a more in depth discussion). For QuickTime movie and ISO file types, the recommended video settings will produce output comparable to that of AVCaptureMovieFileOutput.
+
+	The videoCodecType string provided must be present in the availableVideoCodecTypesForAssetWriterWithOutputFileType: array, or an NSInvalidArgumentException is thrown.
+
+	Note that the dictionary of settings is dependent on the current configuration of the receiver's AVCaptureSession and its inputs. The settings dictionary may change if the session's configuration changes. As such, you should configure your session first, then query the recommended video settings. As of iOS 8.3, movies produced with these settings successfully import into the iOS camera roll and sync to and from like devices via iTunes.
+ */
+- (nullable NSDictionary<NSString *, id> *)recommendedVideoSettingsForVideoCodecType:(AVVideoCodecType)videoCodecType assetWriterOutputFileType:(AVFileType)outputFileType outputFileURL:(nullable NSURL *)outputFileURL API_AVAILABLE(macos(14.0), ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos);
 
 /*!
  @property availableVideoCVPixelFormatTypes
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVExternalStorageDevice.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVExternalStorageDevice.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVExternalStorageDevice.h	1969-12-31 19:00:00
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVExternalStorageDevice.h	2023-08-09 02:57:54
@@ -0,0 +1,206 @@
+#if !__has_include(<AVFCapture/AVExternalStorageDevice.h>)
+/*
+    File:  AVExternalStorageDevice.h
+ 
+    Framework:  AVFoundation
+ 
+    Copyright 2022-2023 Apple Inc. All rights reserved.
+*/
+
+#import <AVFoundation/AVFCapture.h>
+
+NS_ASSUME_NONNULL_BEGIN
+
+#pragma mark - AVExternalStorageDevice
+
+/*!
+ @class AVExternalStorageDevice
+ @abstract
+	An AVExternalStorageDevice represents a physical external storage device connected to the device that can be used to store captured media assets.
+
+ @discussion
+	Each instance of AVExternalStorageDevice corresponds to a physical external storage device where captured media assets can be stored. Instances of AVExternalStorageDevice cannot be created directly. An array of all currently available external storage devices can be obtained using AVExternalStorageDeviceDiscoverySession.
+
+	Instances of AVExternalStorageDevice can be used with AVCaptureFileOutput subclasses for writing media files.
+ */
+API_AVAILABLE(macos(14.0), ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos)
+@interface AVExternalStorageDevice : NSObject
+
+AV_INIT_UNAVAILABLE
+
+/*!
+ @property displayName
+ @abstract
+	Display name of the external storage device.
+
+ @discussion
+	This property can be used for displaying the name of an external storage device in a user interface. Will return nil if we fail to extract information from external storage device.
+ */
+@property(nullable, nonatomic, readonly) NSString *displayName;
+
+/*!
+ @property freeSize
+ @abstract
+	Current free size in bytes.
+
+ @discussion
+	This property represents the free size available on the external storage device. Will return -1 if we fail to extract information from external storage device.
+
+ */
+@property(nonatomic, readonly) NSInteger freeSize;
+
+/*!
+ @property totalSize
+ @abstract
+	Total storage size in bytes.
+
+ @discussion
+	This property represents the total storage size available on the external storage device. Will return -1 if we fail to extract information from external storage device.
+
+ */
+@property(nonatomic, readonly) NSInteger totalSize;
+
+/*!
+ @property connected
+ @abstract
+	Indicates whether the external storage device is connected and available to the system.
+
+ @discussion
+	The property gives the current connection status of the external storage device.
+
+ */
+@property(nonatomic, readonly, getter=isConnected) BOOL connected;
+
+/*!
+ @property uuid
+ @abstract
+	A unique identifier for external storage device.
+
+ @discussion
+	This property can be used to select a specific external storage device with ImageCapture framework APIs to read media assets. Will return nil if we fail to extract information from external storage device.
+	For example the string value of this property will match the value from [ICDevice UUIDString].
+ */
+@property(nullable, nonatomic, readonly) NSUUID *uuid;
+
+/*!
+ @property notRecommendedForCaptureUse
+ @abstract
+    Indicates whether the external storage device is not recommended for capture use.
+
+ @discussion
+    This property is used to let the client know if the external storage device is not suitable for camera capture.
+ */
+@property(nonatomic, readonly, getter=isNotRecommendedForCaptureUse) BOOL notRecommendedForCaptureUse;
+
+/*!
+ @method nextAvailableURLsWithPathExtensions:error:
+ @abstract
+	Next available security-scoped, DCF compliant URL array with different path extensions.
+
+ @param extensionArray
+	An array of path extensions for the next available URL requested.
+ @param outError
+	An out parameter with error information indicating why the URL could not be provided. If this method is successful, error will be nil.
+ @result
+	An array of DCF compliant security-scoped URL with all the path extensions requested.
+
+ @discussion
+	Configures the folder structure (create a DCIM folder if there isn't one already) on the external storage device to provide the next available unique DCF compliant security-scoped URL array with different path extensions.
+
+	Security-scoped URL requires the use of startAccessingSecurityScopedResource, and stopAccessingSecurityScopedResource for access.
+	[nextAvailableURL startAccessingSecurityScopedResource];
+	. . .
+	// your code to capture image / video
+	. . .
+	[nextAvailableURL stopAccessingSecurityScopedResource];
+
+	Use the +requestAccessWithCompletionHandler: method to request access to external storage device before getting the next available URL array else an error will be thrown.
+ */
+- (nullable NSArray<NSURL *> *)nextAvailableURLsWithPathExtensions:(nonnull NSArray<NSString *> *)extensionArray error:(NSError * _Nullable * _Nullable)outError;
+
+@end
+
+API_AVAILABLE(macos(14.0), ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos)
+@interface AVExternalStorageDevice (AVExternalStorageDeviceAuthorization)
+
+/*!
+ @property authorizationStatus
+ @abstract
+	Returns the client's authorization status for capturing onto an external storage device connected to this device.
+
+ @discussion
+	This method returns the AVAuthorizationStatus of the client for capturing onto an external storage device connected to this device. If the status is AVAuthorizationStatusNotDetermined, you may use the +requestAccessWithCompletionHandler: method to request access by prompting the user.
+ */
+@property(class, readonly) AVAuthorizationStatus authorizationStatus;
+
+/*!
+ @method requestAccessWithCompletionHandler:
+ @abstract
+	Requests access to capture onto an external storage device connected to this device, showing a dialog to the user if necessary.
+
+ @param handler
+	A completion handler block called with the result of requesting access to capture onto an external storage device.
+
+ @discussion
+	Use this method to request access to capture onto an external storage device connected to this device.
+
+	This call will not block while the user is being asked for access, allowing the client to continue running. Until access has been granted, trying to capture into detected external storage devices will result in an error. The user is only asked for permission the first time the client requests access, later calls use the authorization status selected by the user.
+
+	The completion handler is called on an arbitrary dispatch queue. It is the client's responsibility to ensure that any UIKit-related updates are called on the main queue or main thread as a result.
+ */
++ (void)requestAccessWithCompletionHandler:(void (^)(BOOL granted))handler;
+
+@end
+
+#pragma mark - AVExternalStorageDeviceDiscoverySession
+
+/*!
+ @class AVExternalStorageDeviceDiscoverySession
+ @abstract
+	AVExternalStorageDeviceDiscoverySession is used to monitor connection / disconnection of external storage devices to the device.
+
+ @discussion
+	AVExternalStorageDeviceDiscoverySession is a singleton that lists the external storage devices connected to this device. The client is expected to key-value observe the externalStorageDevices property for changes to the external storage devices list.
+ */
+API_AVAILABLE(macos(14.0), ios(17.0), macCatalyst(17.0), tvos(17.0)) API_UNAVAILABLE(visionos) API_UNAVAILABLE(watchos)
+@interface AVExternalStorageDeviceDiscoverySession : NSObject
+
+AV_INIT_UNAVAILABLE
+
+/*!
+ @@property sharedSession
+ @abstract
+	Returns the singleton instance of the external storage device discovery session.
+
+ @discussion
+	There is only one external storage device discovery session for each host device which can be accessed using this method.
+ */
+@property(class, readonly) AVExternalStorageDeviceDiscoverySession *sharedSession;
+
+/*!
+ @property externalStorageDevices
+ @abstract
+	An array of external storage devices connected to this device. Read only. Key-value observable.
+
+ @discussion
+	An array of AVExternalStorageDevice objects connected to this device. The list is updated when the external storage device detected status changes.
+ */
+@property(readonly) NSArray<AVExternalStorageDevice *> *externalStorageDevices;
+
+/*!
+ @property supported
+ @abstract
+	Whether the external storage devices are supported by this device.
+
+ @discussion
+	A value of YES indicates that external storage devices are supported while NO indicates it is not.
+ */
+@property(class, readonly, getter=isSupported) BOOL supported;
+
+@end
+
+NS_ASSUME_NONNULL_END
+
+#else
+#import <AVFCapture/AVExternalStorageDevice.h>
+#endif
diff -ruN /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFCapture.h /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFCapture.h
--- /Applications/Xcode_15.0.0-beta8.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFCapture.h	2023-08-22 12:43:26
+++ /Applications/Xcode_15.0.0-rc.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVFoundation.framework/Headers/AVFCapture.h	2023-08-19 21:30:42
@@ -18,6 +18,7 @@
 #import <AVFoundation/AVCaptureVideoPreviewLayer.h>
 #import <AVFoundation/AVContinuityDevice.h>
 #import <AVFoundation/AVDepthData.h>
+#import <AVFoundation/AVExternalStorageDevice.h>
 #import <AVFoundation/AVMetadataObject.h>
 #import <AVFoundation/AVPortraitEffectsMatte.h>
 #import <AVFoundation/AVSemanticSegmentationMatte.h>
Clone this wiki locally