§ 1.5 OrbbecSDK-Python开发环境配置 (Windows)

1. 查看USB设备列表

使用USB 3.0 Type-C数据线，将Gemini2连接到PC的USB3.0端口上。

Windows工具栏搜索框输入 设备管理器 ，打开设备管理器。

查看设备列表 / 照相机

2. 下载Orbbec Python SDK

3. SDK 文件结构

下载到压缩包之后，拷贝到一个纯英文路径下，例如 D:\Orbbec 。文件夹名称太长，可以改短一些，重命名文件夹为 OrbbecSDK_Python 。

解压奥比中光的Orbbec SDK Python的压缩包：

目前奥比中光的Python SDK还不支持 Python 3.10 ，可以考虑结合Anaconda，创建Python 3.8的虚拟环境。

注：后续操作步骤都以 python3.8 为例

点开 python3.8 文件夹

  • lib 文件夹里面存放的是库
  • Samples 是实例代码

进一步打开 lib ，里面有两个文件夹：

  • c_lib ：Orbbec SDK 动态链接库

  • python_lib ：Orbbec SDK Python相关的动态链接库

将 c_lib 里面的动态链接库，拷贝到 python_lib 文件夹里。

4. 配置系统环境变量

在Windows底栏搜索框里面搜索 环境变量 ，点击 编辑系统环境变量

选择 环境变量(N) ，点开之后。编辑当前Windows用户下 PYTHONPATH 的系统环境变量 (没有的话就选择新建一个) 。

将 python_lib 的安装路径下文件夹，添加到系统环境变量 PYTHONPATH 里面。

  • D:\Orbbec\OrbbecSDK_Python\python3.8\lib\python_lib

5. 运行示例代码

打开一个新的终端，在终端进入到 Sample 文件夹下。

运行其中一个示例代码，预览彩图： 

python ColorViewer.py

6. 报错与处理方法

6.1 设备已经打开

如果出现如下报错： 

function: b'ob_create_pipeline'
args: b''
message: b'uvc_open  path=2-5.4.1-6.0 already opened'
type: 0
status: 1
*** Aborted at 1682359887 (unix time) try "date -d @1682359887" if you are using GNU date ***
PC: @                0x0 (unknown)
*** SIGABRT (@0x3e800002b51) received by PID 11089 (TID 0x7f250e666740) from PID 11089; stack trace: ***
    @     0x7f250e442520 (unknown)
    @     0x7f250e496a7c pthread_kill
    @     0x7f250e442476 raise
    @     0x7f250e4287f3 abort
    @     0x7f250b8f67b9 google::LogMessage::Flush()
    @     0x7f250b8f688e google::LogMessage::~LogMessage()
    @     0x7f250b869b6f libobsensor::pal::UsbContext::~UsbContext()
    @     0x7f250b86fc01 std::shared_ptr<>::~shared_ptr()
    @     0x7f250e445495 (unknown)
    @     0x7f250e445610 exit
    @     0x7f250e429d97 (unknown)
    @     0x7f250e429e40 __libc_start_main
    @           0x579c8d (unknown)
已放弃 (核心已转储)

说明有其他脚本/上位机正在占用相机，需要将其他软件关闭，才能释放相机。