更新记录

1.0.0（2026-08-26） 下载此版本

1

平台兼容性

uni-app(5.24)

wc-live-player 直播播放器

按流格式自动分流的直播播放器组件（easycom，免 import 直接使用）。

分流规则

使用示例

<wc-live-player
    :src="streamUrl"
    object-fit="contain"
    :full-screen-direction="90"
    @statechange="onStateChange"
/>

属性

事件

对外方法（ref 调用，仅 live-player 分支生效）

play() / pause() / resume() / stop() / requestFullScreen() / exitFullScreen()

live-player 分支状态机

loading（加载中/自动重连）→ playing → paused（用户暂停/禁止自动播放）→ error（-2301、-2302、3001~3005 等致命码，提供「点击重试」= stop + play 重启拉流）。

真机已知行为：部分机型 pause() → resume() 后不再回调 2004 状态码。因此「恢复播放」的 UI 状态由组件乐观更新（点播放立即切 playing），不依赖 statechange；真实拉流失败仍会经致命状态码落回 error 态。

控制层图标取自 iconfont.cn 同一项目成套矢量，已统一归一为白色填充（小程序 <image> 渲染 SVG 无法用 CSS 改色，颜色烧在文件内），本地化于插件 static/ 目录，运行时无外网依赖；控制层覆盖依赖微信 2.9.1+ 同层渲染。要更换图标，用 iconfont 下载 SVG 后将 fill 改为 #FFFFFF，同名覆盖 static/ 下对应文件即可：

注意事项

1. 类目权限：微信小程序使用 live-player 需先通过直播类目审核，并在小程序后台「开发-接口设置」自助开通该组件权限。
2. 开发者工具不渲染 live-player（官方限制），需真机预览验证 flv/rtmp 分支。
3. 投屏依赖基础库 2.32.0+（enable-casting + LivePlayerContext.startCasting/exitCasting），低版本点击投屏按钮会 toast 提示版本过低。
4. 全屏：live-player 原生全屏为系统层，进入后自绘控制层不可见，退出全屏走系统返回手势；如需常驻控制请保持内嵌模式。
5. H5 端浏览器无法直接播 flv/rtmp，会按 video 兜底并展示失败态，属预期行为。