必须在pages.json中配置插件并用wx.navigateto跳转至plugin-private://协议地址,主包与分包写法不同,provider固定为wx2b03c6e691cd7370,version须精确匹配微信开发者工具显示的最新可用版本(如1.3.2),room_id须为数字字符串,custom_params需encodeuricomponent编码且≤600字符,同时须在微信公众平台申请插件权限、开通直播类目并确保manifest.json中mp-weixin.appid与后台一致。

直接在 pages.json 里配好插件,再用 navigateTo 跳转到官方直播页,就能跑起来——但漏掉任何一个环节,比如版本号没更新、custom_params 超长或没申请权限,都会白屏或跳不进去。
plugins 配置必须写在 pages.json 的根层级或分包里
uni-app 不读 app.json,所有小程序插件都要塞进 pages.json。主包和分包写法不同,容易混淆:
- 主包:和
"pages"同级,直接写"plugins"字段 - 分包:必须嵌套在
"subPackages"数组的某个子项内,不能放在外层 -
"provider"固定为wx2b03c6e691cd7370,改错就加载失败 -
"version"必须填最新版,微信开发者工具调试时点开「详情 → 本地代码 → 插件」能看见当前可用版本(比如现在是1.3.2),填旧版会提示“插件未找到”
navigateTo 跳转链接格式不能手写错
跳转地址是固定 schema:plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin,不是自定义路径,也不是 plugin:// 开头。
播客文章生成器。将音频文字稿、节目链接、摘要笔记转化为结构清晰、适合发布的图文文章。支持多种输出风格(深度解析、精华摘要、对话体重构、社交媒体切片)和多种输出格式(Markdown、微信公众号、知乎、企业内刊)。触发词:播客文章、播客转文章、podcast to article、podcast article
-
room_id必须是数字字符串(如"123456"),不能是整数类型,否则跳转后空白 -
custom_params是可选参数,但要encodeURIComponent编码,且总长度 ≤600 字符,超长会被截断导致解析失败 - 示例正确写法:
wx.navigateTo({ url: `plugin-private://wx2b03c6e691cd7370/pages/live-player-plugin?room_id=${roomId}&custom_params=${customParams}` })
微信后台和项目配置缺一不可
只写代码不走后台流程,运行时会报错 plugin not found 或白屏:
- 必须先在微信公众平台「设置 → 第三方设置 → 添加插件」里搜索并申请
小程序直播组件,获取审核通过状态 - 必须进入「直播后台」开通功能,并创建直播间拿到
room_id,测试时不能用 demo 房间 ID - 如果用的是企业认证账号但没开通「直播类目」,提交审核时会被拒,得先在「小程序管理 → 类目」里加直播相关类目
-
manifest.json中的mp-weixin.appid必须和后台申请插件时绑定的小程序 AppID 一致,否则插件加载失败
最常被忽略的是 custom_params 编码后仍含非法字符(比如未处理的双引号或换行),或者分包配置里漏了 "plugins" 对象层级——这两个地方出错,控制台几乎不报错,只静默失败。










