AVKit iOS xcode15.0 b1
Haritha Mohan edited this page Sep 14, 2023
·
3 revisions
#AVKit.framework https://github.com/xamarin/xamarin-macios/pull/19022
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVError.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVError.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVError.h 2023-03-09 23:52:34
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVError.h 2023-05-24 02:47:46
@@ -3,7 +3,7 @@
Framework: AVKit
- Copyright © 2015-2016 Apple Inc. All rights reserved.
+ Copyright © 2015-2023 Apple Inc. All rights reserved.
*/
@@ -16,7 +16,7 @@
@constant AVKitErrorDomain
@abstract Domain for errors from AVKit APIs.
*/
-AVKIT_EXTERN NSString * const AVKitErrorDomain API_AVAILABLE(ios(9.0));
+AVKIT_EXTERN NSString * const AVKitErrorDomain API_AVAILABLE(ios(9.0), tvos(13.0), xros(1.0)) API_UNAVAILABLE(watchos) API_UNAVAILABLE(macos);
/*!
@@ -24,8 +24,24 @@
Unknown error.
@constant AVKitErrorPictureInPictureStartFailed
Failed to start Picture in Picture.
+
+ @constant AVKitErrorContentRatingUnknown
+ Media content rating missing or unrecognized.
+ @constant AVKitErrorContentDisallowedByPasscode
+ Restriction settings disallow access to this content, but the user can override by entering the passcode.
+ @constant AVKitErrorContentDisallowedByProfile
+ An installed profile sets restriction settings that disallow access to this content; the user cannot override by entering the passcode (they may be able to override in Settings).
+
+ @constant AVKitErrorRecordingFailed
+ The recording failed.
*/
typedef NS_ENUM(NSInteger, AVKitError) {
- AVKitErrorUnknown = -1000,
- AVKitErrorPictureInPictureStartFailed = -1001
-} API_AVAILABLE(ios(9.0));
+ AVKitErrorUnknown = -1000,
+ AVKitErrorPictureInPictureStartFailed API_UNAVAILABLE(watchos) = -1001,
+
+ AVKitErrorContentRatingUnknown API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, xros, watchos) = -1100,
+ AVKitErrorContentDisallowedByPasscode API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, xros, watchos) = -1101,
+ AVKitErrorContentDisallowedByProfile API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, xros, watchos) = -1102,
+
+ AVKitErrorRecordingFailed API_UNAVAILABLE(watchos) API_UNAVAILABLE(ios, tvos, xros) = -1200,
+} API_AVAILABLE(ios(9.0), tvos(13.0), xros(1.0)) API_UNAVAILABLE(watchos) API_UNAVAILABLE(macos);
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVInterstitialTimeRange.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVInterstitialTimeRange.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVInterstitialTimeRange.h 2023-03-09 23:52:35
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVInterstitialTimeRange.h 2023-05-24 02:47:46
@@ -3,7 +3,7 @@
Framework: AVKit
- Copyright © 2015-2021 Apple Inc. All rights reserved.
+ Copyright © 2015-2023 Apple Inc. All rights reserved.
*/
@@ -18,7 +18,7 @@
@discussion An AVInterstitialTimeRange identifies a portion of an asset as an interstitial. When the asset is presented, the time range of this interstitial content will be collapsed in the user interface timeline to a single dot, scrubbing will skip over this range, and the duration will be subtracted from the time remaining in the video as displayed to the user.
*/
-API_AVAILABLE(tvos(9.0), ios(16.0)) API_UNAVAILABLE(macos, watchos)
+API_AVAILABLE(tvos(9.0), ios(16.0), xros(1.0)) API_UNAVAILABLE(macos, watchos)
@interface AVInterstitialTimeRange : NSObject <NSCopying, NSSecureCoding>
/*!
@@ -27,7 +27,7 @@
The time range of the interstitial.
@abstract Designated initializer.
*/
- - (instancetype)initWithTimeRange:(CMTimeRange)timeRange API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, macos, watchos) NS_DESIGNATED_INITIALIZER;
+ - (instancetype)initWithTimeRange:(CMTimeRange)timeRange API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, xros) API_UNAVAILABLE(macos, watchos) NS_DESIGNATED_INITIALIZER;
/*!
@property timeRange
@abstract The time range of the interstitial.
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKit.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKit.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKit.h 2023-03-04 21:29:43
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKit.h 2023-05-24 02:47:46
@@ -3,15 +3,16 @@
Framework: AVKit
- Copyright © 2013-2016 Apple Inc. All rights reserved.
+ Copyright © 2013-2023 Apple Inc. All rights reserved.
To report bugs, go to: http://developer.apple.com/bugreporter/
-
+
*/
#import <Availability.h>
#import <TargetConditionals.h>
+
#if TARGET_OS_OSX || TARGET_OS_MACCATALYST
#import <AVKitCore/AVKitDefines.h>
#if __has_include(<AVKit/AVKitCore.h>)
@@ -22,31 +23,72 @@
#else
#import <AVKit/AVKitDefines.h>
+#import <AVKit/AVKitTypes.h>
#endif // TARGET_OS_OSX || TARGET_OS_MACCATALYST
+#if TARGET_OS_OSX
+#import <AVKit/AVCaptureView.h>
+#import <AVKit/AVPictureInPictureController.h>
+#import <AVKit/AVPictureInPictureController_AVSampleBufferDisplayLayerSupport.h>
+#import <AVKit/AVPlayerView.h>
+#import <AVKit/AVRoutePickerView.h>
-#if TARGET_OS_IPHONE
+#endif // TARGET_OS_OSX
+
+
+#if TARGET_OS_IOS && !TARGET_OS_XR
#import <AVKit/AVError.h>
+#import <AVKit/AVPictureInPictureController.h>
+#import <AVKit/AVPictureInPictureController_AVSampleBufferDisplayLayerSupport.h>
+#import <AVKit/AVPictureInPictureController_VideoCallSupport.h>
+#import <AVKit/AVPlaybackRouteSelecting.h>
+#import <AVKit/AVPlayerItem+AVKitAdditions.h>
+#import <AVKit/AVPlayerViewController.h>
+#import <AVKit/AVRoutePickerView.h>
+
+// Catalyst excluded headers
#if !TARGET_OS_MACCATALYST
#import <AVKit/AVInterstitialTimeRange.h>
-#endif // TARGET_OS_MACCATALYST
+// Included in AVKitCore on catalyst
+#import <AVKit/AVPlaybackSpeed.h>
+#endif
+
+#endif // TARGET_OS_IOS && !TARGET_OS_XR
+
+
+#if TARGET_OS_TV
+#import <AVKit/AVContentProposal.h>
+#import <AVKit/AVContentProposalViewController.h>
+#import <AVKit/AVContinuityDevicePickerViewController.h>
+#import <AVKit/AVDisplayManager.h>
+#import <AVKit/AVError.h>
+#import <AVKit/AVInterstitialTimeRange.h>
+#import <AVKit/AVNavigationMarkersGroup.h>
#import <AVKit/AVPictureInPictureController.h>
#import <AVKit/AVPictureInPictureController_AVSampleBufferDisplayLayerSupport.h>
-#import <AVKit/AVPictureInPictureController_VideoCallSupport.h>
#import <AVKit/AVPlaybackSpeed.h>
-#import <AVKit/AVPlayerItem+AVKitAdditions.h>
+#import <AVKit/AVPlayerItem.h>
#import <AVKit/AVPlayerViewController.h>
-#import <AVKit/AVPlaybackRouteSelecting.h>
#import <AVKit/AVRoutePickerView.h>
+#import <AVKit/UIWindow.h>
-#else
-#import <AVKit/AVCaptureView.h>
+#endif // TARGET_OS_TV
+
+
+#if TARGET_OS_XR
+#import <AVKit/AVDisplayManager.h>
+#import <AVKit/AVError.h>
+#import <AVKit/AVInterstitialTimeRange.h>
#import <AVKit/AVPictureInPictureController.h>
#import <AVKit/AVPictureInPictureController_AVSampleBufferDisplayLayerSupport.h>
+#import <AVKit/AVPictureInPictureController_VideoCallSupport.h>
+#import <AVKit/AVPlaybackRouteSelecting.h>
#import <AVKit/AVPlaybackSpeed.h>
-#import <AVKit/AVPlayerView.h>
+#import <AVKit/AVPlayerItem+AVKitAdditions.h>
+#import <AVKit/AVPlayerViewController.h>
#import <AVKit/AVRoutePickerView.h>
+#import <AVKit/UIWindow_AVAdditions.h>
-#endif // TARGET_OS_IPHONE
+#endif // TARGET_OS_XR
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitDefines.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitDefines.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitDefines.h 2023-03-09 23:52:34
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitDefines.h 2023-05-24 02:47:46
@@ -38,3 +38,16 @@
#define AVKIT_INIT_UNAVAILABLE - (instancetype)init NS_UNAVAILABLE; \
+ (instancetype)new NS_UNAVAILABLE;
+
+
+#if TARGET_OS_IPHONE
+#define AVKitPlatformViewClass UIView
+#else
+#define AVKitPlatformViewClass NSView
+#endif // TARGET_OS_IPHONE
+
+#if TARGET_OS_IPHONE
+#define AVKitPlatformColorClass UIColor
+#else
+#define AVKitPlatformColorClass NSColor
+#endif // TARGET_OS_IPHONE
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitTypes.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitTypes.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitTypes.h 1969-12-31 19:00:00
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVKitTypes.h 2023-05-24 02:47:46
@@ -0,0 +1,40 @@
+/*
+ File: AVKitTypes.h
+
+ Framework: AVKit
+
+ Copyright © 2014-2023 Apple Inc. All rights reserved.
+
+ */
+
+#import <Foundation/Foundation.h>
+
+/*!
+ @enum AVVideoFrameAnalysisType
+ @abstract The types of items that AVPlayerViewController analyzes in a paused video frame.
+
+ @constant AVVideoFrameAnalysisTypeNone
+ Defines no items to be analyzed by the analyzer.
+ @constant AVVideoFrameAnalysisTypeDefault
+ Defines the default set of analysis types.
+
+ @constant AVVideoFrameAnalysisTypeText
+ Text that appears in a paused video frame.
+ @constant AVVideoFrameAnalysisTypeSubject
+ Subject that the user can copy out of frame.
+ @constant AVVideoFrameAnalysisTypeVisualSearch
+ Objects, landmarks, art, etc. recognized visually in a paused video frame.
+ @constant AVVideoFrameAnalysisTypeMachineReadableCode
+ Machine-readable codes, such as QR codes, that appear in a paused video frame.
+ */
+typedef NS_OPTIONS(NSUInteger, AVVideoFrameAnalysisType) {
+
+ AVVideoFrameAnalysisTypeNone = 0,
+ AVVideoFrameAnalysisTypeDefault = 1 << 0,
+
+ AVVideoFrameAnalysisTypeText = 1 << 1,
+ AVVideoFrameAnalysisTypeSubject = 1 << 2,
+ AVVideoFrameAnalysisTypeVisualSearch = 1 << 3,
+ AVVideoFrameAnalysisTypeMachineReadableCode API_AVAILABLE(ios(17.0)) API_UNAVAILABLE(macos, tvos, watchos, macCatalyst) = 1 << 4,
+
+} API_AVAILABLE(ios(17.0), macos(14.0)) API_UNAVAILABLE(tvos, watchos);
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPictureInPictureController_VideoCallSupport.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPictureInPictureController_VideoCallSupport.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPictureInPictureController_VideoCallSupport.h 2023-03-09 23:49:31
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPictureInPictureController_VideoCallSupport.h 2023-05-24 02:47:46
@@ -3,7 +3,7 @@
Framework: AVKit
- Copyright © 2021 Apple Inc. All rights reserved.
+ Copyright © 2021-2023 Apple Inc. All rights reserved.
*/
#import <AVKit/AVPictureInPictureController.h>
@@ -17,7 +17,7 @@
@class AVPictureInPictureVideoCallViewController
@abstract Subclass or directly use `AVPictureInPictureVideoCallViewController` as the container for content to be shown in Picture in Picture while video calls are active.
*/
-API_AVAILABLE(ios(15.0)) API_UNAVAILABLE(tvos, macos, watchos)
+API_AVAILABLE(ios(15.0), tvos(17.0)) API_UNAVAILABLE(macos, watchos)
@interface AVPictureInPictureVideoCallViewController : UIViewController
@end
@@ -40,7 +40,7 @@
The view controller that should appear in the system's Picture in Picture window.
@abstract Initializes a new `AVPictureInPictureControllerContentSource` suitable for supporting an active video call. This object should only be used for the duration of the call.
*/
-- (instancetype)initWithActiveVideoCallSourceView:(UIView *)sourceView contentViewController:(AVPictureInPictureVideoCallViewController *)contentViewController API_AVAILABLE(ios(15.0)) API_UNAVAILABLE(macos, tvos, watchos);
+- (instancetype)initWithActiveVideoCallSourceView:(UIView *)sourceView contentViewController:(AVPictureInPictureVideoCallViewController *)contentViewController API_AVAILABLE(ios(15.0), tvos(17.0)) API_UNAVAILABLE(macos, watchos);
/*!
@property activeVideoCallSourceView
@@ -48,7 +48,7 @@
@discussion `AVPictureInPictureController` uses this view's layout frame and visibility to determine whether or not Picture in Picture should begin automatically when the app moves to background.
The layout frame also influences the animation when entering and exiting Picture in Picture.
*/
-@property (nonatomic, weak, readonly) UIView *activeVideoCallSourceView API_AVAILABLE(ios(15.0)) API_UNAVAILABLE(macos, tvos, watchos);
+@property (nonatomic, weak, readonly) UIView *activeVideoCallSourceView API_AVAILABLE(ios(15.0), tvos(17.0)) API_UNAVAILABLE(macos, watchos);
/*!
@property activeVideoCallContentViewController
@@ -59,7 +59,7 @@
The content should always fill the view controller's view's bounds.
Note that this view controller's view is not interactive and will not receive touches or other user input.
*/
-@property (nonatomic, readonly) AVPictureInPictureVideoCallViewController *activeVideoCallContentViewController API_AVAILABLE(ios(15.0)) API_UNAVAILABLE(macos, tvos, watchos);
+@property (nonatomic, readonly) AVPictureInPictureVideoCallViewController *activeVideoCallContentViewController API_AVAILABLE(ios(15.0), tvos(17.0)) API_UNAVAILABLE(macos, watchos);
@end
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerItem+AVKitAdditions.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerItem+AVKitAdditions.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerItem+AVKitAdditions.h 2023-03-09 23:52:34
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerItem+AVKitAdditions.h 2023-05-24 02:47:46
@@ -3,7 +3,7 @@
Framework: AVKit
- Copyright © 2019-2022 Apple Inc. All rights reserved.
+ Copyright © 2019-2023 Apple Inc. All rights reserved.
*/
@@ -28,14 +28,14 @@
- AVMetadataIdentifieriTunesMetadataTrackSubTitle
- AVMetadataCommonIdentifierDescription
*/
-@property (nonatomic, copy) NSArray<AVMetadataItem *> *externalMetadata API_AVAILABLE(ios(12.2));
+@property (nonatomic, copy) NSArray<AVMetadataItem *> *externalMetadata API_AVAILABLE(ios(12.2), xros(1.0));
/*!
@property interstitialTimeRanges
@abstract An array of time ranges that identifies interstitial content. Each element specifies the time range of the media occupied by the interstitials.
@discussion An interstitial time range identifies a range of an asset that is collapsed into a single dot on the timeline in the user interface. Interstitial content is typically not related to the video being played (e.g. advertisements). On iOS, interstitials must be defined by the stream, or by using an AVPlayerInterstitialEventController.
*/
-@property (nonatomic, readonly) NSArray<AVInterstitialTimeRange *> *interstitialTimeRanges API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macCatalyst);
+@property (nonatomic, readonly) NSArray<AVInterstitialTimeRange *> *interstitialTimeRanges API_AVAILABLE(ios(16.0), xros(1.0)) API_UNAVAILABLE(macCatalyst);
@end
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerViewController.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerViewController.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerViewController.h 2023-03-09 23:49:31
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVPlayerViewController.h 2023-05-24 02:47:46
@@ -3,29 +3,51 @@
Framework: AVKit
- Copyright © 2014-2022 Apple Inc. All rights reserved.
+ Copyright © 2013-2023 Apple Inc. All rights reserved.
+ To report bugs, go to: http://developer.apple.com/bugreporter/
+
*/
#import <UIKit/UIKit.h>
#import <AVFoundation/AVFoundation.h>
+#if TARGET_OS_MACCATALYST
+#import <AVKitCore/AVKitTypes.h>
+#else
+#import <AVKit/AVKitTypes.h>
+#endif // TARGET_OS_MACCATALYST
NS_ASSUME_NONNULL_BEGIN
+/*!
+ @constant AVPlayerViewControllerSkippingBehaviorDefault
+ The default skipping behavior.
+ @constant AVPlayerViewControllerSkippingBehaviorSkipItem
+ Skip to next/previous item (as in a playlist).
+ */
+typedef NS_ENUM(NSInteger, AVPlayerViewControllerSkippingBehavior) {
+ AVPlayerViewControllerSkippingBehaviorDefault = 0,
+ AVPlayerViewControllerSkippingBehaviorSkipItem
+} API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(macos, ios, watchos, xros);
+
+
+
+@class AVContentProposal;
@class AVInterstitialTimeRange;
@class AVPlaybackSpeed;
+@protocol AVPlayerViewControllerAnimationCoordinator;
@protocol AVPlayerViewControllerDelegate;
// MARK: -
-/*!
+/**
@class AVPlayerViewController
@abstract AVPlayerViewController is a subclass of UIViewController that can be used to display the visual content of an AVPlayer object and the standard playback controls.
*/
-API_AVAILABLE(ios(8.0)) API_UNAVAILABLE(macos, watchos, tvos)
+API_AVAILABLE(ios(8.0), tvos(9.0), xros(1.0)) API_UNAVAILABLE(watchos) API_UNAVAILABLE(macos)
@interface AVPlayerViewController : UIViewController
/*!
@@ -39,13 +61,13 @@
@abstract Whether or not the receiver shows playback controls. Default is YES.
@discussion Clients can set this property to NO when they don't want to have any playback controls on top of the visual content (e.g. for a game splash screen).
*/
-@property (nonatomic) BOOL showsPlaybackControls;
+@property (nonatomic) BOOL showsPlaybackControls API_UNAVAILABLE(watchos);
/*!
- @property showsTimecodes
- @abstract Controls whether timecodes can be displayed in the playback UI when playing media with embedded timecodes. Default NO.
+ @property showsTimecodes
+ @abstract Controls whether timecodes can be displayed in the playback UI when playing media with embedded timecodes. Default NO.
*/
-@property (nonatomic) BOOL showsTimecodes API_AVAILABLE(ios(13.0));
+@property (nonatomic) BOOL showsTimecodes API_AVAILABLE(ios(13.0)) API_UNAVAILABLE(tvos, xros);
/*!
@property videoGravity
@@ -58,155 +80,350 @@
@property readyForDisplay
@abstract Boolean indicating that the first video frame has been made ready for display for the current item of the associated AVPlayer.
*/
-@property (nonatomic, readonly, getter = isReadyForDisplay) BOOL readyForDisplay;
+@property (nonatomic, readonly, getter = isReadyForDisplay) BOOL readyForDisplay API_UNAVAILABLE(watchos, xros);
/*!
@property videoBounds
@abstract The current size and position of the video image as displayed within the receiver's view's bounds.
*/
-@property (nonatomic, readonly) CGRect videoBounds;
+@property (nonatomic, readonly) CGRect videoBounds API_UNAVAILABLE(tvos) API_UNAVAILABLE(watchos);
/*!
@property contentOverlayView
@abstract Use the content overlay view to add additional custom views between the video content and the controls.
*/
-@property (nonatomic, readonly, nullable) UIView *contentOverlayView;
+@property (nonatomic, readonly, nullable) UIView *contentOverlayView API_UNAVAILABLE(watchos);
/*!
@property allowsPictureInPicturePlayback
@abstract Whether or not the receiver allows Picture in Picture playback. Default is YES.
*/
-@property (nonatomic) BOOL allowsPictureInPicturePlayback API_AVAILABLE(ios(9.0));
+@property (nonatomic) BOOL allowsPictureInPicturePlayback API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@property allowsVideoFrameAnalysis
@abstract When set to YES, the AVPlayerViewController will try to find objects, text and people while the media is paused. When an object is found, the user will be able to interact with it using long press to present a context menu. Default is YES.
*/
-@property (nonatomic) BOOL allowsVideoFrameAnalysis API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macos, tvos, watchos, macCatalyst);
+@property (nonatomic) BOOL allowsVideoFrameAnalysis API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(tvos, watchos, macCatalyst, xros);
/*!
- @property canStartPictureInPictureAutomaticallyFromInline
- @abstract Indicates whether Picture in Picture should be allowed to start automatically when transitioning to background when the receiver’s content is embedded inline. Default is NO.
- @discussion This property must only be set to YES for content intended to be the user's primary focus.
+ @property videoFrameAnalysisTypes
+ @abstract The types of analysis AVPlayerViewController will perform on a paused video frame. The default value is AVVideoFrameAnalysisDefault.
*/
-@property (nonatomic) BOOL canStartPictureInPictureAutomaticallyFromInline API_AVAILABLE(ios(14.2));
+@property (nonatomic) AVVideoFrameAnalysisType videoFrameAnalysisTypes API_AVAILABLE(ios(17.0)) API_UNAVAILABLE(tvos, watchos, macCatalyst, xros);
/*!
+ @property toggleLookupAction
+ @abstract A UIAction used for enabling the visual lookup interface.
+ @discussion Use this action to toggle visual lookup UI. This action's attributes will be set to disabled when there is no visual lookup data available or when the media is playing. Make sure to update your user interface to reflect this change. When the lookup UI is toggled, the state property is set to UIMenuElementStateOn; otherwise it will be set to UIMenuElementStateOff.
+ */
+@property (nonatomic, readonly) UIAction *toggleLookupAction API_AVAILABLE(ios(17.0)) API_UNAVAILABLE(tvos, watchos, macCatalyst, xros);
+
+/*!
+ @property canStartPictureInPictureAutomaticallyFromInline
+ @abstract Indicates whether Picture in Picture should be allowed to start automatically when transitioning to background when the receiver’s content is embedded inline. Default is NO.
+ @discussion This property must only be set to YES for content intended to be the user's primary focus.
+ */
+@property (nonatomic) BOOL canStartPictureInPictureAutomaticallyFromInline API_AVAILABLE(ios(14.2)) API_UNAVAILABLE(tvos, watchos);
+
+/*!
@property updatesNowPlayingInfoCenter
@abstract Whether or not the now playing info center should be updated. Default is YES.
*/
-@property (nonatomic) BOOL updatesNowPlayingInfoCenter API_AVAILABLE(ios(10.0));
+@property (nonatomic) BOOL updatesNowPlayingInfoCenter API_AVAILABLE(ios(10.0)) API_UNAVAILABLE(tvos, watchos);
/*!
@property entersFullScreenWhenPlaybackBegins
@abstract Whether or not the receiver automatically enters full screen when the play button is tapped. Default is NO.
@discussion If YES, the receiver will show a user interface tailored to this behavior.
*/
-@property (nonatomic) BOOL entersFullScreenWhenPlaybackBegins API_AVAILABLE(ios(11.0));
+@property (nonatomic) BOOL entersFullScreenWhenPlaybackBegins API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos, watchos);
/*!
@property exitsFullScreenWhenPlaybackEnds
@abstract Whether or not the receiver automatically exits full screen when playback ends. Default is NO.
@discussion If multiple player items have been enqueued, the receiver exits fullscreen once no more items are remaining in the queue.
*/
-@property (nonatomic) BOOL exitsFullScreenWhenPlaybackEnds API_AVAILABLE(ios(11.0));
+@property (nonatomic) BOOL exitsFullScreenWhenPlaybackEnds API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(tvos, watchos);
/*!
- @property requiresLinearPlayback
- @abstract Disables certain user operations (fast forward, forward skip, and scrubbing).
- @discussion This can be used to enforce playback of mandatory content (such as legalese or advertisements).
+ @property requiresLinearPlayback
+ @abstract Disables certain user operations, such as scanning, skipping, and scrubbing.
+ @discussion This can be used to enforce playback of mandatory content (such as legalese or advertisements).
*/
-@property (nonatomic) BOOL requiresLinearPlayback API_AVAILABLE(ios(11.0));
+@property (nonatomic) BOOL requiresLinearPlayback API_AVAILABLE(ios(11.0)) API_UNAVAILABLE(watchos);
/*!
- @property pixelBufferAttributes
- @abstract The client requirements for the visual output during playback.
- @discussion Pixel buffer attribute keys are defined in <CoreVideo/CVPixelBuffer.h>
+ @property appliesPreferredDisplayCriteriaAutomatically
+ @abstract Whether or not the receiver automatically communicates the preferredDisplayCriteria of the asset being played to the AVDisplayManager.
+ @discussion If set, then when the receiver plays an asset full-screen the screen's display criteria will be set to the preferred display criteria of that asset. The preferredDisplayCriteria will be reset to the default when full-screen playback is complete. This should not be changed during full-screen presentation unless the player or player item has been removed. This should not be used in multiple window scenes simultaneously.
*/
-@property (nonatomic, copy, nullable) NSDictionary<NSString *,id> *pixelBufferAttributes API_AVAILABLE(ios(9.0));
+@property (nonatomic) BOOL appliesPreferredDisplayCriteriaAutomatically API_AVAILABLE(tvos(11.2), xros(1.0)) API_UNAVAILABLE(ios, watchos);
/*!
+ @property pixelBufferAttributes
+ @abstract The client requirements for the visual output during playback.
+ @discussion Pixel buffer attribute keys are defined in <CoreVideo/CVPixelBuffer.h>
+ */
+@property (nonatomic, copy, nullable) NSDictionary<NSString *,id> *pixelBufferAttributes API_AVAILABLE(ios(9.0), tvos(11.0)) API_UNAVAILABLE(watchos, xros);
+
+/*!
@property delegate
@abstract The receiver's delegate.
*/
-@property (nonatomic, weak, nullable) id <AVPlayerViewControllerDelegate> delegate API_AVAILABLE(ios(9.0));
+@property (nonatomic, weak, nullable) id <AVPlayerViewControllerDelegate> delegate API_AVAILABLE(ios(9.0)) API_UNAVAILABLE(watchos);
-/**
- @property speeds
- @abstract A list of user selectable playback speeds to be shown in the playback speed control.
- @discussion By default this property will be set to the systemDefaultSpeeds class property. Setting this property to an empty list will hide the playback speed selection UI.
-
- To set the currently selected playback speed programmatically, either set the defaultRate on the AVPlayer associated with this view controller or use the selectSpeed method on AVPlayerViewController.
+/*!
+ @property speeds
+ @abstract A list of user selectable playback speeds to be shown in the playback speed control.
+ @discussion By default this property will be set to the systemDefaultSpeeds class property. Setting this property to an empty list will hide the playback speed selection UI.
+ To set the currently selected playback speed programmatically, either set the defaultRate on the AVPlayer associated with this view controller or use the selectSpeed: method on AVPlayerViewController.
*/
-@property (nonatomic, copy) NSArray<AVPlaybackSpeed *> *speeds API_AVAILABLE(ios(16.0));
+@property (nonatomic, copy) NSArray<AVPlaybackSpeed *> *speeds API_AVAILABLE(ios(16.0), tvos(16.0)) API_UNAVAILABLE(watchos);
/*!
- @property selectedSpeed
- @abstract The currently selected playback speed.
- @discussion Changes to the associated AVPlayer's defaultRate will be reflected in this property and vice versa. If the associated AVPlayer's defaultRate is set to a value that does not match a speed in the speeds list property, the selected speed will be nil.
+ @property selectedSpeed
+ @abstract The currently selected playback speed.
+ @discussion Changes to the associated AVPlayer's defaultRate will be reflected in this property and vice versa. If the associated AVPlayer's defaultRate is set to a value that does not match a speed in the speeds list property, the selected speed will be nil.
*/
-@property (nonatomic, readonly, nullable) AVPlaybackSpeed *selectedSpeed API_AVAILABLE(ios(16.0));
+@property (nonatomic, readonly, nullable) AVPlaybackSpeed *selectedSpeed API_AVAILABLE(ios(16.0), tvos(16.0)) API_UNAVAILABLE(watchos);
/*!
- @property selectSpeed
- @param speed
+ @property selectSpeed
+ @param speed
The playback speed to select.
- @abstract Sets the input AVPlaybackSpeed as the selected speed.
- @discussion Calls to selectSpeed with AVPlaybackSpeeds not contained within the speeds property array will be ignored.
+ @abstract Sets the input AVPlaybackSpeed as the selected speed.
+ @discussion Calls to selectSpeed with AVPlaybackSpeeds not contained within the speeds property array will be ignored.
*/
-- (void)selectSpeed:(AVPlaybackSpeed *)speed API_AVAILABLE(ios(16.0));
+- (void)selectSpeed:(AVPlaybackSpeed *)speed API_AVAILABLE(ios(16.0), tvos(16.0)) API_UNAVAILABLE(watchos);
+/*!
+ @property unobscuredContentGuide
+ @abstract A layout guide representing an area that will not be permanently obscured by fixed-position playback controls when they are visible.
+ */
+@property (nonatomic, readonly) UILayoutGuide *unobscuredContentGuide API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, xros);
+/*!
+ @property allowedSubtitleOptionLanguages
+ @abstract An optional array of BCP 47 language codes to filter the subtitle options presented to the user.
+ @discussion When this property to nil (the default), all available subtitle options are presented. The "Auto" subtitle option is only available when this property is nil, and full subtitles are not required (see requiresFullSubtitles).
+ */
+@property (nonatomic, copy, nullable) NSArray <NSString *> *allowedSubtitleOptionLanguages API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, watchos, xros); /* BCP47 language codes; nil allows all languages */
+
+/*!
+ @property requiresFullSubtitles
+ @abstract Determines whether the user is given the option to turn off subtitles.
+ @discussion When set to YES, the subtitle options will not present "Off" or "Auto" as options, and subtitles will always be displayed (if they are available). The default is NO.
+ */
+@property (nonatomic) BOOL requiresFullSubtitles API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property skippingBehavior
+ @abstract Specifies the behavior triggered by skipping gestures. AVPlayerViewControllerSkippingBehaviorDefault is the default value.
+ @discussion Use this property to override the default skipping behavior.
+ */
+@property (nonatomic) AVPlayerViewControllerSkippingBehavior skippingBehavior API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property skipForwardEnabled
+ @abstract Indicates whether forward-skipping is available.
+ @discussion This property affects the appearance of the forward-skipping indicator. The behavior associated with forward-skipping is identified by the skippingBehavior property.
+ */
+@property (nonatomic, getter = isSkipForwardEnabled) BOOL skipForwardEnabled API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property skipBackwardEnabled
+ @abstract Indicates whether backward-skipping is available.
+ @discussion This property affects the appearance of the backward-skipping indicator. The behavior associated with backward-skipping is identified by the skippingBehavior property.
+ */
+@property (nonatomic, getter = isSkipBackwardEnabled) BOOL skipBackwardEnabled API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property playbackControlsIncludeTransportBar
+ @abstract Whether or not the receiver shows the transport bar and related controls during user interaction. Default is YES.
+ @discussion Clients can set this property to NO, and set showsPlaybackControls to YES, to selectively prevent the transport bar from being displayed duration user interaction. Changing the value of this property does not immediately change the visiblity of the transport bar.
+ */
+@property (nonatomic) BOOL playbackControlsIncludeTransportBar API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property playbackControlsIncludeInfoViews
+ @abstract Whether or not the receiver shows the views for video metadata, navigation markers, and playback settings when requested by the user. Default is YES.
+ @discussion Clients can set this property to NO, and showsPlaybackControls to YES, to selectively prevent the information and setting panels from being displayed. Changing the value of this property does not immediately change the visiblity of the info views.
+ */
+@property (nonatomic) BOOL playbackControlsIncludeInfoViews API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios) API_UNAVAILABLE(watchos, xros);
+
+/*!
+ @property transportBarIncludesTitleView
+ @abstract Whether or not the receiver shows the title view above the scrubber. Enabled by default.
+ @discussion Clients can clear this property to disable the title view. Changing the value of this property may not immediately change visibility of the title view. This value is ignored when the transport bar is disabled by playbackControlsIncludeTransportBar.
+ The title view requires metadata to be embedded in the media asset, or provided using externalMetadata property of AVPlayerItem. Supported keys are: AVMetadataCommonIdentifierTitle for title, AVMetadataIdentifieriTunesMetadataTrackSubTitle for subtitle.
+ See also showsPlaybackControls, and playbackControlsIncludeTransportBar.
+ */
+@property (nonatomic) BOOL transportBarIncludesTitleView API_AVAILABLE(tvos(15.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property customOverlayViewController
+ @abstract A view controller containing custom, possibly interactive content, to be presented over the player view controller upon user request.
+ @discussion The custom overlay view controller can be accessed by swiping up during playback when the transport bar is hidden, or in response to selecting a button when the transport bar is visible. Clients should provide a view controller here rather than installing their own swipe gesture recognizer.
+ */
+@property (nonatomic, strong, nullable) UIViewController *customOverlayViewController API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @property transportBarCustomMenuItems
+ @abstract An array of menu elements to be displayed in addition to standard built-in controls.
+ @discussion Use this property to provide client-specific controls above the transport bar. Only UIMenu and UIAction instance types are supported. Nested UIMenus are not supported. Unsupported types will be ignored.
+ */
+@property (nonatomic, readwrite, copy) NSArray<__kindof UIMenuElement *> *transportBarCustomMenuItems API_AVAILABLE(tvos(15.0)) API_UNAVAILABLE(ios) API_UNAVAILABLE(watchos, xros);
+
+/*!
+ @property requiresMonoscopicViewingMode
+ @abstract Whether or not monoscopic is the only permitted viewing mode. Default is NO.
+ */
+@property (nonatomic) BOOL requiresMonoscopicViewingMode API_AVAILABLE(xros(1.0)) API_UNAVAILABLE(ios, tvos, watchos, macCatalyst);
+
+
+
+// MARK: - Contextual Actions
+
+/*!
+ @property contextualActions
+ @abstract An array of action controls displayed during playback. Defaults to none.
+ @discussion Use this property to present one or more action controls during playback (for example, "Skip Intro"). The title and optionally the image of each action will be displayed by a control.
+ The action handler will be called when the user selects the control.
+ */
+@property (nonatomic, copy) NSArray<UIAction *> *contextualActions API_AVAILABLE(tvos(15.0), xros(1.0)) API_UNAVAILABLE(ios, watchos, macCatalyst);
+
+/*!
+ @property contextualActionsInfoView
+ @abstract A view shown adjacent to the contextual actions suitable for showing related information.
+ @discussion Use this view to add additional metadata, information and/or artwork as subviews.
+ */
+@property (nonatomic, readonly) UIView *contextualActionsInfoView API_AVAILABLE(xros(1.0)) API_UNAVAILABLE(ios, tvos, watchos, macCatalyst);
+
+/*!
+ @property contextualActionsPreviewImage
+ @abstract An image to be shown alongside the contextual actions.
+ @discussion Use this to enhance the action with more context, e.g. for a "Jump back" button, show a preview frame of where in the movie the action will skip to.
+ This image is only shown if `AVPlayerViewController.contextualActions` contains exactly one action.
+*/
+@property (nonatomic, nullable, copy) UIImage *contextualActionsPreviewImage API_AVAILABLE(xros(1.0)) API_UNAVAILABLE(ios, tvos, watchos, macCatalyst);
+
+
+// MARK: - Info Panel Customization
+
+/*!
+ @property customInfoViewControllers
+ @abstract An array of view controllers to be displayed as tabs.
+ @discussion Use this property to provide tabs for client-specific content in the playback UI. The order of the view controllers in the array is also the order in which they are inserted in the tab bar. The display tab titles will be taken from the view controllers. Implement -preferredContentSize to provide the desired view size (subject to maximum height constraints).
+ */
+@property (nonatomic, copy) NSArray <UIViewController *> *customInfoViewControllers API_AVAILABLE(tvos(15.0), xros(1.0)) API_UNAVAILABLE(ios) API_UNAVAILABLE(watchos, macCatalyst);
+
+/*!
+ @property infoViewActions
+ @abstract Actions to be displayed in the content info view.
+ @discussion Use this property to provide up to 2 custom action controls displayed in the content info view. Default value is an array containing a single "Play From Beginning" action.
+ */
+@property (nonatomic, copy, null_resettable) NSArray<UIAction *> *infoViewActions API_AVAILABLE(tvos(15.0), xros(1.0)) API_UNAVAILABLE(ios) API_UNAVAILABLE(watchos, macCatalyst);
+
+
+// MARK: - Trim
+
+/*!
+ @property canBeginTrimming
+ @abstract Whether or not the current media can be trimmed.
+ @discussion This may return `false`, for example if the underlying asset is delivered via HLS, or if the content is protected.
+ Consult this property to enable / disable the control which initiates trimming.
+ */
+@property (readonly) BOOL canBeginTrimming API_AVAILABLE(xros(1.0)) API_UNAVAILABLE(ios, tvos, watchos, macCatalyst);
+
+/*!
+ @method beginTrimmingWithCompletionHandler:
+ @param handler
+ A completion handler that is executed when the user exits trim mode.
+ The boolean passed to the completion handler indicates whether the user completed the trim operation, or if they cancelled.
+ @abstract Sets the controls panel into trimming mode and blocks until the user selects either the `Trim` or the `Cancel` button.
+ @discussion Once trimming is completed the trimmed range can be accessed via the `forwardPlaybackEndTime` and `reversePlaybackEndTime` properties on the `AVPlayerItem`.
+ Documentation on how to export a new copy of the asset via `AVAssetExportSession` after trimming can be found at https://developer.apple.com.
+ */
+- (void)beginTrimmingWithCompletionHandler:(nullable void (^)(BOOL success))handler API_AVAILABLE(xros(1.0)) API_UNAVAILABLE(ios, tvos, watchos, macCatalyst);
+
@end
+// MARK: -
+
/*!
@protocol AVPlayerViewControllerDelegate
@abstract A protocol for delegates of AVPlayerViewController.
*/
-
+API_AVAILABLE(ios(9.0), tvos(9.0), xros(1.0)) API_UNAVAILABLE(watchos) API_UNAVAILABLE(macos)
@protocol AVPlayerViewControllerDelegate <NSObject>
@optional
/*!
- @method playerViewController:willBeginFullScreenPresentationWithAnimationCoordinator:
- @param playerViewController
- The player view controller.
- @param coordinator
- An object conforming to UIViewControllerTransitionCoordinator.
- @abstract Informs the delegate that AVPlayerViewController is about to start displaying its contents full screen.
- @discussion This method will not be called if a playerViewController is embedded inside a view controller that is being presented. If the receiver is embedded in a parent view controller, its content will be presented in a new full screen view controller and perhaps in a new window. Use the coordinator to determine whether the playerViewController or its full screen counterpart is being transitioned. Transitions can be interrupted -- use a completion block of one of the coordinator's animation methods to determine whether it has completed.
+ @method playerViewController:willBeginFullScreenPresentationWithAnimationCoordinator:
+ @param playerViewController
+ The player view controller.
+ @param coordinator
+ An object conforming to UIViewControllerTransitionCoordinator.
+ @abstract Informs the delegate that AVPlayerViewController is about to start displaying its contents full screen.
+ @discussion This method will not be called if a playerViewController is embedded inside a view controller that is being presented. If the receiver is embedded in a parent view controller, its content will be presented in a new full screen view controller and perhaps in a new window. Use the coordinator to determine whether the playerViewController or its full screen counterpart is being transitioned. Transitions can be interrupted -- use a completion block of one of the coordinator's animation methods to determine whether it has completed.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController willBeginFullScreenPresentationWithAnimationCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator API_AVAILABLE(ios(12.0));
+- (void)playerViewController:(AVPlayerViewController *)playerViewController willBeginFullScreenPresentationWithAnimationCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(tvos, watchos);
/*!
- @method playerViewController:willEndFullScreenPresentationWithAnimationCoordinator:
- @param playerViewController
- The player view controller.
+ @method playerViewController:willEndFullScreenPresentationWithAnimationCoordinator:
+ @param playerViewController
+ The player view controller.
@param coordinator
An object conforming to UIViewControllerTransitionCoordinator.
@abstract Informs the delegate that AVPlayerViewController is about to stop displaying its contents full screen.
@discussion See the discussion of -[AVPlayerViewControllerDelegatePrivate playerViewController:willBeginFullScreenPresentationWithAnimationCoordinator:].
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController willEndFullScreenPresentationWithAnimationCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator API_AVAILABLE(ios(12.0));
+- (void)playerViewController:(AVPlayerViewController *)playerViewController willEndFullScreenPresentationWithAnimationCoordinator:(id<UIViewControllerTransitionCoordinator>)coordinator API_AVAILABLE(ios(12.0)) API_UNAVAILABLE(tvos, watchos);
/*!
- @method playerViewController:restoreUserInterfaceForFullScreenExitWithCompletionHandler:
- @param playerViewController
- The player view controller.
- @param completionHandler
- The completion handler the delegate must call after restoring the interface for an exit full screen transition.
- @abstract The delegate can implement this method to restore the user interface before exiting fullscreen.
+ @method playerViewController:restoreUserInterfaceForFullScreenExitWithCompletionHandler:
+ @param playerViewController
+ The player view controller.
+ @param completionHandler
+ The completion handler the delegate must call after restoring the interface for an exit full screen transition.
+ @abstract The delegate can implement this method to restore the user interface before exiting fullscreen.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController restoreUserInterfaceForFullScreenExitWithCompletionHandler:(void (^)(BOOL restored))completionHandler API_AVAILABLE(ios(15.0));
+- (void)playerViewController:(AVPlayerViewController *)playerViewController restoreUserInterfaceForFullScreenExitWithCompletionHandler:(void (^)(BOOL restored))completionHandler API_AVAILABLE(ios(15.0)) API_UNAVAILABLE(tvos, watchos);
/*!
+ @method playerViewControllerShouldDismiss:
+ @param playerViewController
+ The player view controller.
+ @abstract The delegate can implement this method to be notified when the player view controller is about to be dismissed.
+ @discussion The player view controller will dismiss itself (with animation) if allowed and if it is possible to do so automatically. If the player view controller is embedded in another view, it may be necessary for the delegate to implement dismissal.
+ */
+- (BOOL)playerViewControllerShouldDismiss:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @method playerViewControllerWillBeginDismissalTransition:
+ @param playerViewController
+ The player view controller.
+ @abstract The delegate can implement this method to be notified when the player view controller is being dismissed and is about to start the dismissal transition.
+ */
+- (void)playerViewControllerWillBeginDismissalTransition:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
+ @method playerViewControllerDidEndDismissalTransition:
+ @param playerViewController
+ The player view controller.
+ @abstract The delegate can implement this method to be notified when the player view controller is being dismissed and has completed the the dismissal transition.
+ */
+- (void)playerViewControllerDidEndDismissalTransition:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, xros);
+
+/*!
@method playerViewControllerWillStartPictureInPicture:
@param playerViewController
The player view controller.
@abstract Delegate can implement this method to be notified when Picture in Picture will start.
*/
-- (void)playerViewControllerWillStartPictureInPicture:(AVPlayerViewController *)playerViewController;
+- (void)playerViewControllerWillStartPictureInPicture:(AVPlayerViewController *)playerViewController API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewControllerDidStartPictureInPicture:
@@ -214,7 +431,7 @@
The player view controller.
@abstract Delegate can implement this method to be notified when Picture in Picture did start.
*/
-- (void)playerViewControllerDidStartPictureInPicture:(AVPlayerViewController *)playerViewController;
+- (void)playerViewControllerDidStartPictureInPicture:(AVPlayerViewController *)playerViewController API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewController:failedToStartPictureInPictureWithError:
@@ -224,7 +441,7 @@
An error describing why it failed.
@abstract Delegate can implement this method to be notified when Picture in Picture failed to start.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController failedToStartPictureInPictureWithError:(NSError *)error;
+- (void)playerViewController:(AVPlayerViewController *)playerViewController failedToStartPictureInPictureWithError:(NSError *)error API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewControllerWillStopPictureInPicture:
@@ -232,7 +449,7 @@
The player view controller.
@abstract Delegate can implement this method to be notified when Picture in Picture will stop.
*/
-- (void)playerViewControllerWillStopPictureInPicture:(AVPlayerViewController *)playerViewController;
+- (void)playerViewControllerWillStopPictureInPicture:(AVPlayerViewController *)playerViewController API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewControllerDidStopPictureInPicture:
@@ -240,7 +457,7 @@
The player view controller.
@abstract Delegate can implement this method to be notified when Picture in Picture did stop.
*/
-- (void)playerViewControllerDidStopPictureInPicture:(AVPlayerViewController *)playerViewController;
+- (void)playerViewControllerDidStopPictureInPicture:(AVPlayerViewController *)playerViewController API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewControllerShouldAutomaticallyDismissAtPictureInPictureStart:
@@ -248,7 +465,7 @@
The player view controller.
@abstract Delegate can implement this method and return NO to prevent player view controller from automatically being dismissed when Picture in Picture starts.
*/
-- (BOOL)playerViewControllerShouldAutomaticallyDismissAtPictureInPictureStart:(AVPlayerViewController *)playerViewController;
+- (BOOL)playerViewControllerShouldAutomaticallyDismissAtPictureInPictureStart:(AVPlayerViewController *)playerViewController API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewController:restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:
@@ -258,7 +475,7 @@
The completion handler the delegate needs to call after restore.
@abstract Delegate can implement this method to restore the user interface before Picture in Picture stops.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler;
+- (void)playerViewController:(AVPlayerViewController *)playerViewController restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:(void (^)(BOOL restored))completionHandler API_AVAILABLE(ios(9.0), tvos(14.0)) API_UNAVAILABLE(watchos);
/*!
@method playerViewController:willPresentInterstitialTimeRange:
@@ -268,7 +485,7 @@
The interstitial time range.
@abstract The delegate can implement this method to be notified when the player view controller is about to present interstitial content to the user.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController willPresentInterstitialTimeRange:(AVInterstitialTimeRange *)interstitial API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macCatalyst);
+- (void)playerViewController:(AVPlayerViewController *)playerViewController willPresentInterstitialTimeRange:(AVInterstitialTimeRange *)interstitial API_AVAILABLE(ios(16.0), tvos(9.0)) API_UNAVAILABLE(watchos, macCatalyst);
/*!
@method playerViewController:didPresentInterstitialTimeRange:
@@ -278,7 +495,176 @@
The interstitial time range.
@abstract The delegate can implement this method to be notified when the player view controller has finished presenting interstitial content.
*/
-- (void)playerViewController:(AVPlayerViewController *)playerViewController didPresentInterstitialTimeRange:(AVInterstitialTimeRange *)interstitial API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macCatalyst);
+- (void)playerViewController:(AVPlayerViewController *)playerViewController didPresentInterstitialTimeRange:(AVInterstitialTimeRange *)interstitial API_AVAILABLE(ios(16.0), tvos(9.0)) API_UNAVAILABLE(watchos, macCatalyst);
+
+/*!
+ @method playerViewController:willResumePlaybackAfterUserNavigatedFromTime:toTime:
+ @param playerViewController
+ The player view controller.
+ @param oldTime
+ The playback time before the user began navigating.
+ @param targetTime
+ The target playback time selected by the user.
+ @abstract The delegate can implement this method to be notified when the user has skipped, scrubbed, or otherwise navigated to a new time, and playback is about to start at the new time.
+ @discussion Compare with AVPlayerItemTimeJumpedNotification; this delegate method is delivered for (and only for) user-initiated changes to the playback time. If the user skips/scrubs several times before resuming playback, this method is only called once.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController willResumePlaybackAfterUserNavigatedFromTime:(CMTime)oldTime toTime:(CMTime)targetTime API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:timeToSeekAfterUserNavigatedFromTime:toTime:
+ @param playerViewController
+ The player view controller.
+ @param oldTime
+ The playback time before the user began navigating.
+ @param targetTime
+ The playback time selected by the user.
+ @abstract The delegate can implement this method to be notified when the user has skipped, scrubbed, or otherwise navigated to a new time, and wants to resume playback at the target time.
+ @discussion This delegate method is delivered for (and only for) user-initiated changes to the playback time. If the user skips/scrubs several times before resuming playback, this method is only called once. This method should not be used to disable scrubbing; use the requiresLinearPlayback property of the AVPlayerViewController instead.
+ */
+- (CMTime)playerViewController:(AVPlayerViewController *)playerViewController timeToSeekAfterUserNavigatedFromTime:(CMTime)oldTime toTime:(CMTime)targetTime API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:didSelectMediaSelectionOption:inMediaSelectionGroup:
+ @param playerViewController
+ The player view controller.
+ @param mediaSelectionOption
+ The selected media option.
+ @param mediaSelectionGroup
+ The media selection group of the selected media option.
+ @abstract The delegate can implement this method to be notified when the user has selected a option from a media selection group or deselected all of the options in the group.
+ @discussion The media selection option will be nil when subtitles are turned off.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController didSelectMediaSelectionOption:(nullable AVMediaSelectionOption *)mediaSelectionOption inMediaSelectionGroup:(AVMediaSelectionGroup *)mediaSelectionGroup API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:didSelectExternalSubtitleOptionLanguage:
+ @param playerViewController
+ The player view controller.
+ @param language
+ The BCP 47 language code.
+ @abstract The delegate can implement this method to be notified when the user has selected a specific subtitle option.
+ @discussion This method is only called for external subtitle languages specified by the externalSubtitleOptionLanguages property of AVPlayerItem (see AVKit/AVPlayerItem.h). For all other options, playerViewController:didSelectMediaSelectionOption:inMediaSelectionGroup: will be called instead. The delegate is responsible for displaying the corresponding subtitles.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController didSelectExternalSubtitleOptionLanguage:(NSString *)language API_AVAILABLE(tvos(9.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros) NS_SWIFT_UNAVAILABLE("External subtitle options are not supported");
+
+/*!
+ @method skipToNextItemForPlayerViewController:
+ @param playerViewController
+ The player view controller.
+ @discussion Clients that request non-default skipping behavior should implement this method. The delegate should update the playerViewController’s player to play the next player item.
+ */
+- (void)skipToNextItemForPlayerViewController:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method skipToPreviousItemForPlayerViewController:
+ @param playerViewController
+ The player view controller.
+ @discussion The delegate should update the playerViewController’s player to play the previous player item.
+ */
+- (void)skipToPreviousItemForPlayerViewController:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:skipToNextChannel:
+ @param playerViewController
+ The player view controller.
+ @param completion
+ A block that should be called to dismiss the channel interstice.
+ @abstract Should change the player item to reflect the content of the next channel, and call the completion block when ready.
+ @discussion Each call to this method should advance one channel relative to the previous request, even if the prior request has not yet completed.
+*/
+- (void)playerViewController:(AVPlayerViewController *)playerViewController skipToNextChannel:(void (^)(BOOL success))completion API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros) NS_SWIFT_ASYNC_NAME(playerViewControllerSkipToNextChannel(_:));
+
+/*!
+ @method playerViewController:skipToPreviousChannel:
+ @param playerViewController
+ The player view controller.
+ @param completion
+ A block that should be called to dismiss the channel interstice.
+ @abstract Should change the player item to reflect the content of the previous channel, and call the completion block when ready.
+ @discussion Each call to this method should advance one channel relative to the previous request, even if the prior request has not yet completed.
+*/
+- (void)playerViewController:(AVPlayerViewController *)playerViewController skipToPreviousChannel:(void (^)(BOOL success))completion API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros) NS_SWIFT_ASYNC_NAME(playerViewControllerSkipToPreviousChannel(_:));
+
+/*!
+ @method nextChannelInterstitialViewControllerForPlayerViewController:
+ @param playerViewController
+ The player view controller.
+ @return A view controller describing the channel that will be displayed; it will fill the screen until the new channel is ready.
+ @abstract Clients should provide a view controller describing the layout of the channel interstice.
+ @discussion This method will be called when the user initiates, but has not yet committed, a change in channel. Clients must also implement playerViewController:skipToNextChannel:. This method may be called while a previous channel interstice is visible (on screen, or transitioning).
+ */
+- (UIViewController *)nextChannelInterstitialViewControllerForPlayerViewController:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method previousChannelInterstitialViewControllerForPlayerViewController:
+ @param playerViewController
+ The player view controller.
+ @return A view controller describing the channel that will be displayed; it will fill the screen until the new channel is ready.
+ @abstract Clients should provide a view controller describing the layout of the channel interstice.
+ @discussion This method will be called when the user initiates, but has not yet committed, a change in channel. Clients must also implement playerViewController:skipToPreviousChannel:. This method may be called while a previous channel interstice is visible (on screen, or transitioning).
+ */
+- (UIViewController *)previousChannelInterstitialViewControllerForPlayerViewController:(AVPlayerViewController *)playerViewController API_AVAILABLE(tvos(13.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:shouldPresentContentProposal:
+ @abstract Should return YES, if implemented, to allow presentation of the content proposal.
+ @discussion The delegate may wish to create a custom view controller when this is called.
+ */
+- (BOOL)playerViewController:(AVPlayerViewController *)playerViewController shouldPresentContentProposal:(AVContentProposal *)proposal API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:didAcceptContentProposal:
+ @abstract The delegate should replace the current player item with the next item.
+ @discussion Clients must implement this method when setting the nextContentProposal property of AVPlayerViewController. The delegate should create a new AVPlayerItem and update the AVPlayer or AVQueuePlayer.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController didAcceptContentProposal:(AVContentProposal *)proposal API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:didRejectContentProposal:
+ @abstract The delegate should react to the user rejecting the content proposal, typically by dismissing the player view controller.
+ @discussion If the client does not implement this method, the player view controller will be dismissed.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController didRejectContentProposal:(AVContentProposal *)proposal API_AVAILABLE(tvos(10.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+/*!
+ @method playerViewController:willTransitionToVisibilityOfTransportBar:withAnimationCoordinator:
+ @abstract Called when the visibility of the transport bar changes.
+ @param playerViewController
+ The player view controller.
+ @param visible
+ Whether the transport bar will become visible.
+ @param coordinator
+ An object conforming to AVPlayerViewControllerAnimationCoordinator.
+ @discussion Use the animation coordinator to synchronize animations with transport bar visibility.
+ */
+- (void)playerViewController:(AVPlayerViewController *)playerViewController willTransitionToVisibilityOfTransportBar:(BOOL)visible withAnimationCoordinator:(id<AVPlayerViewControllerAnimationCoordinator>)coordinator API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, watchos, macCatalyst, xros);
+
+@end
+
+
+// MARK: -
+
+API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios, xros) API_UNAVAILABLE(watchos)
+@protocol AVPlayerViewControllerAnimationCoordinator <NSObject>
+/*!
+ @method addCoordinatedAnimations:completion:
+ @abstract Add animations to be performed alongside the playback controls visibility animation.
+ */
+- (void)addCoordinatedAnimations:(void (^_Nullable)(void))animations completion:(void (^_Nullable)(BOOL finished))completion;
+
+@end
+
+
+// MARK: - Deprecated APIs
+
+@interface AVPlayerViewController (Deprecated)
+
+/*!
+ @property customInfoViewController
+ @abstract A view controller to be displayed alongside system-provided info and settings panels.
+ @discussion Use this property to provide client-specific content and controls in an additional info view. Implement -preferredContentSize to provide the desired view size.
+ */
+@property (nonatomic, strong, nullable) UIViewController *customInfoViewController API_DEPRECATED_WITH_REPLACEMENT("Use customInfoViewControllers", tvos(11.0, 15.0)) API_UNAVAILABLE(ios, watchos, xros);
@end
diff -ruN /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVRoutePickerView.h /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVRoutePickerView.h
--- /Applications/Xcode_14.3.1.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVRoutePickerView.h 2023-03-09 23:52:34
+++ /Applications/Xcode_15.0.0-beta.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk/System/Library/Frameworks/AVKit.framework/Headers/AVRoutePickerView.h 2023-05-24 02:55:27
@@ -1,92 +1,178 @@
/*
File: AVRoutePickerView.h
-
+
Framework: AVKit
-
- Copyright © 2017 Apple Inc. All rights reserved.
-
+
+ Copyright © 2013-2023 Apple Inc. All rights reserved.
+
+ To report bugs, go to: http://developer.apple.com/bugreporter/
+
*/
+#import <AVFoundation/AVFoundation.h>
+
+#import <AVKit/AVKitDefines.h>
+#if TARGET_OS_IPHONE
#import <UIKit/UIKit.h>
+#else
+#import <Cocoa/Cocoa.h>
+#endif // TARGET_OS_IPHONE
-@class AVCustomRoutingController;
-@protocol AVRoutePickerViewDelegate;
+#ifndef AVKitPlatformViewClass
+#if TARGET_OS_IPHONE
+#define AVKitPlatformViewClass UIView
+#else
+#define AVKitPlatformViewClass NSView
+#endif // TARGET_OS_IPHONE
+#endif // AVKitPlatformViewClass
+
+#ifndef AVKitPlatformColorClass
+#if TARGET_OS_IPHONE
+#define AVKitPlatformColorClass UIColor
+#else
+#define AVKitPlatformColorClass NSColor
+#endif // TARGET_OS_IPHONE
+#endif // AVKitPlatformColorClass
+
+
NS_ASSUME_NONNULL_BEGIN
-/*!
- @class AVRoutePickerView
- @abstract AVRoutePickerView is a subclass of UIView that displays controls for picking playback routes.
- @discussion Media from AVPlayer or AVSampleBufferAudioRenderer can be routed to compatible AirPlay destinations.
+@protocol AVRoutePickerViewDelegate;
+
+@class AVCustomRoutingController;
+@class AVKitPlatformColorClass;
+
+
+/**
+ @constant AVRoutePickerViewButtonStateNormal
+ Normal or default state of the picker.
+ @constant AVRoutePickerViewButtonStateNormalHighlighted
+ Highlighted state of the picker. The picker has this state when a mouse-down event occurs inside the button. It loses this highlight when a mouse-up event occurs.
+ @constant AVRoutePickerViewButtonStateActive
+ Active state of the picker. The picker has this state when AirPlay is active.
+ @constant AVRoutePickerViewButtonStateActiveHighlighted
+ Highlighted state of the active picker. The picker has this state when it is highlighted and AirPlay is active.
*/
+typedef NS_ENUM(NSInteger, AVRoutePickerViewButtonState) {
+ AVRoutePickerViewButtonStateNormal = 0,
+ AVRoutePickerViewButtonStateNormalHighlighted = 1,
+ AVRoutePickerViewButtonStateActive = 2,
+ AVRoutePickerViewButtonStateActiveHighlighted = 3
+} NS_SWIFT_NAME(AVRoutePickerView.ButtonState) API_AVAILABLE(macos(10.15)) API_UNAVAILABLE(ios, tvos, watchos, xros);
-API_AVAILABLE(ios(11.0), tvos(11.0)) API_UNAVAILABLE(macos, watchos)
-@interface AVRoutePickerView : UIView
-/*!
- @property delegate
- @abstract The route picker view's delegate.
+
+#if TARGET_IS_AVKITMACHELPER
+#define AVRoutePickerView AVMacHelperRoutePickerView
+#endif // TARGET_IS_AVKITMACHELPER
+
+/**
+ @class AVRoutePickerView
+ @abstract AVRoutePickerView is a view subclass that displays controls for picking playback routes.
+ @discussion Media from an AVPlayer, or from an AVSampleBufferAudioRenderer on iOS and tvOS, can be routed to compatible AirPlay destinations.
*/
-@property (nonatomic, weak, nullable) id<AVRoutePickerViewDelegate> delegate;
+#if !TARGET_IS_AVKITMACHELPER
+API_AVAILABLE(macos(10.15), ios(11.0), tvos(11.0)) API_UNAVAILABLE(xros) API_UNAVAILABLE(watchos)
+#endif // !TARGET_IS_AVKITMACHELPER
+@interface AVRoutePickerView : AVKitPlatformViewClass
-/*!
- @property activeTintColor
- @abstract The view's tint color when AirPlay is active.
+/**
+ @property delegate
+ @abstract The route picker view's delegate.
*/
-@property (nonatomic, strong, null_resettable) UIColor *activeTintColor;
+@property (nonatomic, nullable, weak) id<AVRoutePickerViewDelegate> delegate;
-/*!
- @constant AVRoutePickerViewButtonStyleSystem
+
+/**
+ @property player
+ @abstract The player for which to perform routing operations.
+ */
+@property (nonatomic, strong, nullable) AVPlayer *player API_AVAILABLE(macos(10.15)) API_UNAVAILABLE(ios, tvos, watchos, xros);
+
+/**
+ @method routePickerButtonColorForState:
+ @param state
+ The state for which to get the picker button color.
+ @abstract Returns the color of the picker button for a given state.
+ */
+- (AVKitPlatformColorClass *)routePickerButtonColorForState:(AVRoutePickerViewButtonState)state API_AVAILABLE(macos(10.15)) API_UNAVAILABLE(ios, tvos, watchos, xros);
+
+/**
+ @method setRoutePickerButtonColor:forState:
+ @param color
+ The color the button should have for a given state.
+ @param state
+ The state for which to set the color of the button image.
+ @abstract Sets the color of the picker button for a given state.
+ @discussion If set to nil, the default color will be used for the given state.
+ */
+- (void)setRoutePickerButtonColor:(nullable AVKitPlatformColorClass *)color forState:(AVRoutePickerViewButtonState)state API_AVAILABLE(macos(10.15)) API_UNAVAILABLE(ios, tvos, watchos, xros);
+
+/**
+ @property routePickerButtonBordered
+ @abstract Whether or not the picker button has a border. Default is YES.
+ */
+@property (nonatomic, getter = isRoutePickerButtonBordered) BOOL routePickerButtonBordered API_AVAILABLE(macos(10.15)) API_UNAVAILABLE(ios, tvos, watchos, xros);
+
+/**
+ @property activeTintColor
+ @abstract The view's tint color when AirPlay is active.
+ */
+@property (nonatomic, strong, null_resettable) AVKitPlatformColorClass *activeTintColor API_AVAILABLE(ios(11.0), tvos(11.0)) API_UNAVAILABLE(xros) API_UNAVAILABLE(macos, watchos);
+
+/**
+ @constant AVRoutePickerViewButtonStyleSystem
A system style for the route picker button.
- @constant AVRoutePickerViewButtonStylePlain
+ @constant AVRoutePickerViewButtonStylePlain
A plain style for the route picker button, which has the same appearance as the system style without the blurred background view.
- @constant AVRoutePickerViewButtonStyleCustom
+ @constant AVRoutePickerViewButtonStyleCustom
A custom style for the route picker button, which allows customizing the background view and focused appearance.
*/
typedef NS_ENUM(NSInteger, AVRoutePickerViewButtonStyle) {
AVRoutePickerViewButtonStyleSystem,
AVRoutePickerViewButtonStylePlain,
AVRoutePickerViewButtonStyleCustom
-} API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios);
+} API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(macos, ios, watchos, xros);
-/*!
- @property routePickerButtonStyle
- @abstract The route picker button style.
+/**
+ @property routePickerButtonStyle
+ @abstract The route picker button style.
*/
-@property (nonatomic) AVRoutePickerViewButtonStyle routePickerButtonStyle API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(ios);
+@property (nonatomic) AVRoutePickerViewButtonStyle routePickerButtonStyle API_AVAILABLE(tvos(11.0)) API_UNAVAILABLE(macos, ios, watchos, xros);
-/*!
- @property prioritizesVideoDevices
- @abstract Whether or not the route picker should sort video capable output devices to the top of the list. Setting this to YES will cause the route picker view to show a videocentric icon.
+/**
+ @property prioritizesVideoDevices
+ @abstract Whether or not the route picker should sort video capable output devices to the top of the list. Setting this to YES will cause the route picker view to show a videocentric icon.
*/
-@property (nonatomic) BOOL prioritizesVideoDevices API_AVAILABLE(ios(13.0), tvos(13.0));
+@property (nonatomic) BOOL prioritizesVideoDevices API_AVAILABLE(ios(13.0), tvos(13.0)) API_UNAVAILABLE(macos, xros) API_UNAVAILABLE(watchos);
-/*!
- @property customRoutingController
- @abstract A controller which enables connection to 3rd party devices (non-airplay) via the picker.
+/**
+ @property customRoutingController
+ @abstract A controller which enables connection to 3rd party devices (non-airplay) via the picker.
*/
-@property (nonatomic, nullable) AVCustomRoutingController *customRoutingController API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macos, tvos);
+@property (nonatomic, retain, nullable) AVCustomRoutingController *customRoutingController API_AVAILABLE(ios(16.0)) API_UNAVAILABLE(macos, tvos, watchos, xros);
@end
-/*!
- @protocol AVRoutePickerViewDelegate
- @abstract Defines an interface for delegates of AVRoutePickerView.
+/**
+ @protocol AVRoutePickerViewDelegate
+ @abstract Defines an interface for delegates of AVRoutePickerView.
*/
-
+API_AVAILABLE(macos(10.15), ios(11.0), tvos(11.0)) API_UNAVAILABLE(xros) API_UNAVAILABLE(watchos)
@protocol AVRoutePickerViewDelegate <NSObject>
@optional
-/*!
- @method routePickerViewWillBeginPresentingRoutes:
- @abstract Informs the delegate that the route picker view will start presenting routes to the user.
+/**
+ @method routePickerViewWillBeginPresentingRoutes:
+ @abstract Informs the delegate that the route picker view will start presenting routes to the user.
*/
- (void)routePickerViewWillBeginPresentingRoutes:(AVRoutePickerView *)routePickerView;
-/*!
- @method routePickerViewDidEndPresentingRoutes:
- @abstract Informs the delegate that the route picker view finished presenting routes to the user.
+/**
+ @method routePickerViewDidEndPresentingRoutes:
+ @abstract Informs the delegate that the route picker view finished presenting routes to the user.
*/
- (void)routePickerViewDidEndPresentingRoutes:(AVRoutePickerView *)routePickerView;
- README
- xcode13.0 Binding Status
- xcode13.1 Binding Status
- xcode13.2 Binding Status
- xcode13.3 Binding Status
- xcode13.4 Binding Status
- xcode14.0 Binding Status
- xcode14.1 Binding Status
- xcode14.2 Binding Status
- xcode14.3 Binding Status
- xcode15.0 Binding Status
- xcode15.1 Binding Status
- xcode15.3 Binding Status