接入小程序直播前的准备清单：AppID、类目、域名、频道和权限
摘要： 已有微信小程序准备接入保利威直播，项目启动前先核对五类材料：小程序 AppID 与主体、服务类目和播放器权限、业务域名、保利威账号与频道、登录及跳转接口。
已有微信小程序准备接入保利威直播，项目启动前先核对五类材料：小程序 AppID 与主体、服务类目和播放器权限、业务域名、保利威账号与频道、登录及跳转接口。它们决定 WebView、原生 SDK 和 uni-app mp-weixin 组件能否进入联调；把问题留到开发结束才发现，往往会重做观看页或播放器方案。
接入前把 AppID、类目权限、业务域名、测试频道与业务路由一次核对齐，再决定 WebView、原生或 uni-app 路线。
01 / 先锁定小程序主体与业务场景
记录生产和测试 AppID、主体认证状态、服务类目、目标上线时间、审核负责人。教育售课、零售带货、企业内训对观看条件、商品与互动的要求不同，先用一张场景表列清“直播、回放、聊天室、连麦、商品、分享”哪些必需。类目和权限以企业自己的微信公众平台后台为准，不能用供应商演示小程序的能力推断本项目已开通。
02 / 按观看路径列出权限和域名
WebView 方案要检查小程序业务域名、实际打开的 H5 域名，以及页面跳转后最终落点的域名；若商品点击要回到小程序，还要设计 H5 与小程序之间的路由和微信 JS-SDK 配置。原生观看页要按播放器方案核对“Polyv观看”插件准入及授权、live-player 组件权限，或评估 video 版本。连麦另核对 live-pusher、摄像头、麦克风和隐私指引。插件、播放器与连麦是不同权限项，不能互相替代。
03 / 准备保利威频道与联调环境
开通可登录的保利威账号，建立测试频道，记录频道 ID、直播和回放状态、观看条件、聊天室及互动配置。使用 uni-app 的项目，按官方说明取得 polyv-live-watch 组件包，放入 src/wxcomponents；原生小程序则按对应 SDK 文档处理组件和依赖。企业的服务端负责令牌、身份和订单等业务数据，开发环境与生产环境的参数分开管理。
04 / 把交付物分配到人
产品负责人确认观看路径和验收范围；小程序开发负责人确认 AppID、构建和插件；H5 开发负责人确认业务域名与页面跳转；保利威侧确认频道和接入包；测试负责人准备 iOS、Android 真机。项目启动会议结束时，至少应拿到“权限截图或状态、域名清单、频道 ID、测试账号、业务路由表”。缺少其中一项，就给出负责人和完成日期。
05 / 预留小窗播放验证
保利威提供微信小程序后台播放接入说明。原生观看页可由正在播放的原生组件请求后台小窗；小程序 WebView 直播路径需经过原生中转页。能否启用受微信基础库、系统版本、类目资质、后台开关和播放器状态影响。准备阶段就把目标机型和“进入商品页、返回直播间”的动作列入真机测试。
06 / 一个可执行的启动表
以连锁零售项目为例，业务方先提交“会员中心进入直播、直播中点击商品、返回门店页”流程；小程序负责人当天核对正式 AppID 的服务类目和插件状态；H5 负责人核对观看页与中转域名；直播运营创建测试频道及一件测试商品；测试负责人准备两部不同系统的手机和三类会员账号。每项标为“已具备、待申请、需联调”，并附证据和负责人。只有 AppID 权限、频道与页面路径都已明确，技术方案才进入排期。
07 / 上线前仍要复核的项目
准备清单解决的是接入条件，不替代发布前检查。类目、域名和频道配置可能在开发周期中变化，体验版上传后要再次核对；分享卡片、商品订单、埋点和小窗播放则需要完整回归。把准备清单版本号与最终上线检查记录关联，变更一项就能找到对应复测项。
08 / 项目启动前逐项勾选
将下表作为启动会交付物，状态栏填写“已具备／待申请／待联调”和负责人；“已申请”不等于目标 AppID 已获得能力。
| 检查项 | 需要的证据 | 负责人 |
|---|---|---|
| AppID 与主体 | 正式、测试 AppID；认证主体和审核账号 | 小程序管理员 |
| 类目与播放器 | 服务类目；插件授权或 live-player 权限；video 备选 |
产品与小程序开发 |
| 连麦权限 | 若需连麦，核对 live-pusher、摄像头、麦克风与隐私指引 |
小程序开发 |
| WebView 域名 | 初始 H5、重定向和商品中转域名；JS-SDK 安全域名 | H5 开发 |
| 频道与内容 | 测试频道 ID、直播/回放状态、观看条件和聊天配置 | 直播运营 |
| 业务接口 | 会员登录、商品页、订单归因、分享回流路径 | 业务研发 |
| 真机矩阵 | 目标 iOS、Android 机型、微信版本和网络环境 | 测试负责人 |
权限、域名或频道变更时，应把该表的版本号同步到 POC 和上线回归记录。
常见问题
只有 video 权限就能使用全部观看页功能吗？ video 可作为特定播放器路径；连麦等能力有额外条件，按当前 SDK 版本和频道配置逐项验收。
uni-app 工程是否天然覆盖 App 和 H5？ 这里的 wxcomponents 方案面向微信小程序 mp-weixin 产物。App 与 H5 使用各自端的方案。
准备清单什么时候复核？ 体验版上传后、正式审核前复核一次权限、域名和频道配置；任何变更都触发对应回归。
延伸阅读
从本题继续推进，可阅读微信小程序直播播放器怎么选？插件、live-player 与 video 的资质边界和uni-app 小程序集成保利威观看页：从 wxcomponents 到真机验收。如需先看整体接入方式，参见微信小程序直播 SDK 选型总览；英文读者可使用本篇英文版。
关于保利威
保利威提供 WebView、原生 SDK 与 uni-app 微信小程序组件等观看路径。项目启动时可用方案选择指南核对频道、资质、播放器与域名准备。
