Windows - Xvisio SDK 下载安装指南

注意：由于虚拟机的usb3.0和本机的硬件之间存在转换层，会引起usb通讯的不稳定和性能，所以不建议在VM中安装使用Xvisio SDK和设备。

先决条件

• Windows10和Windows11 系统

Windows 环境安装

• 检查设备：
  使用 USB 连接 Xvisio 设备到 PC，如果 Xvisio 设备连接正常，那么通常会有3个设备枚举，可以通过系统的设备管理器查看设备状态：
  
  1.检查设备 "VSC interface" 状态，如果有感叹号或异常状态符号提示(见上图)，那么需要安装驱动。
  2. 照相机设备"XVisio vSLAM"，此设备无需安装驱动，也请检查此设备状态是否异常。
  3. "USB Composite Device"：通过属性查看硬件 ID "VID:040E" , “PID:F408" ，此设备也无需安装驱动。
• 安装驱动：
  1.获取驱动安装工具 zadig 。
  2. 双击下载好的 "zadig-2.3.exe" 。
  
  3. 选择 "VSC interface(interface 0)" 。
  4. 选择 "libusg-win32(v1.2.6.0)" 驱动版本。
  5. 检查 USB ID 为 "040E F408 00" 。
  6. 点击 “ Install Driver” 进行升级。
  7. 请耐心等待数分钟。
  
  8. 升级完成，如果提示 "The driver was installed successfully" 表示安装成功，否则表示失败 ，点击close 结束退出安装。
  
  9. 检查系统设备管理器的"VSC interface"设备状态是否正常。
  
  10. 上述过程如遇到异常不能安装或安装失败，请检PC的USB状态、USB连接线、Xvisio device的工作状态，或者联系 Xvisio FAE 人员寻求帮助。

SDK 下载

Xvisio SDK 支持 Windows10 和 Windows11 ,其它没有提及的都是不支持的。
Xvisio Windows SDK 提供了如下四种版本:

注意：请您根据当前开发环境的微软 visual studio 版本来选择要下载的SDK版本，如果您没有安装微软 visual studio那么可以任意选择一个版本进行安装，推荐下载"MS visual c++ 2019 64位运行库版本"。

SDK 安装

请您根据开发环境选择下载所需的安装包，双击运行:

1. 点击 “下一步”：
   
2. 点击 “我接受”：
   
3. 选择安装位置，并点击 "下一步"：
   
4. 选择开始菜单文件和快捷方式，并点击 "下一步"：
   
5. 选择组件(推荐全部选择),并点击 “安装” ：
   
6. 安装结束，点击 “完成”。
   
7. 添加系统环境变量

• 在“我的电脑”上右击鼠标，在弹出的菜单中选择“属性”。
  
• 点击右侧“高级系统设置” 。
  
• 弹框中点击 “环境变量” 。
  
• 选中系统变量框中的 "Path" 项，点击 “编辑” 。
  
• 点击“新建”后点击“浏览”。
  
• 选择 sdk 安装路径的 bin 目录 ，点击 “确定”。
  
• 点击 “确定” 退出环境变量编辑。

检查安装

• 运行"demo-api"程序进行版本检查:
  1.启动 windows powershell 工具并导航到安装目录下 bin 目录，输入程序名称并回车:
  ./demo-api.exe
  
  注意：如果环境变量设置完成，可以在任意目录下输入 "demo-api"执行程序。
  2. 输入字符 1 并回车:
  
  3. 如上图，安装成功的话会输出:
  xvsdk version: 3.2.x-xxxxxxxx
  请检查读取的版本和此次安装的版本是否一致，当前安装版本的获取是通过查看当前安装版本的release note，检查此项是可以不连接xvisio设备。
• 查看安装目录
  请对照 Windows sdk 目录 检查对应的安装目录是否一致。

←  SDK 安装
←  Xvisio SDK 文档主页