uni-app无法实现直播挂件，因微信未开放该能力给第三方小程序，video-live插件仅支持原生小程序且需混合开发；替代方案为调用uni.openChannelsLive唤起视频号直播间小窗。
uni-app 无法直接用 live-player 或 live-room 组件实现「直播挂件」——微信官方不开放该能力给第三方小程序调用，所谓“挂件”仅限视频号直播间在小程序内嵌入的轻量展示（如悬浮角标、小窗预览），且必须走视频号 API，不是 uni-app 可配置的组件。
为什么不能在 uni-app 里配直播挂件
微信目前没有提供「小程序直播挂件」的插件或组件。你搜到的 live-room 是用于小程序原生直播间（需开通类目+审核），live-player-plugin 是跳转式全屏播放器，二者都不是“挂件”。所谓“挂件”，实际是视频号侧提供的 video-live 小程序插件（非 uni-app 原生支持），且仅允许已接入视频号直播的小程序通过 wx.openChannelsLive 或 video-live 自定义组件调用，uni-app 无法在编译层注入该插件上下文。
- uni-app 的
mp-weixin编译目标不支持动态注册视频号插件所需的requirePlugin上下文（只在原生 WXML 中生效） -
plugin-private://wx2b03c6e691cd7370/...这类路径只能跳转全屏页面，不能作为可嵌入的 UI 挂件 - 微信开发者工具中即使手动写
Component is not found in path "plugin-private://..."
能用的替代方案：video-live 插件 + 原生混合写法
如果你真需要类似挂件的效果（比如右下角悬浮小窗、点击展开），唯一可行路径是放弃纯 uni-app 方案，改用「原生混合」：
- 在 uni-app 项目中新建一个原生小程序页面（如
pages/native-live/native-live），不走 vue 编译，直接写 WXML/WXSS/JS - 在该页面 manifest.json 的
mp-weixin下声明："plugins": {"video-live": {"version": "1.0.0", "provider": "wx1a458d39f2543391"}}（注意：这是视频号插件 AppID，不是直播组件的wx2b03c6e691cd7370） - WXML 中使用：
- 用
uni.navigateTo({url: 'pages/native-live/native-live?roomId=123'})跳转过去，或通过cover-view+cover-image在 uni-app 页面上叠加一个可点击的静态预览图，再触发跳转
常见错误：把 live-player-plugin 当成挂件用
很多开发者误以为配置了 live-player-plugin 就能“嵌入播放”，结果发现：
- 跳转后是全屏新页面，无法返回时保留当前页面状态
- 无法监听播放器内部事件（如弹幕、点赞），
bindstatechange在 uni-app 模板里无效 - 自定义参数
custom_params超过 600 字符会被截断，且中文需严格encodeURIComponent，否则跳转白屏 - 调试时出现
Plugin not found: live-player-plugin—— 多半是manifest.json写在了错误层级（必须在mp-weixin对象下，不能放在根或h5下）
当前最稳的落地方式：用视频号直播 + wx.openChannelsLive
2026 年起，微信已逐步关闭新小程序申请「小程序直播」权限（后台显示“系统维护中”），但视频号直播完全开放。uni-app 可直接调用：
-
uni.getProvider({service: 'channels-video'})判断是否支持 -
uni.openChannelsLive({roomId: 'xxxxxx'})直接唤起视频号直播间（支持小窗模式，iOS 17+/Android 12+） - 小窗行为由微信客户端控制，uni-app 无法干预样式，但可监听
onChannelsLiveClose回调做后续处理 - 注意：
roomId必须是视频号直播间 ID（6 位数字），不是小程序直播的 10 位 ID；需提前在视频号后台开播并获取
真正卡住的点不在代码配置，而在于账号资质和入口可见性——视频号直播间在小程序里默认无 tab 入口，得靠分享卡片、客服消息或自定义按钮引导，这点容易被忽略。
