更新日志

☰

v3.2.1 2026-01-24 (最新版本)

v3.2.1下载地址： https://cdn.zwplayer.cn/v3.2.1/zwplayer.zip

本次更新是 ZWPlayer v3.2.0 系列的深度优化版本。我们不仅在字幕与章节系统上实现了功能跃迁，还针对移动端交互、WebRTC 协议生态以及 UI 细节进行了全方位的打磨，旨在为开发者提供更专业、更流畅的跨端播放解决方案。

---

✨ 功能新增与优化

1. 字幕与章节系统：从“静态显示”到“深度交互”

• 智能内容检索： 新增内置字幕与章节搜索面板，支持通过关键词快速检索内容并一键跳转至对应视频进度，实现字幕即索引，台词秒跳转。

• 零门槛文件接入： 支持将本地字幕（SRT/VTT/BCC）或章节（JSON/VTT）文件直接拖拽至播放器加载，显著提升内容调试与观影效率。

• 全生命周期回调： 新增 onSubtitleLoaded、onChapterLoaded 事件，方便业务逻辑深度联动。

• 格式自动检测： 播放器现可自动识别 VTT、SRT、JSON 等多种字幕与章节内容格式。

2. 流媒体协议族：WebRTC 矩阵全面覆盖

• 多云平台深度集成： 在支持标准 WHEP 的基础上，新增对阿里云 ARTC 及腾讯云 TRTC 协议的官方适配，赋能超低延迟直播场景。

• 协议智能识别： 强化底层检测逻辑，支持对 webrtc://、artc://、trtc://、brtc:// 等多种协议头的自动解析与秒开。

• 全浏览器录制兼容： 针对 Firefox 和 Safari 浏览器进行了专项优化，确保录制功能在主流浏览器中均能稳定运行。

3. 移动端适配：更懂触屏的交互设计

• 高效快进新体验： 引入长按触发 2 倍速播放机制，松开即刻恢复原速，操作逻辑对齐主流短视频 APP。

• 空间布局优化： 小窗口模式下智能隐藏非必要工具条，并缩减中间播放按钮尺寸，确保小屏下画面信息量的最大化。

• 微信环境智能策略：新增微信浏览器环境检测，针对微信自动播放限制，在微信内自动禁用 autoplay 配置，避免持续转圈等待，提升首屏体验。

4. UI/UX 进化：消除干扰，回归视觉纯净

• 全局面板互斥机制： 建立全局面板管理器，确保字幕搜索、设置、章节等功能面板同时仅激活一个，避免 UI 重叠与视觉混乱。

• 跨端交互兼容： 修复移动端浏览器 :hover 伪类导致的菜单“粘性显示”问题。

• 视觉语言统一： 统一录制选项、滚动条与弹出框样式，提升整体品牌感。

---

🔧 问题修复

• Fluid 模式适配优化：修正了在 fluid 自适应模式下，播放竖屏视频时，容器不能正确匹配比例导致出现非预期滚动条的问题。

• 多语言内核修复：修正了部分提示的多语言映射，以及切换语言时 disableMutedConfirm 配置失效的问题。

• 快捷键冲突：解决了在搜索面板操作方向键时，意外触发底层播放器音量调整的冲突问题。

---

v3.2.0 2025-12-01

v3.2.0下载地址： https://cdn.zwplayer.cn/v3.2.0/zwplayer.zip

本次更新是一个重要功能版本，重点新增了多项实用配置项，显著增强了播放器的本地化、交互性和播放能力。

功能新增与优化

1. 本地文件播放 (localPlayback)

• 功能： 支持直接播放用户设备上的本地视频/音频文件

• 价值： 无需上传至服务器，为用户提供更快捷、私密的播放体验，适用于文件预览、本地媒体库等场景

2. 片段循环播放 (segmentButton)

• 功能： 允许用户选择视频中的特定片段进行循环播放

• 价值： 极大方便了教学复盘、精彩瞬间重放、健身动作练习等需要重复观看特定内容的场景

3. 录制功能 (recordButton)

• 功能： 支持录制正在播放的视频或仅提取音频

• 价值： 为用户提供了内容保存和二次创作的能力，如录制直播片段、制作音频剪辑等

4. 多语言支持 (lang)

• 功能： 新增国际化配置项，支持界面语言切换

• 价值： 使播放器更容易集成到国际化项目中，提升非中文用户的使用体验

5. 音量增益调节

• 功能： 可调节音量增益，最大支持 4倍音量。

• 价值： 即使音源声音较小也能听清，帮助用户更好地捕捉声音细节。

6. 丰富快捷键

• 功能： 增加了更多键盘快捷键操作

• 价值： 为高级用户提供更高效、便捷的键盘控制方式，提升操作体验

问题修复

• 修复了 fluid 模式下部分视频显示不完整的问题

• 影响： 解决了在流式布局中视频可能被裁剪或显示异常的bug，确保了自适应布局下的观看效果

 

---

v3.1.5 2025-11-01

v3.1.5下载地址： https://cdn.zwplayer.cn/v3.1.5/zwplayer.zip

功能新增与优化

• 新增 disableMutedConfirm 配置项：用于禁用因浏览器自动播放策略触发的静音确认提示框，为需要无中断自动播放的场景提供更流畅的体验。

问题修复

• 修复了播放器右键菜单中链接点击失效的问题。

---

v3.1.4 2025-08-30

v3.1.4下载地址： https://cdn.zwplayer.cn/v3.1.4/zwplayer.zip

功能新增与优化

• 协议支持扩展：新增对 webrtc:// 及 brtc:// 流媒体协议的支持。

• HLS 增强：增加对 HLS 流中 HEVC 编码格式的兼容，以支持更高效的视频播放。

• 直播优化：当设置 isLive=true 时，播放器将自动启用直播追帧功能，确保更低的延迟。

问题修复

• 修复了在 HTTP-FLV 点播模式下可能无法正常播放的问题。

---

v3.1.3 2025-03-06

体验与兼容性

• 框架适配：新增对 Vue 2 与 Vue 3 框架的官方适配支持，便于在主流前端项目中集成。

• 样式优化：解决了在部分移动设备上的UI样式兼容性问题，提升了移动端的视觉一致性。

---

v3.1.2 2024-05-07

• 正式发布 🎉 ZWPlayer v3.1.2 版本正式发布。