Wuji Hand
Wuji Glove
Wuji Studio
Wuji SDK产品介绍
概述
Wuji SDK 是面向所有 Wuji 设备的通用开发套件，覆盖数据手套、灵巧手等产品线，提供 Python 与 C 两套接口。通过统一的设备管理、实时数据订阅和语义化 API，让不同产品拥有一致的开发体验。
当前版本支持 Wuji Glove、Wuji Hand 和 Wuji Hand 2（Beta 1）。两款 Wuji Hand 接入方式：
- Wuji Hand 2（Beta 1） — 直接使用 Wuji SDK，详见 Wuji Hand 2 SDK 接口。
- Wuji Hand — 直接使用 Wuji SDK（USB 接入，与 Wuji Hand 2 接口对齐），也可继续使用独立的 wujihandpy 包，详见 Wuji Hand SDK 使用说明。
核心功能：
- 设备管理 — 自动发现局域网内的 Wuji 设备，支持多设备并行连接与管理
- 实时数据订阅 — 触觉矩阵、EMF 位姿、手部追踪、IMU 等多种数据流，支持 async/await 与回调两种接收模式，多设备场景下也支持跨设备合并订阅
- 数据录制 — 多通道传感器数据同步录制到 MCAP 文件，支持暂停/恢复、分集切换和实时质量监控
- 语义化 API — 类型安全的访问接口，通过
glove.tactile()、glove.emf_poses()等语义方法直接获取数据 - 设备参数读写 — 查询序列号、固件版本等设备信息，修改网络配置等可写参数
使用前准备
系统要求
通用要求：
| 项目 | 要求 |
|---|---|
| 操作系统 | Ubuntu 22+ |
| 网络 | 以太网（与 Wuji 设备同一网段） |
按所选 SDK 的额外要求：
- Python SDK：Python 3.10+
- C SDK：C 编译器（gcc / clang）
安装
| 语言 | 安装方式 |
|---|---|
| Python | PyPI 包 wuji-sdk：pip install wuji-sdk |
| C | 从 Release 页面 下载对应平台 tarball wuji-sdk-c-<version>-<target>.tar.gz，解压后含 lib/libwuji_sdk_c.so 与 include/wuji_sdk.hCMake 示例与最小链接方式见 C 接口参考 · CMake 工程示例 |
使用 Wuji Glove 前还需完成硬件连接与网络配置，详见 使用前准备。