跳到主要内容

安装指南

📦 开始安装
按照以下步骤完成 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 文件可以通过以下方式获取：

❓ 依赖包冲突​

依赖冲突解决

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

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

❓ 在 Windows 上无法识别设备​

USB 驱动安装

Windows 用户需要确保：

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