常见问题

这里整理了 XenseSDK 安装、运行和设备连接过程中常见的问题。单击问题即可展开答案。

安装与推理

如何安装 XenseSDK？

XenseSDK 已发布到 PyPI，可以直接运行以下命令安装：

pip install "xensesdk[full]" -i https://repo.huaweicloud.com/repository/pypi/simple/

安装 ONNX Runtime 后为什么仍然使用 CPU 推理？

运行以下命令，检查 ONNX Runtime 的 CUDA 共享库依赖是否完整：

ldd site-packages/onnxruntime/capi/*cuda*.so

如果输出中存在 not found，需要补充对应的 CUDA 或 cuDNN 依赖。

设备连接与故障排查

多个传感器连接到同一个 Hub 后，为什么部分设备无法识别？

2026 年 7 月之前生产的部分传感器未进行带宽配置，USB 带宽占用可能较高。

建议先分别连接传感器进行确认。如需同时使用多个传感器，请联系技术支持进行带宽配置。

传感器图像持续闪烁或频繁断开连接怎么办？

这通常与传感器连接线有关。请依次检查传感器线缆、USB 接口和延长线；如果正在使用延长线，建议先移除延长线并重新测试。

晃动传感器时，力数据为什么会发生跳动？

传感器内部相机可能已经松动，需要联系技术支持并返厂检修。