画中画(Picture in Picture)功能的代理协议。
More...
#include "AliPlayerPictureInPictureDelegate.h"
画中画(Picture in Picture)功能的代理协议。
该协议定义了播放器在画中画模式下各生命周期阶段和用户交互事件的回调方法。
所有方法均为可选实现(@optional)。
◆ pictureInPictureController:didTransitionToRenderSize:
| - (void) pictureInPictureController: |
|
(nonnull AVPictureInPictureController *) | pictureInPictureController |
| didTransitionToRenderSize: |
|
(CMVideoDimensions) | newRenderSize |
|
optionalrequired |
画中画窗口渲染尺寸变化时的回调。
此方法在画中画窗口的渲染尺寸发生变化时调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,非空 |
| newRenderSize | 新的渲染尺寸,类型为 CMVideoDimensions |
◆ pictureInPictureController:failedToStartPictureInPictureWithError:
| - (void) pictureInPictureController: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
| failedToStartPictureInPictureWithError: |
|
(NSError *_Nullable) | error |
|
optionalrequired |
画中画启动失败时的回调。
此方法在系统尝试启动画中画但失败时调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
| error | 启动失败的错误信息,可能为 nil |
◆ pictureInPictureController:restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:
| - (void) pictureInPictureController: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
| restoreUserInterfaceForPictureInPictureStopWithCompletionHandler: |
|
(void(^)(BOOL restored)) | completionHandler |
|
optionalrequired |
画中画停止前恢复用户界面的回调。
此方法在画中画即将停止时调用,用于通知代理恢复主播放器的用户界面。
必须调用 completionHandler 并传入 YES,以允许系统完成界面恢复。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
| completionHandler | 完成回调,必须调用并传入 YES 以允许系统完成恢复 |
◆ pictureInPictureController:setPlaying:
| - (void) pictureInPictureController: |
|
(nonnull AVPictureInPictureController *) | pictureInPictureController |
| setPlaying: |
|
(BOOL) | playing |
|
optionalrequired |
画中画暂停/播放按钮点击时的回调。
此方法在用户点击画中画窗口的暂停/播放按钮时调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,非空 |
| playing | 指示当前应处于播放(YES)还是暂停(NO)状态 |
◆ pictureInPictureController:skipByInterval:completionHandler:
| - (void) pictureInPictureController: |
|
(nonnull AVPictureInPictureController *) | pictureInPictureController |
| skipByInterval: |
|
(CMTime) | skipInterval |
| completionHandler: |
|
(nonnull void(^)(void)) | completionHandler |
|
optionalrequired |
画中画快进/快退按钮点击时的回调。
此方法在用户点击画中画窗口的快进或快退按钮时调用。
必须调用 completionHandler 以通知系统跳转操作已完成。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,非空 |
| skipInterval | 跳转的时间间隔,正数表示快进,负数表示快退 |
| completionHandler | 必须调用的完成回调,用于通知系统跳转操作已完成 |
◆ pictureInPictureControllerDidStartPictureInPicture:
| - (void) pictureInPictureControllerDidStartPictureInPicture: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
|
|
optionalrequired |
画中画已成功启动时的回调。
此方法在画中画模式成功进入后调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
◆ pictureInPictureControllerDidStopPictureInPicture:
| - (void) pictureInPictureControllerDidStopPictureInPicture: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
|
|
optionalrequired |
画中画已停止时的回调。
此方法在画中画模式完全退出后调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
◆ pictureInPictureControllerIsPictureInPictureEnable:isEnable:
| - (void) pictureInPictureControllerIsPictureInPictureEnable: |
|
(nullable AVPictureInPictureController *) | pictureInPictureController |
| isEnable: |
|
(BOOL) | isEnable |
|
optionalrequired |
画中画功能启用状态变化的回调。
此方法在画中画功能的启用状态发生变化时调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
| isEnable | YES 表示画中画功能已启用,NO 表示已禁用 |
◆ pictureInPictureControllerIsPlaybackPaused:
| - (BOOL) pictureInPictureControllerIsPlaybackPaused: |
|
(nonnull AVPictureInPictureController *) | pictureInPictureController |
|
|
optionalrequired |
查询当前播放状态以更新画中画 UI 的回调。
此方法用于让代理返回当前播放器的实际播放状态,以便画中画控制器正确显示播放/暂停按钮状态。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,非空 |
- Returns
- YES 表示当前处于暂停状态,NO 表示正在播放
◆ pictureInPictureControllerTimeRangeForPlayback:layerTime:
| - (CMTimeRange) pictureInPictureControllerTimeRangeForPlayback: |
|
(nonnull AVPictureInPictureController *) | pictureInPictureController |
| layerTime: |
|
(CMTime) | layerTime |
|
optionalrequired |
提供当前可播放时间范围的回调。
此方法用于让代理告知画中画控制器当前媒体的可播放时间范围。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,非空 |
| layerTime | 当前图层时间 |
- Returns
- 当前媒体的可播放时间范围,类型为 CMTimeRange
◆ pictureInPictureControllerWillStartPictureInPicture:
| - (void) pictureInPictureControllerWillStartPictureInPicture: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
|
|
optional |
画中画即将启动时的回调。
此方法在系统尝试启动画中画模式之前调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
◆ pictureInPictureControllerWillStopPictureInPicture:
| - (void) pictureInPictureControllerWillStopPictureInPicture: |
|
(AVPictureInPictureController *_Nullable) | pictureInPictureController |
|
|
optionalrequired |
画中画即将停止时的回调。
此方法在系统准备退出画中画模式之前调用。
- Parameters
-
| pictureInPictureController | 画中画控制器实例,可能为 nil |
The documentation for this protocol was generated from the following file: