§ 1.1 pyorbbecsdk - 开发环境配置 (Windows)

0. 概要

本文讲解了在Windows操作系统下配置奥比中光 3D相机pyorbbecsdk开发环境的操作流程。

教程适用的开发平台：

PC (台式机/笔记本) CPU架构： x64 架构 / AMD64 架构
注意事项：
- x64架构与AMD64架构本质上是同一个架构。
- 如果你的CPU是Arm架构等其他架构，需要自己从源码进行编译。
操作系统：Windows
Python版本： 3.10
注意事项：
- Python 3.8 / 3.9 / 3.10 / 3.11 都可以用，只是说我们只提供了 3.10 的动态链接库。
  
  如果是其他版本，需要自己从源码进行编译。
- Python 3.12 太新了不要用。

注意事项

如果你之前没有用过Python，需要先去学习一下Python基础，我们不提供Python基础入门的技术支持。

1Z实验室官网 ( http://deepsenserobot.com ) 有 Python科学计算 与 OpenCV 的免费入门教程。
如果你对Python不熟悉，不会用Anaconda，搞不清楚自己运行的是哪个Python，那就不要使用Anaconda，我们不提供相关技术支持。
如果你的PC上同时安装了多个Python版本，需要全部删掉，重新只安装Python 3.10。

1. pyorbbecsdk概述

pyorbbecsdk是奥比中光最新的Orbbec SDK Python Wrapper。API相对于Orbbec SDK Python要更加友好，与Realsense的pyrealsense的使用体验比较接近。

支持的操作系统与CPU系统架构如下：

Windows x64
Linux x64
Linux Arm64

英伟达的Jetson系列开发板，用的是博通芯片，CPU属于 Arm64 架构，如果想在Jetson开发板上调用奥比中光的pyorbbecsdk，需要自己从源码编译。
Windows x86
Linux Arm32

阿凯只提供了 Ubuntu x64 架构的 Python 3.10 版本的 pyorbbecsdk 的动态链接库。其他的Python版本或者CPU架构需要自己从源码编译。

2. 安装Python依赖

注意事项 1

pyorbbecsdk 案例测试是非必要的，除非是阿凯机器人工具箱中的Gemini335不能正常使用，需要验证一下 pyorbbecsdk 是否匹配。

具体可以看 pyorbbecsdk 测试样例前面部分，查看自己CPU架构还有Python版本。

import platform

cpu_architecture = platform.machine()
print("CPU架构:", cpu_architecture)

# 这里需要强调下, x64跟AMD64本质上就是同一种架构
# 只是说，在Ubuntu下获取的架构名称为x86_64, 在Windows下获取的架构名称为AMD64
if cpu_architecture not in  ["x86_64", "AMD64"]:
    print("特殊架构，不能直接使用现有动态链接库。需要自己从源码编译pyorbbecsdk")
    print("具体步骤, 需要看我们官网(deepsenserobot.com)中pyorbbeck开发环境配置相关章节")

注意事项：在Windows下，使用Python获取的CPU架构的名称为 AMD64 ，他们本质上是一回事儿。

输出日志

CPU架构: x86_64

你也可以跳过此步骤，直接跳到阿凯机器人工具箱安装环节，会自动安装所有需要的依赖包。详情见 阿凯机器人工具箱(Ubuntu) 里面的安装过程。
如果你使用的是Anaconda Python虚拟环境，详情见 阿凯机器人工具箱(Ubuntu+Anaconda) 里面的安装过程。

Python开发环境配置，以及VSCode的使用教程，见1Z实验室 ( http://deepsenserobot.com ) 免费课程《Python科学计算》。

Python科学计算-Python开发环境配置(Windows)

演示如何安装Python依赖库：

打开命令行，在命令行里输入

pip install <要安装的包名>

通过Python的包管理工具 pip 安装所需的包。

手动安装测试pyorbbecsdk所需的依赖。

安装矩阵计算库
```
sudo pip3 install numpy
```

安装 Jupyter Web IDE
```
sudo pip3 install jupyter
```
安装 Matplotlib
```
sudo pip3 install matplotlib
```

安装 OpenCV | 图像处理库

sudo pip3 install opencv-python --upgrade

sudo pip3 install opencv-contrib-python --upgrade

安装 Open3D 点云处理库
```
sudo pip3 install open3d
```
需要注意的是，通过 pip 安装的Open3D不带Cuda加速功能，如果想使用带Cuda加速版本的Open3D则需要从源码编译。
安装 pybind11
```
sudo pip3 install pybind11
```