PicoFacialBridge v0.3.1

简体中文

PicoFacialBridge v0.3.1：在 PICO 4 Pro 上运行的无需 Root 的眼动／面部追踪 bridge，PC 端搭配 UnifiedPicoModule 0.1.1。

• 修复：分别监控眼动与形态数据源，健康一路不再掩盖另一路停滞，单路停止更新时可正常触发重连。仅眼追模式也会检查辅助形态源，仅面捕模式不再等待原生眼动数据。
• 修复：诊断探针写入环形缓冲区快照失败时，释放共享内存映射与文件描述符。
• 修复：暂停提示区分“本地关闭传输”与“本地启用通道和 PC 订阅没有交集”。

本版 APK 与 v0.3.0 线协议兼容，可搭配 UnifiedPicoModule 0.1.0 及以上使用。

注意

• 已验证环境：PICO 4 Pro、PICO OS 5.13.7、Android 10、arm64-v8a；其他型号／固件未保证兼容。
• 这是自动 debug 签名 APK，不用于 Google Play。不同 CI 构建的签名可能不同，更新时可能需要先卸载旧版（会清除应用偏好设置）。
• 本次修复已在主机检查、lint 与构建中通过，尚未完成真机复测（单路停滞、诊断写盘失败、更新后的界面）。
• 仅在可信局域网使用；UDP 协议没有加密与身份认证。

English

PicoFacialBridge v0.3.1 is a rootless eye and face tracking bridge for the PICO 4 Pro, paired with UnifiedPicoModule 0.1.1 on the PC.

• Fixed: monitor the eye and morphology sources independently so a healthy stream cannot hide a stalled one; a stalled required source now triggers reconnection. Eye-only mode also checks the auxiliary morphology source, and face-only mode no longer waits for native eye data.
• Fixed: release the diagnostic probe's shared-memory mapping and file descriptor when writing the ring snapshot fails.
• Fixed: the pause message now distinguishes locally disabled transmission from no overlap with the PC subscription.

This release keeps the v0.3.0 wire protocol and works with UnifiedPicoModule 0.1.0 or later.

Notes

• Verified on PICO 4 Pro / PICO OS 5.13.7 / Android 10 / arm64-v8a. Other devices or firmware are not guaranteed compatible.
• This is an automatically debug-signed sideload APK, not a Google Play build; a different CI build's signature may require uninstalling the old app, which resets app preferences.
• The fixes pass host checks, lint and builds but have not yet been revalidated on hardware (single-source stall, diagnostic write failure, updated UI).
• Use a trusted LAN only: the UDP protocol is unencrypted and unauthenticated.

PicoFacialBridge v0.3.0

简体中文

PicoFacialBridge v0.3.0：在 PICO 4 Pro 上运行的无需 Root 的眼动／面部追踪 bridge。本版本改用 BridgeSplit 协议，PC 端需搭配 UnifiedPicoModule，不兼容原有的 PicoFacialDataModule、其分支以及旧 daemon。

• 眼动与面部数据按各自的源频率独立发送，只发送 PC 订阅的通道，订阅确认前不发送任何追踪数据。
• 自动检测普通／增强模式。在已 Root（Magisk）的头显上安装 PicoET-Enhance 后，会输出真实的逐眼视线与瞳孔直径，即增强模式。
• 眼追、面捕可独立开关，设置即时生效并保存，界面显示各路实际发送频率。
• 界面与通知支持中文／英文切换；前台服务支持启动、停止和重启，日常使用不需要 ADB 或 PICO Connect。

安装

从下方 Assets 下载 PicoFacialBridge-v0.3.0-arm64-v8a-debug.apk 并侧载到头显。PC 端按 UnifiedPicoModule 的说明安装模块并重启 VRCFaceTracking。完整步骤见中文 README。APK 与校验和见下方 Assets。

注意

• 已验证环境：PICO 4 Pro、PICO OS 5.13.7、Android 10、arm64-v8a；其他型号／固件未保证兼容。
• 本版本是协议不兼容的更新，不能从 v0.2.0 直接覆盖升级，请先卸载旧版再安装（会清除应用偏好设置）。
• 这是可直接安装的自动 debug 签名 APK，不用于 Google Play。不同 CI 构建的签名可能不同，更新时可能同样需要先卸载旧版。
• 头显整机重启后的恢复、与旧 daemon 共存、长时间运行的稳定性尚未验证。
• 仅在可信局域网使用；UDP 协议没有加密与身份认证。

English

PicoFacialBridge v0.3.0 is a rootless eye and face tracking bridge for the PICO 4 Pro. This version speaks the BridgeSplit protocol and requires UnifiedPicoModule on the PC. It is not compatible with the original PicoFacialDataModule, its forks, or the old daemon.

• Eye and face data are sent independently at their own source rates, carrying only the channels the PC subscribes to; no tracking data is sent before the subscription is acknowledged.
• Normal and enhanced modes are detected automatically. With PicoET-Enhance installed on a rooted (Magisk) headset, the bridge outputs true per-eye gaze and pupil diameter in enhanced mode.
• Independent, persistent eye and face switches, with the actual send rate of each channel shown in the app.
• Switchable English/Chinese UI and notifications; the foreground service supports Start, Stop and Restart, with no daily ADB or PICO Connect dependency.

Installation

Download PicoFacialBridge-v0.3.0-arm64-v8a-debug.apk from Assets below and sideload it onto the headset. On the PC, install the module as described by UnifiedPicoModule and restart VRCFaceTracking. See the English README for the full steps. The APK and checksums are in Assets below.

Notes

• Verified on PICO 4 Pro / PICO OS 5.13.7 / Android 10 / arm64-v8a. Other devices or firmware are not guaranteed compatible.
• This is a protocol-breaking update: it cannot be installed over v0.2.0. Uninstall the old version first, which resets app preferences.
• This is an automatically debug-signed sideload APK, not a Google Play build; a different CI build's signature may likewise require uninstalling the old app.
• Recovery after a full headset reboot, co-existence with the legacy daemon, and long-run stability are not yet verified.
• Use a trusted LAN only: the UDP protocol is unencrypted and unauthenticated.

致谢 / Acknowledgements

感谢 thoricelli 的 PicoFacialDataDaemon 与 PicoFacialDataModule。本项目参考了原项目的 Binder 调用、共享内存布局与 UDP 协议。

Thank you to thoricelli for the original projects. PicoFacialBridge was developed with reference to their Binder calls, shared-memory layouts and UDP protocol.

MIT License — project and upstream copyright notices are included in the APK and release assets.

PicoFacialBridge v0.2.0

简体中文

PicoFacialBridge v0.2.0：在 PICO 4 Pro 上运行的无需 Root 的眼动／面部追踪 bridge，通过局域网连接原版 PicoFacialDataModule 和 VRCFaceTracking。已实测可搭配 Virtual Desktop 正常使用。

• 眼追、面捕可独立开关，设置即时生效并保存。
• 显示各路实际发送 Hz，保留原始数据，不额外平滑或插值。
• 应用及通知支持中文／英文切换。
• 前台服务支持启动、停止和重启，无需日常使用 ADB 或 PICO Connect。

安装

从下方 Assets 下载 PicoFacialBridge-v0.2.0-arm64-v8a-debug.apk 并侧载到头显。PC 端需要安装 PicoFacialDataModule。完整步骤见中文 README。APK 和校验和已附加到下方 Assets。

注意

• 已验证环境：PICO 4 Pro、PICO OS 5.13.7、Android 10、arm64-v8a；其他型号／固件未保证兼容。
• 这是可直接安装的自动 debug 签名 APK，不用于 Google Play。不同构建签名可能不同，更新时可能需要先卸载旧版（会清除应用偏好设置）。
• 仅在可信局域网使用；兼容 UDP 协议没有加密或身份认证。
• 单通道 Avatar 表现与长时间休眠唤醒恢复仍需进一步测试；关闭传输不一定让 Avatar 恢复中性姿态。

English

PicoFacialBridge v0.2.0 is a rootless eye/face tracking bridge for PICO 4 Pro, forwarding LAN data to the original PicoFacialDataModule and VRCFaceTracking. Tested working alongside Virtual Desktop.

• Independent, persistent eye/face transmission switches.
• Actual per-stream transmission Hz; raw data without added smoothing or interpolation.
• Switchable English/Chinese UI and notifications.
• Foreground service with Start, Stop and Restart; no daily ADB or PICO Connect dependency.

Download PicoFacialBridge-v0.2.0-arm64-v8a-debug.apk from Assets and sideload it. Install PicoFacialDataModule on the PC. See the English README. The APK and checksums are available in Assets below.

Tested on PICO 4 Pro / PICO OS 5.13.7 / Android 10 / arm64-v8a. Other devices or firmware are not guaranteed compatible. This is an automatically debug-signed sideload APK, not a Google Play build; a different build's signature may require uninstalling the old app, resetting preferences. Use a trusted LAN only: the UDP protocol is unencrypted and unauthenticated. Single-channel avatar behavior and extended sleep/wake recovery need further testing; stopping a stream does not force a neutral avatar pose.

致谢 / Acknowledgements

感谢 thoricelli 的 PicoFacialDataDaemon 和 PicoFacialDataModule。本项目参考了原项目的 Binder 调用、共享内存布局和 UDP 协议。

Thank you to thoricelli for the original projects. PicoFacialBridge was developed with reference to their Binder calls, shared-memory layouts and UDP protocol.

MIT License — project and upstream copyright notices are included in the APK and release assets.