### 安装、编译并配置用于 Python 的 Orbbec SDK 在 Ubuntu 系统下的步骤 #### 1. 系统要求 在开始安装和编译之前，需要确保系统满足以下条件： - **操作系统**：Ubuntu 18.04/20.04/22.04 (x64) [^1] - **Python 版本**：Python 3.6.9 及以上（推荐使用 Python 3.8 或更高版本） [^1] - **编译工具链**： - **gcc**：5.4.0 及以上 [^1] - **cmake**：3.15.0 及以上 [^1] - **pybind11**：2.10.3 及以上 [^1] #### 2. 安装依赖项 首先，更新系统包管理器并安装必要的依赖项： ```bash sudo apt update sudo apt install python3-pip python3-dev gcc cmake libusb-1.0-0-dev ``` 接下来，安装 `pybind11` 和其他必要的 Python 开发库： ```bash pip3 install pybind11 ``` #### 3. 下载 Orbbec SDK Python 源码 从官方仓库或提供的源码链接中下载 Orbbec SDK 的 Python 封装代码。如果官方提供了 Git 仓库，则可以使用以下命令克隆源码： ```bash git clone https://github.com/orbbec/orbbec-sdk-python.git cd orbbec-sdk-python ``` 如果没有提供 Git 仓库，则可以从官方网站下载源码压缩包，并解压到本地目录。 #### 4. 编译 Orbbec SDK 进入源码目录后，执行以下步骤进行编译： ##### 创建构建目录 ```bash mkdir build cd build ``` ##### 配置 CMake 使用 CMake 配置项目，指定 Python 路径和构建类型： ```bash cmake .. -DPYTHON_EXECUTABLE=$(which python3) -DCMAKE_BUILD_TYPE=Release ``` ##### 执行编译 ```bash make -j$(nproc) ``` 编译完成后，生成的二进制文件将位于 `build` 目录中。 #### 5. 安装 Orbbec SDK Python 包 编译完成后，可以使用 `pip` 将生成的 Python 包安装到系统中： ```bash pip3 install .. ``` 或者，如果编译过程中生成了 `.whl` 文件，则可以直接使用 `pip` 安装该文件： ```bash pip3 install pyorbbecsdk-2.0.7-cp310-cp310-linux_x86_64.whl ``` #### 6. 验证安装 安装完成后，可以通过运行一个简单的测试脚本来验证 Orbbec SDK 是否正常工作。例如，创建一个名为 `test_orbbec.py` 的文件，并添加以下代码： ```python import pyorbbecsdk as obs # 初始化设备 device = obs.Device() device.open() # 获取设备信息 print("Device Information:", device.getDeviceInfo()) # 关闭设备 device.close() ``` 运行该脚本： ```bash python3 test_orbbec.py ``` 如果一切正常，脚本将输出设备的信息，并成功关闭设备。 #### 7. 常见问题与解决方案 - **编译失败**：检查是否所有依赖项都已正确安装，特别是 `pybind11` 和 `cmake` 的版本。 - **找不到设备**：确保设备已正确连接，并且驱动程序已加载。 - **权限问题**：可能需要为 USB 设备添加 udev 规则，以允许非 root 用户访问设备。 ---