LAPLACE Persona Tracker 是 LAPLACE 官方研发的 iOS 面部捕捉应用，可直接替代 iFacialMocap 或 Facemotion3d。移动端应用、桌面客户端及底层通信协议均由 LAPLACE 自主维护。
该应用支持实时传输全部 52 项标准 ARKit BlendShape 权重，以及头部的三维旋转姿态与空间位移。输入派生计算、眼动追踪滤波与模型参数映射均在桌面端统一解算，详见 捕捉数据如何抵达模型。
环境要求
需要配备支持 ARKit 面部追踪技术（具备 TrueDepth 原深感摄像头或支持 A12 仿生及以上芯片的单摄追踪）、运行 iOS 17 或 iPadOS 17 及以上版本的 iPhone 或 iPad 设备。应用在启动时会自动校验硬件兼容性。移动设备与运行 Persona 的电脑需处于同一局域网内。
配置步骤
- 在 Persona 客户端的面部捕捉面板中选用默认附带的 LAPLACE Persona Tracker 追踪源（或点击 添加面部来源… 新建），在卡片的分配虚拟形象弹窗中勾选目标虚拟形象，随后开启启用面部捕捉。
- 在 iOS 设备上打开应用并点击连接。系统会自动检索局域网内响应握手的电脑并列出，点击对应电脑条目的使用。首次配对时 iOS 系统将弹出本地网络访问权限授权提示。
- 调整至日常直播时的自然坐姿与视线朝向，点击准星图标（校准）将当前姿态锁定为中性基准。校准不提供重置选项：未校准时头部位移与旋转直接以摄像头为原点，仅在手机正对面部时才准确，因此任何校准都优于未校准；校准有误或手机移动后，再次点击校准即可覆盖。
建立连接后，原连接按钮文案将切换为更改，可用于切换连接至其他电脑或执行断开连接。
若当前局域网环境禁用了 UDP 广播发现机制，可在连接弹窗底部直接手动输入目标 IP 地址（即 Persona 捕捉面板中本机 IP 地址卡片列出的局域网地址）。
连接目标、端口与校准参数会在应用下次冷启动时自动恢复。姿态校准以手机与面部的相对几何位置为基准；若在直播过程中移动了手机支架位置，请重新执行校准。
网络端口
通信默认采用双向 UDP 端口 19700，收发握手均复用此通道。如需更换，请在 Persona 来源卡片的端口字段与移动端应用的设置 › 端口中填入相同的端口号。新添加的追踪源会从 19700 起自动选用首个未被其他来源占用的端口。
多个 LAPLACE Persona Tracker 追踪源可共用同一端口。若需要在单台电脑上并发接收多路设备信号，与其他面部追踪源相同，通过配置 追踪器 IP 区分，为各个来源卡片填入对应手机的局域网 IP 地址，即可由多台移动设备分别独立驱动不同虚拟形象。
若端口已被其他应用占用或被系统保留，Persona 会弹出「{来源名称} 无法使用端口 {端口}」通知。Windows 会从动态端口范围（默认 49152–65535）中为 Hyper-V、WSL2 与 Docker 预留端口段，可运行 netsh interface ipv4 show excludedportrange protocol=udp 查看；请在来源卡片中改用不在所列范围内的端口，并在手机端填入相同的端口。
早期版本固定使用端口
49700。为兼容尚未更新的移动端应用，使用默认端口的追踪源会同时在 49700
上监听；反之，若手机端已更新而 Persona 尚未更新，请暂时将手机端的端口设为
49700。
传输协议与数据精度
Persona 依然完全兼容并支持 iFacialMocap 协议，两者可在同一场景中并行工作。LAPLACE Persona Tracker 专有传输协议具备以下技术特性：
- 32 位单精度浮点权重：iFacialMocap 协议将各项 BlendShape 离散量化为 0–100 的整数。由于 Persona 在处理特定微表情信号时会施加算法增益（例如嘴角下垂信号采用 5 倍增益），1% 的整数阶跃在放大后可能导致模型表情出现肉眼可见的阶梯跳变；而本协议原生采用
Float32高精度浮点传输。 - 定长流式数据包：每帧完整打包传输 52 项 BlendShape 原始数值，采用紧凑定长二进制编码，无需在传输过程中逐项解析 ASCII 字符串键名。
- 局域网自动服务发现：移动端可自动探测并列出活跃的 Persona 实例供点选连接，免去繁琐的手动抄写 IP 过程；在广播受限的网络拓扑下，亦完整保留手动直连机制。
- 设备发热状态回传：数据帧头标志位携带设备的热状态（
ProcessInfo.thermalState）。当设备发热严重（.serious及以上）导致 ARKit 降频至 30 fps 时，移动端界面会在状态胶囊中显示红色温度计，同时 Persona 桌面端会弹出常驻通知提示设备需要降温。
该协议仅负责在网络层传输头部姿态与 52 项原生 BlendShape 采样值，不附加任何派生逻辑。所有运动学解算均在桌面端执行，相关算法公式优化与坐标轴向修正均可随桌面端热更新无缝交付。
状态指示与降温提醒
应用顶部的状态胶囊实时呈现当前工作状态：包括当前连接的电脑名称（未连接时显示未连接）、实时发送帧率（如 60 fps）以及面部追踪锁定状态（以微笑面孔图标或虚线轮廓指示）。
当 iPhone 或 iPad 长时间运行导致设备发热（系统热状态达到 .serious 或 .critical）时，iOS 系统的 ARKit 面部追踪会自动将采样率由 60 fps 降至 30 fps。此时：
- 移动端状态胶囊中会在面部图标旁显现醒目的红色温度计图标。
- Persona 桌面端会同步弹出一条常驻警告通知（「{设备名称} 需要降温：降温之前，面部捕捉无法保持 60 fps。」），提醒及时为手机通风降温。
设备温度恢复正常后，移动端温度计图标会自动隐去，桌面端通知状态亦会随之重置。
移动端应用设置
点击应用右上角的齿轮图标即可展开设置面板：
| 设置项 | 说明 |
|---|---|
| 节能模式 | 静置无操作数秒后以黑色遮罩覆盖屏幕、隐藏主屏幕指示条并渐暗调低系统亮度，同时暂停视觉渲染预览，后台保持全速持续传输捕捉数据。轻触屏幕任意区域即可唤醒 |
| 亮度 | 开启节能模式后显示。屏幕变暗后遮罩透出的亮度，范围 0%–50%，默认 10%。OLED 屏幕仅在像素纯黑时才会熄灭，设为 0% 最为省电 |
| 归一化面部网格 | 默认开启。在屏幕上将面部动作映射到标准化的通用面部网格，而非展示真实脸型轮廓，适合手机需要入镜直播的场景。网络传输的数据精度不受任何影响 |
| 端口 | 发送数据的目标端口，默认 19700，须与 Persona 来源卡片的端口一致。输入框失焦（按下 Return 或关闭设置面板）后生效，超出 1–65535 的数值将还原为原端口 |
移动端屏幕上的实时预览仅渲染由算法提取出的三维线框网格，不会显示摄像头原始视频画面：既方便直观确认面部捕捉状态，又能避免房间环境意外入镜。原始摄像头视频数据全程在设备内存沙盒中处理，不会离开手机本地。
最后更新于 2026年11月3日