安装

环境要求

使用 Python 3.9 或更高版本的 CPython，并选择与操作系统、CPU 架构相匹配的安装包。

操作系统	CPU 架构	安装包平台标识
Windows	x64	win_amd64
Linux	x64	manylinux_2_31_x86_64
Linux	ARM64	manylinux_2_31_aarch64

Linux 需要 glibc 2.31 或更高版本。使用 BLE 时，系统还需要可用的蓝牙适配器，以及运行中的 BlueZ 和 D-Bus 服务。

安装 Python 包

获取官方提供的 xenseglovesdk wheel（.whl）安装包后，在目标 Python 环境中执行：

python -m pip install "路径/实际安装包文件名.whl"

将引号中的内容替换为下载的文件路径。文件名中的 cp39-abi3 表示支持 Python 3.9 及后续常规 CPython 版本；安装包的操作系统和 CPU 架构仍需与运行环境一致。

验证安装

python -c "import xenseglovesdk; print(xenseglovesdk.__version__)"

成功输出 SDK 版本号后，即可使用 Python 接口。此步骤不需要连接手套。

连接前准备

USB 串口

1. 使用支持数据传输的 USB 线连接手套和计算机。
2. 关闭正在占用手套串口的应用。
3. 使用 XenseGlove.list_ports() 查找手套端口。

设备可能显示为两个串口，请选择数据端口（CDC0）。Windows 端口名通常为 COM5，Linux 通常为 /dev/ttyACM0 或 /dev/ttyUSB0，以扫描结果为准。SDK 使用默认串口设置，无需手动配置波特率。

Linux 用户需要具有串口访问权限。若连接时出现权限错误，请检查设备权限和当前用户所属的串口访问组。

蓝牙低功耗（BLE）

确认手套支持 BLE、处于开机状态，并开启计算机蓝牙。SDK 使用系统的第一个蓝牙适配器，可通过以下接口查询其状态：

from xenseglovesdk import XenseGlove

print(XenseGlove.is_bluetooth_enabled())

返回 True 表示蓝牙已开启。该方法仅查询状态；系统蓝牙异常时可能抛出异常。

环境准备完成后，继续阅读快速开始。