uni-app 小程序直播怎么接入？观看页组件、配置和上线检查清单
uni-app 小程序接入直播观看页，重点是完整复制组件包、注册观看组件、传入频道配置，并用正式 AppID 做真机验证。
使用 uni-app 开发微信小程序的团队，往往已经有一套成熟工程：路由、页面、登录、接口和业务样式都在原有项目里。直播接入的关键，不是重新做一个小程序，而是把直播观看页能力放进现有工程中。
先说结论：uni-app 微信小程序接入直播观看页，可将保利威提供的原生小程序自定义组件包放入 uni-app 工程的wxcomponents目录，在页面中注册并挂载观看页组件。宿主页面主要负责传入频道配置、提供容器、处理登录、WebView、分享和埋点等跨业务边界事件；播放器、聊天室、直播/回放和互动状态由观看页组件内部承载。
01 接入的核心思路是什么？
在 uni-app 微信小程序观看页接入方案中，接入方通常需要把polyv-live-watch这类原生微信小程序自定义组件包完整放入src/wxcomponents目录，再在页面配置中注册观看页组件。
这里要注意，组件包应整体复制，不应只复制单个watch-room文件夹，否则可能缺少内部模块、样式和静态资源。
图1：uni-app 微信小程序可通过观看页组件承载直播间和互动体验。图片来源：保利威小程序直播解决方案
02 宿主页面负责什么？
宿主页面的职责要保持清晰：提供页面容器、传入频道 ID 等配置，并处理跨出组件边界的业务事件，例如跳转自有登录页、打开业务 WebView、配置分享、记录埋点或清理页面状态。
观看页内部的直播、回放、聊天室、互动组件、引导页和错误页，则由组件根据频道配置和观看条件承载。不要在视图变化后反复重新挂载观看组件，以免造成重复初始化或状态异常。
03 上线前怎么验证？
上线前建议用客户自己的微信小程序 AppID 做真机验证，重点检查观看页能否打开、直播和回放能否播放、聊天室是否连接、商品或外链是否能交给宿主页面处理、分享和返回是否正常。
图2：上线后可结合观看行为和转化数据复盘直播效果。图片来源：保利威小程序直播解决方案
不要只看开发者工具模拟器。正式小程序的服务类目、插件权限、接口权限和隐私配置，都会影响最终上线表现。
04 FAQ
4.1 只复制 watch-room 文件夹可以吗？
不建议。应完整复制组件包，避免缺少业务样式、静态资源和内部模块。
4.2 宿主页面要自己处理播放器状态吗？
通常不需要。播放器、聊天室和互动组件等观看页内部状态由组件承载，宿主页面主要处理业务边界事件。
4.3 是否可以用测试 AppID 替代正式验证？
正式上线前不建议只依赖测试 AppID。直播播放、插件权限和服务类目需要在客户自己的正式 AppID 下验证。