原生小程序与 uni-app 工程接入直播,开发任务分别是什么?
原生微信小程序与 uni-app 工程接入保利威直播时,业务接口可以共用,组件挂载、编译产物、播放器权限与回归任务需分别实施。
企业已有微信小程序,原生工程和 uni-app 工程接入保利威直播的业务任务相近,工程任务不同。两者都要处理频道、观看条件、登录、分享、商品跳转和埋点;原生工程直接按微信小程序 SDK 组织页面和组件,uni-app 工程则在 mp-weixin 编译产物中挂载保利威原生自定义组件,并额外验收框架与组件的兼容性。
原生与 uni-app 可以共用业务接口契约,但组件挂载、编译产物和回归任务分别实施。


01 / 共同任务先列业务接口
在动手集成前,确定频道与活动的映射、会员身份来源、观看条件、商品详情路由、分享卡片路径和埋点字段。直播组件只解决观看页的一部分;商品库存、价格、订单及课程权限仍由企业系统提供。双方约定事件表后,才把保利威观看能力接入页面,可减少组件可用但业务无法闭环的返工。
02 / 原生工程的工作包
微信原生项目按当前保利威 SDK 文档安装依赖、配置插件或播放器组件、创建观看页面,并在宿主逻辑中处理授权、路由和分享。开发负责人要核对目标 AppID 的插件准入、live-player 或 video 选择;连麦另核对 live-pusher。上传体验版前,对页面生命周期、组件事件和 SDK 升级影响进行回归。
03 / uni-app 工程的工作包
按uni-app 接入说明取得 polyv-live-watch,复制到 src/wxcomponents,在 pages.json 声明组件,在 .vue 页面挂载 polyv-watch-room 并传入频道。宿主页面处理业务事件;联调时重点检查编译后组件路径、资源、事件回调、页面栈和微信审核产物。此方案专门面向 mp-weixin,App、H5 或其他小程序使用对应端方案,可从开发者中心选型。
04 / 把验收责任落到工程产物
原生团队交付 SDK 版本清单、组件配置和体验版;uni-app 团队还需交付构建命令、wxcomponents 目录版本及 mp-weixin 产物检查结果。测试团队在同一频道和同一批账号上比较直播、回放、聊天、商品和登录,避免把不同频道配置误判为框架差异。
05 / 小窗播放作为独立任务
保利威后台播放说明提供原生组件请求小窗的接法。两种工程都运行在微信小程序环境,但调用位置、组件实例和页面生命周期需按实际项目处理。用 iOS、Android 真机检查进入商品页、返回、退出播放和直播结束状态,不以编译通过判定体验通过。
06 / 工程交接时要写清接口契约
例如宿主向观看页传频道 ID 和必要的会员标识,观看页触发商品点击事件,宿主转换成企业商品详情路由,订单服务再把活动来源落库。原生与 uni-app 工程可使用同一份业务契约,但事件绑定和组件生命周期代码分别实现。这样业务接口可复用,差异集中在页面与构建层。
07 / 估算工期时看四类成本
原生工程的重点是 SDK 依赖、播放器权限、页面接入和版本回归;uni-app 工程在此基础上多了原生组件包、编译产物和框架兼容性验证。两者都需要频道配置、登录、商品、分享与小窗测试。若团队只有 H5 能力、活动又很近,可以先把 WebView 作为独立候选评估;若直播将成为长期功能,再按现有工程组织深度接入。
常见问题
uni-app 工程一定要改成微信原生工程吗? 不需要。可在现有 uni-app mp-weixin 工程中引入原生自定义组件。
两种工程功能会完全一致吗? 需按所用 SDK、播放器、频道配置及框架集成结果逐项验收。
工期只看组件接入时间吗? 还要计入账号权限、业务接口、体验版、审核和双端回归。
延伸阅读
从本题继续推进,可阅读uni-app 小程序集成保利威观看页:从 wxcomponents 到真机验收和小程序直播 POC 测什么?直播、回放、聊天室、商品与登录验收脚本。如需先看整体接入方式,参见微信小程序直播 SDK 选型总览;英文读者可使用本篇英文版。
关于保利威
保利威为原生微信小程序与 uni-app mp-weixin 工程提供对应观看页接入路径。工程分工应以当前组件版本、宿主事件和企业业务接口为准,详见开发者中心。