简介
应用场景
高级画中画优势：
加密视频画中画：和现有播放器加密播放完美结合，实现基于加密模板的视频画中画播放，无需切换播放器类型。
离线播放画中画：支持本地视频画中画播放，包含普通视频、加密视频等。
“秒切”效果：无需点击切换画中画按钮，退后台即可立马启动画中画，实现真正意义的“秒切”。
环境要求
系统版本：iOS >= 14.0、iPad >= 9.0
硬件设备：iPhone 8及以上的设备
SDK 版本：11.4版本及以上
集成步骤
升级版本及配置资源
1. 升级 SDK 版本
高级画中画需要 SDK 配合使用，在使用高级画中画版本功能前需要将 SDK 的版本升级到11.3及以上的高级版本 或 11.4及以上的基础版本，否则无法使用。同时，基础画中画 版本和高级画中画版本两者可以兼容性的存在，不会存在功能性冲突。若想升级 SDK 版本，请参见 SDK 集成指引。
2. 引入 bundle 资源
因为 SDK 内需要使用 TXVodPlayer.bundle 里的资源，需在编译之前将 bundle 文件 下载 引入到项目中，切勿更改 bundle 及其内部使用的资源名称，否则会导致无缝切换画中画失败。
?
3. 开通播放器高级版 Licence
高级画中画版本需要使用移动端播放器高级版 License，您可参见 移动端播放器 License 指引获取。若您已获取对应 License，可前往 腾讯云视立方控制台 > License 管理 > 移动端 License 获取对应 LicenseURL 和 LicenseKey。如果没有申请 Player 高级套餐 License，进入画中画将无效。
获取到 License 信息后，在调用 SDK 的相关接口前，通过下面的接口初始化 License，建议在
- [AppDelegate application:didFinishLaunchingWithOptions:] 中进行如下设置：- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {NSString * const licenceURL = @"<获取到的 licenseUrl>";NSString * const licenceKey = @"<获取到的 key>";?//TXLiveBase 位于 "TXLiveBase.h" 头文件中[TXLiveBase setLicenceURL:licenceURL key:licenceKey];NSLog(@"SDK Version = %@", [TXLiveBase getSDKVersionStr]);}
画中画功能快速接入
1. 权限开通
画中画（PictureInPicture）在 iOS 9 就已经推出了，不过之前都只能在 iPad 上使用，iPhone 要使用画中画需更新到 iOS 14 才能使用。 目前腾讯云播放器可以支持应用内和应用外画中画能力，极大的满足用户的诉求。使用前需要开通后台模式，步骤为：XCode 选择对应的 Target > Signing & Capabilities > Background Modes，勾选 “Audio, AirPlay, and Picture in Picture”。
?
2. 设置配置选项
为了使用自动画中画功能，需要在设置中打开自动开启画中画按钮。具体路径为 iPhone 或 iPad上选择：设置 > 通用 > 画中画 > 自动开启画中画，选择打开即可。
?
3. 设置代理
为了便于监听画中画的状态，需要设置 vodDelegate，实现 TXVodPlayListener 中的画中画相关回调。可以根据回调里的各种状态和错误信息，进行相关的业务操作，例如：继续播放、暂停或退出画中画等。
/*** 画中画状态回调** 画中画状态回调*/- (void)onPlayer:(TXVodPlayer *)player pictureInPictureStateDidChange:(TX_VOD_PLAYER_PIP_STATE)pipState withParam:(NSDictionary *)param;?/*** 画中画错误信息回调** 画中画错误信息回调*/- (void)onPlayer:(TXVodPlayer *)player pictureInPictureErrorDidOccur:(TX_VOD_PLAYER_PIP_ERROR_TYPE)errorType withParam:(NSDictionary *)param;
4. 使用画中画能力代码示例
注意：
使用自动画中画功能一定要确保播放器处于播放状态，若播放器是暂停或停止状态时，无法使用自动画中画功能。
isSupportSeamlessPictureInPicture 这个接口，需要在应用程序加载高级版 License 以后才能使用。同时，此接口只能判断设备本身是否支持自动切换画中画，因系统限制，无法判断用户对于自动画中画的设置权限，需自行引导。
播放之前先设置是否允许“自动切换画中画功能”
?// 1.播放之前先设置“自动切换 Picture-In-Picture功能”是否允许// YES 表示允许 NO 表示不允许，默认为NO[TXVodPlayer setPictureInPictureSeamlessEnabled:YES];?// 2、进入画中画if (![TXVodPlayer isSupportPictureInPicture]) {// 设备不支持画中画直接退出return;}?// 手动调用进入画中画[_vodPlayer enterPictureInPicture];?// 3、退后台操作 如果设备支持无缝切换画中画，退后台不暂停播放。// 注意：isSupportSeamlessPictureInPicture这个接口，需要在应用程序加载高级版License以后才能使用。同时，此接口只能判断设备本身// 是否支持自动切换画中画，因系统限制，无法判断用户对于自动画中画的设置权限，需自行引导。if ([self.vodplayer isSupportSeamlessPictureInPicture]) {// 不做处理} else {// 暂停播放[self.vodplayer pause];}?// 4.退出画中画[_vodPlayer exitPictureInPicture];
?
