slidev-presenter-mode

Slidev 演讲者模式

本技能介绍如何使用 Slidev 的演讲者模式进行专业演示，包括演讲者备注、计时器、幻灯片概览和远程控制功能。

何时使用此技能

• 准备现场演示
• 添加演讲者备注
• 使用双屏设置
• 通过手机远程控制
• 使用计时器排练

访问演讲者模式

通过导航栏

点击导航栏左下角的演讲者图标。

通过 URL

直接访问：

http://localhost:3030/presenter

键盘快捷键

按 p 切换演讲者模式（取决于配置）。

演讲者界面

演讲者视图会显示：

1. 当前幻灯片 - 观众看到的内容
2. 下一张幻灯片预览 - 即将展示的幻灯片
3. 演讲者备注 - 你的备注
4. 计时器 - 已用时间／剩余时间
5. 幻灯片导航器 - 快速跳转到任意幻灯片
6. 点击计数器 - 当前动画状态

演讲者备注

添加备注

在幻灯片末尾使用 HTML 注释：

# My Slide

Content visible to audience.

备注中的 Markdown

备注支持 Markdown 格式：

多行备注

备注最佳实践

双屏设置

推荐设置

1. 在外接显示器上以播放模式打开浏览器：

   http://localhost:3030
   

2. 在你的屏幕上以演讲者模式打开浏览器：

   http://localhost:3030/presenter
   

3. 将播放模式窗口共享／投影给观众

自动同步

两个窗口会自动同步：

• 导航保持同步
• 点击动画同步
• 绘图同步（如果已启用）

计时器功能

开始／停止

• 点击计时器即可开始／暂停
• 再次点击即可继续

计时器显示

显示：

• 已用时间
• 可配置为倒计时

计时器提示

• 开始演示时启动计时器
• 用于管理时间
• 仅演讲者可见

远程控制

从另一台设备控制

1. 启动服务器并启用远程访问：

   slidev --remote
   

2. 记下显示的 URL（或使用本地网络 IP）

3. 在手机／平板电脑上打开 URL

4. 远程控制演示

密码保护

slidev --remote=your_password

然后通过以下方式访问：

http://[ip]:3030/presenter?password=your_password

QR 码

Slidev 可以显示 QR 码，方便通过移动设备访问。

概览模式

访问概览

• 按 o 键
• 或导航至 /overview

功能

• 一次查看所有幻灯片
• 点击即可跳转到任意幻灯片
• 直接编辑备注（在概览模式下）
• 预览点击动画

演讲者模式下的导航

键盘快捷键

按键	操作
Space / →	下一个动画／幻灯片
←	上一个动画／幻灯片
↑ / ↓	上一张／下一张幻灯片（跳过动画）
o	概览模式
g	跳转到指定幻灯片编号
Esc	退出全屏／概览

触控／滑动

在触控设备上：

• 向左滑动：下一张幻灯片
• 向右滑动：上一张幻灯片

点击区域

在演讲者模式下：

• 左侧：上一张
• 右侧：下一张

演讲者模式配置

在 Frontmatter 中

---
# Remote access settings
remote: true

# Presenter notes settings
presenter: true
---

禁用共享链接的演讲者模式

共享时：

slidev build

构建版本默认不包含演讲者模式。

绘图工具

启用绘图

---
drawings:
  enabled: true
  persist: false
  syncAll: true
---

使用绘图

• 点击演讲者模式中的笔图标
• 在当前幻灯片上绘图
• 绘图会同步到观众视图

仅演讲者可见的绘图

---
drawings:
  presenterOnly: true
---

只有演讲者可以绘图，但所有人都能看到。

录制功能

内置录制

1. 点击演讲者模式中的录制按钮
2. 选择要录制的屏幕／窗口
3. 可选择启用摄像头
4. 开始录制

录制选项

• 仅录制屏幕
• 屏幕 + 摄像头
• 摄像头画中画

演示工作流

演示前

1. 测试设置：确认双屏正常工作
2. 检查备注：阅读所有演讲者备注
3. 练习：配合计时器完整演练
4. 检查动画：确认所有点击操作正常
5. 测试远程控制：如果使用手机控制

演示期间

1. 使用备注：快速查看关键要点
2. 关注计时器：按计划进行
3. 预览下一张：了解接下来的内容
4. 控制节奏：使用点击计数器

检查清单

PRE-PRESENTATION:
- [ ] Laptop charged/plugged in
- [ ] Projector/display connected
- [ ] Correct resolution set
- [ ] Browser in fullscreen (F11)
- [ ] Notifications disabled
- [ ] Presenter window on laptop screen
- [ ] Play window on projector

DURING:
- [ ] Timer started
- [ ] Notes visible
- [ ] Water nearby

POST:
- [ ] Save any drawings
- [ ] Export if needed

高级功能

自定义演示者布局

你可以通过主题自定义演示者视图。

多位演示者

共同演示时：

1. 双方都进入演示者模式
2. 指定由谁控制导航
3. 其他人可以查看，但无法控制

排练模式

# Practice without audience
slidev --open

然后在本地使用演示者模式进行练习。

故障排除

窗口不同步

1. 检查双方使用的 URL 基础地址是否相同
2. 刷新两个窗口
3. 检查网络/防火墙

笔记未显示

1. 验证注释语法：``
2. 笔记必须位于幻灯片末尾
3. 检查笔记之前是否有语法错误

计时器重置

计时器会在会话期间保留，但页面重新加载后会重置。

输出格式

准备演示者内容时：

# [Slide Title]

[Visible content for audience]

演示者设置：

1. 观众使用的 URL：http://localhost:3030
2. 演示者使用的 URL：http://localhost:3030/presenter
3. 远程 URL：http://[IP]:3030/?password=[pass]