AliyunPlayer v7.10.0
Aliyun Player API Reference Manual for iOS Platforms
Loading...
Searching...
No Matches
<AliPlayerPictureInPictureDelegate> Protocol Reference

画中画(Picture in Picture)功能的代理协议。 More...

#include "AliPlayerPictureInPictureDelegate.h"

Inheritance diagram for <AliPlayerPictureInPictureDelegate>:

Instance Methods

(void) - pictureInPictureController:didTransitionToRenderSize:
 画中画窗口渲染尺寸变化时的回调。
(void) - pictureInPictureController:failedToStartPictureInPictureWithError:
 画中画启动失败时的回调。
(void) - pictureInPictureController:restoreUserInterfaceForPictureInPictureStopWithCompletionHandler:
 画中画停止前恢复用户界面的回调。
(void) - pictureInPictureController:setPlaying:
 画中画暂停/播放按钮点击时的回调。
(void) - pictureInPictureController:skipByInterval:completionHandler:
 画中画快进/快退按钮点击时的回调。
(void) - pictureInPictureControllerDidStartPictureInPicture:
 画中画已成功启动时的回调。
(void) - pictureInPictureControllerDidStopPictureInPicture:
 画中画已停止时的回调。
(void) - pictureInPictureControllerIsPictureInPictureEnable:isEnable:
 画中画功能启用状态变化的回调。
(BOOL) - pictureInPictureControllerIsPlaybackPaused:
 查询当前播放状态以更新画中画 UI 的回调。
(CMTimeRange) - pictureInPictureControllerTimeRangeForPlayback:layerTime:
 提供当前可播放时间范围的回调。
(void) - pictureInPictureControllerWillStartPictureInPicture:
 画中画即将启动时的回调。
(void) - pictureInPictureControllerWillStopPictureInPicture:
 画中画即将停止时的回调。

Detailed Description

画中画(Picture in Picture)功能的代理协议。

该协议定义了播放器在画中画模式下各生命周期阶段和用户交互事件的回调方法。

所有方法均为可选实现(@optional)。

Method Documentation

◆ 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
isEnableYES 表示画中画功能已启用,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: