00:00 / 00:00

Persona

Stream Deck

Persona 的官方 Elgato Stream Deck 插件,把 插件 API 接到一排实体按键上:切换模型、激活场景、触发热键、运行自动化、开关表情、播放动作,以及在舞台上移动和缩放形象

它和 Web 控制台 走的是同一套 API,在桌面应用中开启 API 并创建密钥后即可连接

前置条件

需要说明
Stream Deck7.1 或更高版本,macOS 12+ 或 Windows 10+
LAPLACE Persona正在运行,并且 插件 API 已开启
API 密钥设置 → 插件 API 里创建一把

安装

在页面上点安装,剩下的交给 Stream Deck 应用;在 Stream Deck 应用内置的 Marketplace 里搜索 LAPLACE Persona 也一样。装好之后,Stream Deck 应用右侧的动作列表里会多出 LAPLACE Persona 这一类

连接

把任意一个动作拖到按键上,右侧属性面板的底部有两个字段:

字段填什么
Persona Address留空即 127.0.0.1:25034。也接受 主机主机:端口,或一整条 ws:// URL
API Key你在 Persona 里创建的那把密钥的令牌

所有动作共用这两个连接设置,只需填写一次

连上之后,Persona 的 已连接的客户端 里会出现一行 Elgato Stream Deck,开发者是 LAPLACE

动作

激活场景运行自动化之外,其余动作都作用于当前场景的 主模型

动作作用
切换模型把主形象换成选定的模型。场景里一个模型都没有时,它会直接添加一个
激活场景应用某个已保存的 场景
触发热键运行当前模型的某个 快捷键。和 VTube Studio 一样,热键属于模型
运行自动化触发某条 自动化——执行其中的全部操作,无需绑定键盘组合键
切换表情开关当前模型的某个 表情
播放动作播放当前模型的某段 动作。这段动作正在播时再按一次,它就停下
移动模型朝一个方向微移形象。按住持续移动
缩放模型放大或缩小形象。按住持续缩放
重置变换把这个形象的位置、缩放和旋转恢复原状

模型、场景、热键、自动化、表情和动作这几个下拉框,内容会从正在运行的 Persona 实时获取。属性面板开着时,自动化列表还会跟着你的改动即时更新,暂停的自动化显示为灰色。没连上时下拉框里是一行说明原因的提示,而不是一片空白

移动与缩放

这两个动作各自可以配置步进。按住不放会在约三分之一秒后开始自动重复,之后每 100 毫秒走一步;中途出错就停下来,并让按键闪一次警告

动作参数
移动模型方向(上、下、左、右)、2D Step(像素)和 3D Step(世界单位)
缩放模型方向(放大、缩小)和 Factor,默认 1.1

两个步进值分别对应 Live2D 的屏幕空间和 VRM 的世界空间,所以同一个按键在两种格式上都合用。缩放会被限制在面板本身的范围内,持续按住也不会超出缩放范围。小于 1 的 Factor 一律按这个比例缩小,此时方向不起作用

按键

按键的图案是 Persona 的标志加上这个动作的图标,动作名跟随 Stream Deck 应用自己的语言。你给按键设了标题,标题会画在图案之上;换成自定义图片,整张图就都由你决定

动作成功会闪一次对勾,失败闪一次警告图标并在插件日志里记一行。按住期间不闪对勾,免得每一步都闪一下

最后更新于 2026年9月19日

Tech otakus destroy the world