### PyOrbbecSDK 安装与使用指南 #### 项目概述 PyOrbbecSDK 是 Orbbec SDK 的 Python 绑定库，允许开发人员通过 Python 访问和控制 Orbbec 设备。此绑定提供了丰富的 API 来获取设备数据并执行各种操作。 #### 获取源码 可以从指定的 GitCode 地址下载该项目[^1]: ```bash git clone https://gitcode.com/gh_mirrors/py/pyorbbecsdk.git ``` #### Windows 系统下的环境准备 对于 Windows 用户，在完成克隆仓库之后还需要额外的操作来确保所有必要的动态链接库都位于适当的位置以便于程序调用。具体来说就是将 `c_lib` 文件夹内的 `OrbbecSDK.dll`, `OrbbecSDK.lib` 和 `python_lib` 中所有的 `.pyd` 文件拷贝至 `Samples` 文件夹内[^2]。 #### Ubuntu 系统配置实例 针对 Linux (Ubuntu 20.04) 平台上的设置流程如下所示： - Astra2 相机支持； - CUDA 版本为 11.0.1 及 cuDNN v8.9.7 已经预先安装好； - Python 解释器版本号应设为 3.8.19 或以上； - 需要提前准备好 Numpy 库以及 PyTorch 深度学习框架等依赖项[^4]. #### 示例代码片段展示 下面给出一段简单的例子用于说明如何利用 PyOrbbecSDK 进行基本的数据采集工作： ```python from pyorbbec import DeviceManager, FrameSet device_manager = DeviceManager() devices = device_manager.get_devices() if not devices: print("No connected devices found.") else: dev = devices[0] pipeline = dev.create_pipeline() try: frames: FrameSet = pipeline.wait_for_frames(5000) color_frame = frames.get_color_frame() if color_frame is None: raise Exception("Color frame unavailable!") width = color_frame.get_width() height = color_frame.get_height() data = color_frame.get_data().reshape((height, width, 3)) print(f"Captured image with dimensions {width}x{height}.") finally: del pipeline ```