Windows10

Orbbec SDK 兼容标准UVC协议，支持的硬件设备符合标准UVC规格，因此不需要安装额外的驱动程序。

1. 验证设备状态

• 将设备连接到主机

• 导航至“控制面板”->“设备管理器”

• 浏览查找 Orbbec 设备，如下图所示，设备连接成功。(不同设备其通道数可能会有所不同, Data Channel 也并非所有设备都有)。

2. 配置OpenCV（Examples依赖）

数据渲染依赖第三方库OpenCV，这里以OpenCV 4.3.0为例演示安装配置

1）执行OpenCV安装文件，选择opencv要安装的目录，点击extract执行安装；

2）在系统的环境变量中添加OpenCV的路径，变量名输入OpenCV_DIR,注意字母的大小写，变量值为OpenCV安装目录的build文件夹路径；

3. 生成你的第一个应用程序

软件依赖：VisualStudio2019、cmake 3.10及以上版本

1）下载/获取我们的SDK软件包，存放位置假设为D盘根目录：“D:/V1.0.0”，目录结构如下所示：

2）打开Cmake，将“Examples”文件夹设置为代码路径，“Examples”下的“build”文件夹设置为生成二进制文件的路径，如下图所示。如Examples下无build，需要新建该文件夹。

3）点击“Configure”并选择对应的Visual Studio版本和平台版本后，点击“Finish”，如下所示：

4）点击“Generate”，如下所示：

5）可以通过以下两种方式打开Sample工程

方法一：通过cmake，点击“OpenProject”按钮，打开VisualStudio工程。

方法二：通过文件夹，Examples/build中的Visual Studio工程直接启动，如下图所示。

6）打开Examples工程界面如下所示：

7）选择你想要运行的工程，右键点击并将其“设置为启动项目”,在运行选项处选择release和64位版本

8）将设备连接到主机

9）将bin目录下的dll文件拷贝至执行文件处，运行工程，结果如下所示，至此第一个Eaxmple就运行成功了。

Android

1. 验证设备状态

1）准备一套P1开发板(A311D)，环境为Android9

2）准备ADB工具并再PC本地上配置环境变量

3）准备mirco usb数据线，用于A311D与PC机的连接，同时通过ADB工具可访问A311D系统作调试使用(识别A311D为免驱)，同时准备USB 3.0 Type-C数据线，连接A311D与Astra+相机。

4）以ASTRA+为例，判断A311D是否正常识别相机通过lsusb命令判断， VID：2bc5 PID：0532(彩色相机) VID：2bc5 PID：0636(深度相机) 如系统能正常识别到相机，在USB总线上会枚举到设备PID（如上图），表明A311D已识别到相机，可做后续操作。

2. AAR文件导入

我们已经将对应文件封装成了aar文件，你可以直接导入工程中。

1）将“obsensor_xxxx_release.aar”放到module下的libs目录；

2）在module的build.gradle的dependencies添加本地依赖；

3）点击AS的 File –> Sync Project with Gradle Files，等待更新完成；

4）配置AndroidManifest.xml权限，SDK运行中需要监听USB设备和摄像头的权限，在AndroidManifest.xml静态申请，并在Java/kotlin运行时动态申请；

5）在我们对应的Java文件中，”import com.orbbec.obsensor.*”，加入对应的代码，具体如下所示：如果正常打印出对应SDK版本信息，说明SDK集成成功。

3. Example工程导入

除了aar文件以外，我们也提供了example工程，可以直接打开对应的Android工程进行查看及开发。

4. 混淆配置

如果项目配置Proguard，那么需要对OrbbecSDK的Java class进行keep；

-keep class com.orbbec.obsensor.-dontwarn com.orbbec.obsensor.-keepclassmembers class com.orbbec.obsensor.** { *; }-keepclasseswithmembernames,includedescriptorclasses class * { native **;}

Linux

1、系统环境配置

1)安装libudev库：sudo apt install libudev-dev

2)安装libusb库：

sudo apt

install libusb-dev

2、USB访问权限配置

Linux系统默认对USB设备的直接访问需要root权限，可以通过rules配置文件解决。在OrbbecSDK发布的文件解压后，在根目录下会有一个“99-obsensor-libusb.rules”配置文件和“install.sh”安装脚本，通过sudo命令执行“install.sh”脚本，即可完成rules配置文件的安装。另外，如果“install.sh”安装脚本并没有执行权限，可通过改命令解决：“sudo chmod +x ./install.sh”。 成功执行安装脚本后，再接入设备时生效（已接入的设备需要重新拔插）。

3、验证设备状态

1）环境准备：ubuntu18.04 x64 desktop

2）以Astra+为例，使用USB 3.0 Type-C数据线，用于与PC机连接。

3）使用lsusb命令，查看是否PC系统有正确识别到相机

4）通过PID&VID来判断相机是否正常被识别VID：2bc5 PID：0532(彩色相机)VID：2bc5 PID：0636(深度相机)