live2dviewerex 中文文档 下载 App

快捷键和面部捕捉 - 让 Live2D 角色会说话会做表情

为什么需要快捷键

直播时你不可能同时去点控制面板切换表情。通过快捷键，你可以在说"大家好"的时候按一下 F1 触发挥手动作，或者按 F2 切换到笑脸表情。

表情和动作设置

前提条件

模型必须已经配置了表情和动作事件（在 Live2D Cubism Editor 里做）。如果列表为空，说明模型没配这些内容，你需要去 EX 工作室里添加。

操作步骤

  1. 控制面板 → 模型 → 选中你的模型
  2. 点击「自定义」→ 表情 / 事件标签页
  3. 在列表中找到表情或动作事件
  4. 点击右边的设置图标，给它分配一个快捷键
快捷键设置界面
表情和动作事件的快捷键分配

常见快捷键分配（示例）

快捷键触发内容场景
F1挥手动作打招呼
F2笑脸表情聊到开心的事
F3惊讶表情回应弹幕
F4生气表情假装生气（弹幕说不好听的）
F5比心动作感谢礼物
F6待机循环回到默认状态

开启热键

控制面板 → 设定 → 通用 → 热键 → 选「总是启用」。

这个设置让 Live2DViewerEX 的快捷键在任何窗口都生效。如果只在 Live2DViewerEX 窗口聚焦时才生效，那做直播时就抓不到了（直播时焦点通常在 OBS 或直播软件上）。

热键总是启用
必须设为总是启用才能在 OBS 聚焦时也能用

模型切换的快捷键

除了表情和动作，你还可以给模型本身绑定快捷键——比如 F9 切换模型槽 1，F10 切换模型槽 2，实现"一键换角色"的效果。

面部捕捉 - 让角色跟着你做表情

原理

Live2DViewerEX 的面部捕捉实时分析摄像头画面中的人脸，提取：

然后把这些数据实时推送到模型参数上——你点头，模型也点头；你张嘴说话，模型嘴巴跟着动。

Windows / Mac 内置面捕

  1. 控制面板 → 模型 → 选中模型
  2. 点击「自定义」→ 面部追踪
  3. 开启面部追踪，选择摄像头设备
  4. 调整各项参数的灵敏度
  5. 看着摄像头做几个表情测试效果

面部参数映射

这是最关键的一步。面部捕捉输出了一堆参数，需要告诉模型"头转到 30° 时，模型的 ParamAngleX 参数也要调到 30°"。

控制面板 → 模型 → 自定义 → 参数映射：

面部捕捉参数通常映射到模型参数
头部左右转ParamAngleX / PARAM_ANGLE_X
头部上下点ParamAngleY / PARAM_ANGLE_Y
头部倾斜ParamAngleZ / PARAM_ANGLE_Z
身体角度ParamBodyAngleZ / PARAM_BODY_ANGLE_Z
左眼开合ParamEyeLOpen / PARAM_EYE_L_OPEN
右眼开合ParamEyeROpen / PARAM_EYE_R_OPEN
嘴巴张开ParamMouthOpenY / PARAM_MOUTH_OPEN_Y
眼球方向ParamEyeBallX / PARAM_EYE_BALL_X

不同模型的参数名可能略有差异，以模型制作者定义的为准。

面部捕捉应用打不开 / 闪退

官方 FAQ 提到这个问题，原因大概率是安装路径里有中文或特殊字符。解决方法：

手部追踪

Windows / Mac 版 Live2DViewerEX 内置手部追踪，通过系统摄像头识别手部关键点。同样需要在模型的参数映射里绑定手部参数（如果你的模型有手部的话）。

iOS Motion Tracker 高精度面捕

如果你的 PC 摄像头面捕精度不够，可以用 iPhone 当远程面捕设备（详细见下一页）。

性能提示

推流场景完整检查清单