Gemini 336 产品 Wiki 汇总了产品定位、官方资料入口、SDK 接入流程、ROS 2 开发路径与常见问题。本文档面向需要评估、连接或集成该设备的开发者。
| 产品型号 | Gemini 336 |
|---|---|
| 产品分类 | 双目结构光相机 |
| 文档语言 | 中文 |
| 资料核对日期 | 2026-07-28 |
| 官方产品页 | 查看奥比中光官方资料 |
产品概述
Gemini 336是Gemini 330系列的全新成员，延续Gemini 335出色的深度效果和性能，通过过滤可见光，提升主动红外成像表现，针对性优化户外强光场景/室内强光场景中反光区域/阳光射入的高动态场景中暗部区域的深度质量，为用户提供稳定的高质量深度数据。
产品规格、固件、支持的数据流组合及供货状态可能更新。涉及选型和量产时，请以奥比中光官方产品页及当前版本产品手册为准。
文档与开发资源
开始使用前
- 确认设备铭牌上的型号与本文档一致。
- 根据官方产品手册确认接口、供电方式和支持的平台。
- 使用稳定的数据线并优先直接连接电脑，避免未经验证的扩展坞。
- 关闭可能占用设备的查看器、驱动节点或其他采集程序。
- 从官方资料确认当前型号适用的 SDK、驱动和固件版本。
使用 Orbbec SDK v2
获取 SDK
git clone https://github.com/orbbec/OrbbecSDK_v2.git
cd OrbbecSDK_v2
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j4不同操作系统的依赖项和安装方式可能不同，应以 SDK 仓库当前版本的 README 为准。
推荐的设备验证顺序
- 创建 SDK 上下文并枚举设备。
- 读取设备信息，确认程序识别到 Gemini 336。
- 查询设备实际支持的数据流 Profile。
- 先使用受支持的默认配置启动单路深度流。
- 稳定出图后，再启用彩色流、点云、对齐或其他功能。
- 结束采集时停止数据管线并释放设备资源。
数据流配置原则
不要直接复制其他型号的分辨率、帧率或像素格式。应用程序应先查询 Gemini 336 当前固件与 SDK 返回的可用 Profile，再选择配置。
ROS 2 接入
使用 OrbbecSDK ROS 2 Wrapper 时，请选择与 Gemini 336 对应的 Launch 配置。仓库结构和启动参数可能随版本变化，应以当前 README 和 Launch 文件为准。
mkdir -p ~/orbbec_ros2_ws/src
cd ~/orbbec_ros2_ws/src
git clone https://github.com/orbbec/OrbbecSDK_ROS2.git
cd ~/orbbec_ros2_ws
rosdep install --from-paths src --ignore-src -r -y
colcon build --symlink-install
source install/setup.bash构建完成后，可先列出可用启动文件，再选择与设备型号匹配的配置：
find ~/orbbec_ros2_ws/src -path "*launch*" -name "*.launch.py" | sort
ros2 node list
ros2 topic list深度图与点云检查
- 确认深度图主体轮廓连续，并且距离变化符合实际场景。
- 透明、反光、纯黑材质或超出有效工作范围的目标可能产生无效深度。
- 点云不显示时，检查点云话题、消息类型、frame_id、Fixed Frame 与 TF。
- 多数据流同时启用时，应确认组合受当前型号支持，并关注 USB 或网络带宽。
常见问题
系统没有识别到设备
检查接口、数据线、供电、系统权限和设备占用情况。重新连接后，先使用 SDK 的设备枚举示例确认。
能够识别设备，但无法启动数据流
通常需要检查所选 Profile 是否受支持。先查询设备返回的配置列表，再使用其中一个有效组合。
数据流不稳定或设备断开
排查接口带宽、供电、扩展坞和数据线。多相机系统还应检查设备是否集中连接在同一个 USB 控制器或网络链路上。
ROS 2 有话题但 RViz2 没有画面
确认话题类型、QoS、Fixed Frame 和 TF 设置。点云显示还需要选择实际发布的 PointCloud2 话题。
相关教程
资料来源与准确性
产品定位与概述来自经授权使用的奥比中光官方产品页面；开发流程参考 Orbbec SDK v2 与 OrbbecSDK ROS 2 Wrapper 官方仓库。本文未填写无法从官方资料可靠确认的具体规格值。