Orbbec SDK Python 深度摄像头开发指南
Orbbec SDK Python 绑定为开发者提供了在 Python 环境中控制奥比中光深度摄像头的完整解决方案。这个开源项目让您能够直接使用 Python 编程语言来操作 Orbbec 品牌的 RGB-D 设备，包括 Astra 系列、Gemini 等产品线，实现数据流获取、设备配置和实时处理等功能，特别适合计算机视觉、三维建模和物体识别等应用场景。
快速入门：5 分钟搭建开发环境
获取项目源码
首先从仓库克隆项目到本地：
git clone <repository_url>
cd pyorbbecsdk
安装系统依赖
对于 Ubuntu 系统，确保安装必要的开发包：
sudo apt-get install python3-dev python3-venv python3-pip python3-opencv
创建 Python 虚拟环境
python3 -m venv venv
source venv/bin/activate
pip3 install -r requirements.txt
构建 Python 绑定
在项目根目录执行构建命令：
mkdir build && cd build
cmake -Dpybind11_DIR=$(pybind11-config --cmakedir) ..
make -j4
make install
配置设备权限
运行 udev 规则安装脚本：
sudo bash ./scripts/install_udev_rules.sh
sudo udevadm control --reload-rules && sudo udevadm trigger
核心功能深度解析
实时数据流处理架构
Orbbec SDK Python 绑定的核心基于 Pipeline 设计模式，通过统一的接口管理颜色流和深度流。系统架构采用模块化设计，确保高效的数据传输和处理性能。
多格式图像转换支持
项目提供完整的图像格式转换工具，支持：
- YUYV/YUY2：标准 YUV 4:2:2 格式
- UYVY：另一种 YUV 4:2:2 排列
- I420：YUV 4:2:0 平面格式
- NV12/NV21：半平面 YUV 格式
- MJPG：运动 JPEG 压缩格式
设备兼容性矩阵
Orbbec SDK Python 绑定全面支持以下设备系列：
| 产品系列 | 推荐型号 | Python 版本支持 |
|---|---|---|
| Gemini | Gemini 2 L, Gemini 435Le | Python 3.8-3.13 |
| Astra | Astra 2, Astra Mini Pro | Python 3.8-3.13 |
