已有微信小程序想尽快提供直播间,可以让 <web-view> 打开 H5 观看页。企业有三种实施深度:直接打开保利威标准观看页;先打开自建 H5 入口,再进入标准观看页;在自建 H5 中集成保利威 Web 观看页 SDK。三者对会员登录、商品跳转、页面维护的责任不同。<web-view> 打开的是网页地址,Web SDK 运行在网页代码中。

WebView 打开的是 H5 页面;标准观看页、自建入口页和自建 Web SDK 观看页对应不同开发责任。

保利威官网的小程序私域直播间示意图,展示观看页接入后的页面形态。
图1:保利威官网的小程序私域直播间示意图,展示观看页接入后的页面形态。图片来源:保利威小程序直播解决方案。
微信小程序直播产品界面示意图
图2:参考保利威官网视觉风格生成的产品界面示意图,非真实产品截图。

01 / 路径一:打开标准观看页

小程序业务页携带频道和来源参数,跳转到已配置的 H5 观看页。直播间界面与升级主要由保利威提供,适合活动排期紧、能接受标准体验的团队。上线前确认实际 URL 及跳转后的域名已纳入小程序业务域名;会员身份、观看条件、分享和商品落点要用企业测试账号走完,不以浏览器中能打开作为通过标准。

02 / 路径二:自建 H5 入口承接业务

小程序打开企业自己的 H5 入口页,由入口页完成登录校验、活动来源记录和频道分发,再进入保利威标准观看页。若采用跳转,进入标准观看页后,外层 H5 的页面控制能力随之结束;若考虑 iframe 包裹,须先确认页面允许嵌入,并专项验证跨域、全屏、分享、页面高度和消息通信。这个方案适合保留标准直播间,同时掌握前置业务流程。

03 / 路径三:自建 H5 集成 Web SDK

企业自己部署 H5 观看页,页面中引入保利威 Web 观看页 SDK,按需求组合播放器、聊天、互动和商品模块,再由小程序 <web-view> 打开这个页面。此时 UI、业务逻辑、前端发布和兼容性维护由企业负责。开发前应确认现用 SDK 版本、接口与示例项目,建立 H5 与小程序之间的登录态、导航、分享和埋点协议。

04 / 域名与商品跳转一起设计

先画出“小程序活动页→H5 观看页→商品详情→订单→返回直播”的路径,再检查每一步的域名、微信 JS-SDK 初始化、目标小程序页面路径与参数。商品点击能弹出按钮,不等于能在小程序环境正确导航。最小验收样例是:新老会员分别进入直播、点击一件商品、返回直播后仍能识别同一活动来源。

05 / 把小窗播放作为专项需求

保利威提供小程序后台播放接入说明。小程序 WebView 方案的官方中转路径当前用于直播:H5 观看页进入原生中转页,由原生 video 承载后台小窗。它涉及播放器状态与返回 H5 的处理,必须按目标机型测试;回放和点播使用各自对应方案。已有 uni-app 或原生工程若追求更深的端内能力,可从开发者中心评估组件路线。

06 / 三种路径的责任划分

直接打开标准页时,企业主要负责入口、域名、会员和商品回流;自建 H5 入口时,企业还负责入口页部署、鉴权与参数传递;自建 H5 + Web SDK 时,企业负责整个直播间页面的 UI、交互、升级和线上故障定位。做实施预算时把设计、前端、接口、运维和真机兼容性分别计入,而不是只比较“嵌入一个 URL”的开发量。

07 / 一条示例链路

零售会员在小程序活动页点击直播,进入 H5 观看页;观看页识别活动来源并展示商品;商品点击回到小程序详情页,完成测试下单后返回原活动。若中途需要小窗,WebView 路线按官方直播中转机制联调。用这条链路测试可以同时覆盖业务域名、JS-SDK、登录态、商品参数和页面栈。

常见问题

Web SDK 的 URL 能直接填进 <web-view> 吗? 不能。先在自建 H5 页面中引入并初始化 SDK,再把 H5 地址交给 <web-view>。

标准观看页是否自动接通企业订单? 企业仍需定义商品点击后的页面、身份传递和订单归因。

自建 H5 是否比标准页更省维护? 自建 H5 带来更多界面与业务控制权,同时需要企业维护前端发布和兼容性。

延伸阅读

从本题继续推进,可阅读WebView 能直接嵌入直播 SDK 吗?小程序观看页接入的三个常见误区和直播能看、商品却跳不过去?排查 WebView 域名与页面跳转。如需先看整体接入方式,参见微信小程序直播 SDK 选型总览;英文读者可使用本篇英文版。

关于保利威

保利威提供标准 H5 观看页与 Web 观看页 SDK,企业可按页面定制、会员鉴权和维护责任选择 WebView 实施深度;其他端的能力从开发者中心分别选型。

附录:相关解决方案