画中画

更新时间:2024-11-13 02:00:56下载pdf

画中画分为系统画中画和应用内画中画。系统画中画功能无法正常使用时,自动开启应用内画中画。

  • SDK 和 UI 业务包需要更新至 v5.17.0 及以上版本,才能使用画中画功能。
  • 如果您已经实现系统画中画功能,请勿使用 UI 业务包的画中画功能,以免导致功能异常。

系统画中画

使用系统画中画需要满足以下条件:

  • 终端系统版本为 iOS 15.0 及以上
  • App 工程配置开启后台音频权限

功能配置

画中画功能入口需要通过涂鸦开发者平台配置。详细流程以下:

  1. 登录 产品开发页面,找到对应产品,单击 操作 栏里的 继续开发

  2. 选择 设备交互 > 面板控制,选择面板后,单击 编辑面板

    画中画
  3. 编辑面板 页面,选择 功能配置,打开 视频浮窗功能 开关,并单击底部 保存

    画中画

权限配置

  1. 打开项目设置。

  2. 选择 主工程 Target > Signing & Capabilities,单击 + Capability

    画中画
  3. 添加 Background Modes 权限,勾选 Audio, AirPlay, and Picture in Picture 权限,以便确保后台音频和画中画的可用性。

    配置后,最终如图所示:

    画中画
  4. thing_custom_config.json 中的 need_backgroud_audio 属性设置为 true,确保画中画组件正常加载。

App Store 审核说明

后台音频权限属于高级别权限,App Store 对此权限的审核比较严格。为了避免审核被拒,在开启画中画功能后再次提交 App,需要根据以下三方面进行说明:

  • 必要性说明:为了提升用户观看视频的体验,App 进入后台时开启画中画功能。
  • 功能使用说明:提供使用画中画功能的详细步骤说明。
  • 视频说明:录制使用画中画功能的视频,上传 YouTube 后生成链接,并在审核信息中添加该视频链接。

应用内画中画

应用内画中画功能通过自定义 UI 展示视频。当 App 进入后台时,该功能会自动关闭。如果终端系统版本较低或项目配置错误,则会自动开启应用内画中画功能。