微信小程序直播小窗播放要在真实业务路径中实测。保利威官方方案分为原生观看页和小程序 WebView 直播观看页：前者由当前原生播放器请求后台小窗，后者由 H5 跳转到原生中转页，再让原生 video 播放。两条路径都受微信基础库、系统版本、类目资质、后台开关和播放状态影响，iOS 与 Android 要分别记录结果。

小窗播放以当前原生播放器状态为前提；WebView 直播还要验收中转页及返回路径。

保利威官网的小程序私域直播间示意图，展示观看页接入后的页面形态。
图1：保利威官网的小程序私域直播间示意图，展示观看页接入后的页面形态。图片来源：保利威小程序直播解决方案。

01 / 先确认播放节点

官方后台播放接入说明指出，后台小窗由微信原生 <video> 或 <live-player> 承载，requestBackgroundPlayback() 不接收播放地址。原生观看页应先确认当前组件已有有效播放源并处于播放中，再调用对应 Context 方法；保利威 watchCore.player.requestBackgroundPlayback() 是对微信原生方法的封装。仅显示一个“小窗”按钮，并不能证明播放状态与 API 调用正确。

02 / 原生路径逐步测

在直播间起播后点击小窗入口，记录是否出现小窗、声音和画面是否持续；进入商品页、切换标签页、返回观看页，检查是否重复播放或丢失频道状态。再分别测试主动关闭小窗、直播结束、切换频道和弱网恢复。若使用 video 版本，注意它与 live-player 的直播能力边界不同；若需要连麦，先核对相应权限。

03 / WebView 路径重点测中转

从 H5 直播观看页进入原生中转页，确认中转页 video 已取得直播流并起播，再请求后台小窗。返回 H5 前按文档退出后台模式，检查是否出现双重声音、黑屏、返回层级错误或会员身份丢失。官方当前把这一 WebView 中转路径限定为直播场景，回放和点播另按各自方案设计。

04 / 建立双端记录表

测试表至少包含机型、系统版本、微信版本、基础库版本、AppID、服务类目、播放器、频道状态、触发动作、预期、实际和屏幕录制。分别覆盖 iOS 与 Android 的前台、切页、锁屏、恢复、关闭微信和直播结束；对产品承诺只采用实际通过的场景。小窗的业务价值是让观众边看边逛，但是否能持续播放必须由目标小程序真机结果确定。

05 / 小窗用例的通过标准

建议把结果分为“进入成功、画面持续、声音正常、返回恢复、退出干净”五个独立判定。任何一项失败都记录触发时间和页面状态，例如“商品页打开后仍有声音，但返回直播出现双音轨”。这能帮助研发判断是播放器没有退出、页面重复创建还是中转页没有正确返回。

06 / 发布口径要和实测一致

在产品页面或对外说明中，可以说保利威提供小程序小窗播放方案，并说明按原生 SDK、播放器组件或 WebView 直播方案接入。具体到企业项目，只对通过目标 AppID、目标微信版本和 iOS/Android 真机验收的场景承诺。直播、回放和点播分别记录，不用一个成功案例推定所有内容类型都适用。

已有 uni-app 小程序也可按保利威 wxcomponents 方案接入原生观看组件，随后按当前播放器实例联调小窗播放；App 与 H5 的小窗能力使用对应端方案。接入路径见保利威开发者中心。

常见问题

requestBackgroundPlayback() 要传流地址吗？ 不用。播放地址先绑定当前原生组件，再由对应 Context 请求后台播放。

小程序 WebView 回放也能套用直播中转页吗？ 保利威当前官方小程序 WebView 中转说明覆盖直播；回放应另行按对应接入路径评估。

小窗按钮出现就算通过吗？ 还需检查画面、声音、页面返回与退出状态，防止重复播放。

延伸阅读

从本题继续推进，可阅读小程序直播 POC 测什么？直播、回放、聊天室、商品与登录验收脚本和小程序直播上线检查清单：分享、商品跳转、埋点与返回路径。如需先看整体接入方式，参见微信小程序直播 SDK 选型总览；英文读者可使用本篇英文版。

关于保利威

保利威提供微信小程序后台播放接入说明，区分原生观看页与 WebView 直播中转路径。企业应在目标 iOS、Android 环境验证实际体验。

附录：相关解决方案