安装指南

📦 开始安装
按照以下步骤完成 pyvitaisdk 的安装配置，开始您的视触觉传感器开发之旅。

---

📋 前置要求

在安装 SDK 之前，请确保您的系统满足以下要求：

✅ Python 环境

• Python 3.10 或 3.12（推荐 3.12）
• pip 包管理器

✅ 系统要求

• Ubuntu 20.04/22.04/24.04 或 Windows 10/11 或 MacOS 15

✅ 依赖工具

• conda（推荐）或 venv

---

🚀 安装步骤

方法一：使用 Conda（推荐）

💡 推荐方式
使用 Conda 可以更好地管理 Python 环境和依赖包，避免版本冲突。

# 步骤 1: 创建 Python 环境
conda create -n py312 python=3.12

# 步骤 2: 激活 Python 环境
conda activate py312

# 步骤 3: 安装 pyvitaisdk
pip install pyvitaisdk-*.whl

方法二：使用 venv

如果您不使用 Conda，也可以使用 Python 内置的 venv：

# 步骤 1: 创建虚拟环境
python3.12 -m venv vitai_env

# 步骤 2: 激活虚拟环境
# Linux/MacOS:
source vitai_env/bin/activate
# Windows:
vitai_env\Scripts\activate

# 步骤 3: 安装 pyvitaisdk
pip install pyvitaisdk-*.whl

---

✅ 验证安装

安装完成后，运行以下命令验证安装是否成功：

创建一个简单的测试脚本：

from pyvitaisdk import VTSDeviceFinder

# 查找设备
finder = VTSDeviceFinder()
devices = finder.get_devices()

if devices:
    print(f"✅ 成功找到 {len(devices)} 个设备")
else:
    print("⚠️ 未检测到设备，请检查连接")

---

🔧 常见问题

❓ 找不到 .whl 文件

获取安装包

pyvitaisdk 的 .whl 文件可以通过以下方式获取：

• 从官方网站下载最新版本 https://github.com/ViTai-Tech/ViTai-SDK-Release

❓ 依赖包冲突

依赖冲突解决

如果出现依赖包版本冲突：

1. 建议在全新的虚拟环境中安装
2. 使用 pip install --upgrade pip 更新 pip
3. 检查 Python 版本

❓ 在 Windows 上无法识别设备

USB 驱动安装

Windows 用户需要确保：

• 设备管理器中设备显示正常
• 尝试更换 USB 端口

---