Linux系统

在 Linux 上，需要的依赖可以通过以下方式安装

系统依赖安装

基础依赖

sudo apt update
sudo apt install -y build-essential cmake

HID设备相关依赖

sudo apt install -y libudev-dev libusb-1.0-0-dev libhidapi-libusb0

图像处理库依赖

sudo apt install -y libgif-dev

OpenCV库

sudo apt install libopencv-dev

注意

如果可以检测到设备,但是无法进行操作,请尝试使用 sudo 提权.

macOS 系统

在 macOS 上，需要的依赖可以通过以下方式安装

依赖安装

使用 Homebrew（推荐）

# 如果尚未安装 Homebrew，先安装
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装所需依赖
brew install cmake
brew install hidapi
brew install jpeg
brew install libpng
brew install opencv

手动安装

如果您更喜欢手动安装或需要特定版本：

CMake

从 cmake.org 下载并安装

HIDAPI

# 克隆并构建 HIDAPI
git clone https://github.com/libusb/hidapi.git
cd hidapi
./bootstrap
make
sudo make install

图像处理库

# 安装 libjpeg
brew install jpeg

# 安装 libpng
brew install libpng

# 安装 OpenCV
brew install opencv

注意

导航到 ImgProcesser/third_party 目录并运行以下脚本以创建 OpenCV 库的符号链接：

bash link_opencv_symlinks.sh

此脚本将在 opencv/mac/lib 中创建必要的符号链接，以允许 CMake 正确定位 OpenCV 库。

Windows系统

在 Windows 上，StreamDock SDK 提供了预编译的库文件，简化了安装过程。

系统要求

• Windows 10/11 (64位)
• Visual Studio 2022 (推荐)
• CMake 3.16 或更高版本

预编译库

SDK 已包含以下预编译库：

Transport DLL

• transport.dll - Release版本
• transport.lib - Release导入库
• OpenCV 库

位于 ImgProcesser/third_party/opencv/windows/x64/vc17/ 目录：

• opencv_core4120.dll - OpenCV核心模块
• opencv_imgcodecs4120.dll - 图像编解码模块
• opencv_imgproc4120.dll - 图像处理模块

编译和构建

使用批处理脚本

# 运行提供的批处理脚本
build.bat

手动构建

# 创建构建目录
mkdir build
cd build

# 生成Visual Studio项目文件
cmake -G "Visual Studio 17 2022" -A x64 ..

# 编译Release版本
cmake --build . --config Release

# 编译Debug版本
cmake --build . --config Debug

运行时依赖

运行程序时，确保以下DLL文件在可执行文件同一目录或系统PATH中：

• transport.dll
• opencv_core4120.dll
• opencv_imgcodecs4120.dll
• opencv_imgproc4120.dll

DLL集成

// Windows平台自动加载transport.dll
// 无需额外配置，SDK会自动处理
TransportCWrapper transport(deviceInfo);