播放器 — 音乐与视频

写代码时想听歌、看资料视频，不用切出 qd。「在哪看到就在哪播」——播放器有三种形态（悬浮层 / 独立小窗 / 窗内卡片），一键互相交接；倍速、逐帧、A-B、截图、循环×随机与播放列表一应俱全。

一、怎么打开

• Roam 里按 q：音视频进播放器；选中 ≥2 个同类音视频 = 整批进播放列表，从第一个开始播；
• 右键「加入播放列表」：单个或多个媒体随时加进来——正在播放不打断，尾部追加；
• 工作台（菜单行2 的 qqq）里的 Player 卡片：一键打开窗内卡片或独立小窗。

二、三种形态，一键交接

• 独立小窗可 ↙ 退回悬浮层——进度、播放模式、列表整体跟着走，不断播；
• 出声独占：任何时刻只有一处出声——在别处起播，先前的会自动暂停；
• 关闭播放层 = 立即停播，不后台空响。

三、控制条与键盘

全部直显、一键可达：播放 / 暂停 · 逐帧 · 截图 · 进度条 · 时间 · 音量 · 倍速 · 循环 × 随机 · A-B · 画中画 · 全屏。

播放器聚焦时，键盘同效：

四、倍速与逐帧

• 倍速：控制条「倍速」打开上展面板——0.5× ~ 4× 预设任选，或输入任意倍数回车确认；倍速有粘性，切换媒体仍生效；
• 逐帧：点「逐帧」逐格前进；. / , 前进 / 后退——按真实帧率步进，卡点细看很好用。

五、循环 × 随机（两个独立维度）

• 循环：关 / 列表循环 / 单曲循环；随机：关 / 开——单选即生效，不打断播放；
• 随机是袋制：一轮内不重复；袋子空了 + 循环开 = 重洗继续，循环关 = 播完即停；
• 模式有会话粘性：切换媒体都记得；只有整批新打开一组媒体才复位为默认（列表循环 + 随机关）。

六、A-B 循环

• 点「A-B」第一次标 A，第二次标 B 开始循环，再点清除；键盘 A 同效；
• 进度条上显示区间底色与双边标记；最短区间 0.15 秒——精听、复盘、扒谱都好用；
• A-B 只属于当前文件：切换轨道自动清零。

七、播放列表

• 列表超过一首时，播放器旁自动常驻列表栏：序号 + 文件名，当前轨金色高亮、自动进位；
• ⇄ 一键换到另一边；列表内点行切轨；拖动行重排（落点金线、贴边自动滚动）；
• 行尾 ↑ ↓ −：移动 / 移除；移除当前轨 → 原位接播下一轨；播到列表空 → 自动关闭播放层。

八、截图

• 控制条「截图」或键盘 S：当前帧以全分辨率 PNG 存到源文件同目录（重名自动 _1 后缀，绝不覆盖）；
• 完成后提示文件位置，可在 Roam 中直达定位。

九、格式覆盖与转码兜底

和 Roam 使用指南 同一套「原生直放 + 转码兜底」：

• 视频：mp4 m4v webm mkv mov ogv 原生播放；avi wmv flv rmvb rm mpg mpeg m2ts mts 3gp vob asf f4v ogm 自动转码；
• 音频：mp3 wav flac m4a aac ogg oga opus weba 原生播放；wma aiff aif ape ac3 mka amr au 自动转码；
• 已是通用编码的视频 = 秒级无损重封装，不损画质；转码产物有缓存，第二次打开瞬开；
• 转码显示进度、可取消；播放失败或长时间无响应会自动落转码，全程不用你操心。

十、跨重启记忆

播放列表、当前轨、播放模式、倍速、音量、窗口位置全部跨重启记忆——关掉 qd 再开，接着听；独立小窗置顶显示，跨桌面空间也看得见（macOS）。

延伸阅读：Roam 使用指南（q 键分派与格式全景） · 键盘与手势速查