Orbbec 3D 相机产品软件开发套件,全面支持 UVC,实现免驱动即插即用,提供低层和高层简单易用的 API,帮助开发者在不同场景下灵活使用。
此外,该 SDK 通过内置代码兼容 Orbbec 原有的 OpenNI 协议设备,开发者可以完全迁移到 OrbbecSDK,一套代码即可支持 Orbbec 的新一代产品和老产品。
如果你是中国的用户,建议使用 Gitee(gitee Repo)。
- library : OrbbecSDK 核心库文件和 C/C++ 头文件。
- examples : C/C++ 示例工程源码
- doc : API 参考文档和示例文档。
- driver : Windows 设备驱动,用于 OpenNI 协议设备(Dabai、Dabai DCW、Dabai DW、Astra mini Pro、Astra Pro Plus、A1 Pro、Gemini E、Gemini E Lite、Gemini),使用标准 UVC 协议的模块则无需安装驱动。
- scripts : Linux udev 规则,用于解决权限问题;Windows 时间戳注册脚本,用于解决时间戳和元数据问题。
当前遵循软件license结构如下
Operating system | Requirement | Description |
---|---|---|
Windows | - Windows 10 April 2018 (version 1803, operating system build 17134) release (x64) or higher,windows 11 | The generation of the VS project depends on the installation of the VS version and the cmake version, and supports VS2015/vs2017/vs2019 |
Linux | - Linux Ubuntu 16.04/18.04/20.04/22.04 (x64) | Support GCC 7.5 |
Arm32 | - Linux Ubuntu 16.04/18.04/20.04 | Support GCC 7.5 |
Arm64 | - Linux Ubuntu 18.04/20.04/22.04 | Support GCC 7.5 |
MacOS | - M series chip, 11.0 and above、intel x86 chip, 10.15 and above. | supported hardware products: Gemini 2, Gemini 2 L, Astra 2,Gemini 2 XL, Femto Mega, Gemini 330系列 |
- 注: 当前版本支持的Arm平台:NVIDIA Jetson AGX Orin (arm64), NVIDIA Jetson Orin NX (arm64), NVIDIA Jetson Orin Nano (arm64), NVIDIA Jetson AGX Xavier (arm64), NVIDIA Jetson Xavier NX (arm64), NVIDIA Jetson Nano (arm64), A311D (arm64), Raspberry Pi 4 (arm64), Raspberry Pi 3 (arm32), RK3399 (arm64), 其它Arm系统,可能需要重新交叉编译。
产品列表 | 固件版本 |
---|---|
Gemini 335 | 1.2.20 |
Gemini 335L | 1.2.20 |
Femto Bolt | 1.0.6/1.0.9/1.1.2 |
Femto Mega | 1.1.7/1.2.7/1.2.9 |
Femto Mega I | 2.0.2 |
Gemini 2 XL | Obox: V1.2.5 VL:1.4.54 |
Astra 2 | 2.8.20 |
Gemini 2 L | 1.4.32 |
Gemini 2 | 1.4.60 /1.4.76 |
Astra+ | 1.0.22/1.0.21/1.0.20/1.0.19 |
Femto | 1.6.7 |
Femto W | 1.1.8 |
DaBai | 2436 |
DaBai DCW | 2460 |
DaBai DW | 2606 |
Astra Mini Pro | 1007 |
Gemini E | 3460 |
Gemini E Lite | 3606 |
Gemini | 3.0.18 |
Astra Mini S Pro | 1.0.05 |
OrbbecViewer是一个基于Orbbec SDK的实用工具,用于查看来自Orbbec相机的数据流并控制相机.
支持平台: Windows x64, Linux x64&ARM64, MacOS M seires chip and Intel x86 chip
下载链接: Releases
OrbbecViewer使用说明: OrbbecViewer User Manual
git clone https://github.com/Orbbec/OrbbecSDK.git
您也可以通过二进制包进行安装,请参考安装指南获取更多信息。
- Linux:
如果您通过 Debian 包进行安装,则可以跳过 udev 规则文件的安装。如果没有,请使用以下命令进行安装:
cd OrbbecSDK/misc/scripts
sudo chmod +x ./install_udev_rules.sh
sudo ./install_udev_rules.sh
sudo udevadm control --reload && sudo udevadm trigger
- Windows: metadat时间戳注册: obsensor_metadata_win10
- 有关环境配置的更多信息请参考:Environment Configuration
示例代码位于./examples目录中,可以使用CMake进行编译
``bash cd OrbbecSDK && mkdir build && cd build && cmake .. && cmake --build . --config Release ``
首先连接Orbbec相机,然后运行如下脚本:``bash cd OrbbecSDK/build/bin # build output dir ./OBMultiStream # OBMultiStream.exe on Windows ``
下图是Gemini2 设备,运行MultiStream的结果图,其它设备运行的结果可能不一样.
注意事项: 在Linux或Arm平台,需要安装Opencv 4.2或以上版本,否则不能渲染.
在CMakeLists.txt文件中查找并链接Orbbec SDK:
cmake_minimum_required(VERSION 3.1.15)
project(OrbbecSDKTest)
add_executable(${PROJECT_NAME} main.cpp)
# find Orbbec SDK
set(OrbbecSDK_DIR "/your/path/to/OrbbecSDK")
find_package(OrbbecSDK REQUIRED)
# link Orbbec SDK
target_link_libraries(${PROJECT_NAME} OrbbecSDK::OrbbecSDK)
- Github:https://orbbec.github.io/OrbbecSDK/
- 概述文档:doc/tutorial/Chinese/OverviewDocument.md
- API 参考: doc/api/English/index.html
- 多机同步文档: Multi Camera Sync
- OrbbecSDK C++ API user guide:doc/tutorial/Chinese/OrbbecSDK_C++_API_user_guide-v1.0.pdf
- Environment Configuration:doc/tutorial/Chinese/Environment_Configuration.md
- 示例说明: examples/README.md