ZWPlayer 快捷键使用说明

ZWPlayer 提供了丰富的键盘快捷键功能，让您可以更便捷地控制视频播放。

快捷键速查表

基础播放控制

播放/暂停

• 空格键 或 媒体播放键 - 播放/暂停视频
• 快捷键：Space / MediaKey

停止与重启

• 0 - 重播视频（跳转到开头）
• 快捷键：0

提示：如果启用了片段选择功能，按 0 键会跳转到片段开始位置，而不是视频开头。

进度控制

快进/快退

• → (右箭头) - 单次按下快进5秒，长按进行倍速播放
• ← (左箭头) - 快退5秒，长按可连续操作
• 快捷键：→ / ←

逐帧播放

逐帧播放功能适用于需要精确审查视频画面的场景，如视频编辑、教学内容分析等。

• . (句号) - 逐帧前进，每次前进 1/30 秒（约一帧）
• , (逗号) - 逐帧后退，每次后退 1/30 秒（约一帧）

使用说明：

• 按下逐帧快捷键时，视频会自动暂停并跳转到对应帧
• 播放器会显示当前时间戳提示
• 逐帧播放仅在视频已加载（readyState ≥ 2）且非直播流时可用
• 支持连续快速按键实现逐帧步进

音量控制

音量调节

• ↑ (上箭头) - 音量增加5%
• ↓ (下箭头) - 音量降低5%
• 快捷键：↑ / ↓

静音控制

• M - 开启/关闭静音
• 快捷键：M (支持大小写)

播放速度控制

倍速播放

• Shift + 1 - 1倍速（正常速度）
• Shift + 2 - 2倍速播放
• 快捷键：Shift + 1 / Shift + 2

视频显示控制

全屏控制

• F - 进入/退出全屏模式
• Esc - 关闭菜单 / 退出全屏
• 快捷键：F / Esc

灯光效果

• L - 开启/关闭灯光效果
• 快捷键：L (支持大小写)

放大镜

• Z - 开启/关闭放大镜模式
• 快捷键：Z (支持大小写)

使用说明：

• 需要通过配置启用 zoomButton 参数后，快捷键方可生效
• 开启放大镜后，鼠标悬停在视频画面上可查看放大后的细节
• 按 Esc 键可关闭放大镜

播放列表

当播放器加载了播放列表时，以下快捷键可用于快速切换节目：

• Q - 显示或隐藏播放列表面板
• ] (右方括号) - 播放下一个节目
• [ (左方括号) - 播放上一个节目

使用说明：

• 播放列表快捷键仅在播放器配置了播放列表数据时可用
• 切换节目时会显示"下一个"或"上一个"的提示信息

弹幕功能

弹幕控制

• D - 开启/关闭弹幕显示
• Enter - 发送弹幕（需要在弹幕输入框未获得焦点时）
• 快捷键：D (支持大小写) / Enter

注意：当弹幕输入框获得焦点时，除了 Esc 键外，其他快捷键将被禁用以避免输入冲突。

录制功能

录制控制

• R - 开始/停止录制视频
• 快捷键：R (支持大小写)

特殊功能说明

智能进度控制

• 右箭头键支持两种模式：
  • 单击：快进5秒
  • 长按：进入倍速播放模式

片段选择模式

• 当启用片段选择功能时，0 键会跳转到当前片段的开始位置
• 在片段播放模式下，部分快捷键行为可能会有所调整

输入框焦点检测

• 播放器会自动检测当前焦点是否在输入框中
• 当焦点在弹幕输入框等文本输入区域时，快捷键会被自动禁用
• 只有 Esc 键在输入框焦点时仍然可用，用于关闭当前操作

快捷键状态管理

ZWPlayer 使用状态管理系统来处理键盘事件：

• 防止按键重复触发
• 支持长按连续操作
• 智能焦点检测避免输入冲突

兼容性说明

• 支持所有现代浏览器
• 支持媒体键盘的播放控制按键
• 自动适配不同键盘布局

版本信息：适用于 ZWPlayer v3.2.0+

更新日期：2025年11月01日