Files
OrbbecSDK_ROS2/zh/.doctrees/source/camera_devices/3_quickstarts/quickstart.doctree
T

32 lines
13 KiB
Plaintext
Raw Normal View History

2026-01-04 01:12:38 +00:00
€•Í2Œdocutils.nodes”Œdocument”“”)�”}”(Œ rawsource”Œ”Œchildren”]”hŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒROS 包快速入门”h]”hŒText”“”ŒROS 包快速入门”…”�”}”(Œparent”hŒ _document”hŒsource”Œi/home/runner/work/OrbbecSDK_ROS2/OrbbecSDK_ROS2/docs/zh/source/camera_devices/3_quickstarts/quickstart.md”Œline”KubaŒ
2025-10-22 03:11:03 +00:00
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”Œbackrefs”]”uŒtagname”hhKhh hhubh
)�”}”(hhh]”(h)�”}”(hŒ简介”h]”hŒ简介”…”�”}”(hh/hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKhh,hhubhŒ paragraph”“”)�”}”(hŒQ本节æ��ä¾› Orbbec ROS 2 包装器的快速入门指å�—。
您将学习如何:”h]”(hŒ;本节æ��ä¾› Orbbec ROS 2 包装器的快速入门指å�—。”…”�”}”(hh?hhhhhKubhŒ
”…”�”}”(hh?hhhhhKubhŒ您将学习如何:”…”�”}”(hh?hhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hKhh,hhhhubhŒ bullet_list”“”)�”}”(hhh]”(hŒ list_item”“”)�”}”(hhh]”h>)�”}”(hŒå�¯åŠ¨ç›¸æœºèŠ‚ç‚¹ã€‚”h]”hŒå�¯åŠ¨ç›¸æœºèŠ‚ç‚¹ã€‚”…”�”}”(hh_hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKhh\hhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhKhhWhhhhubh[)�”}”(hhh]”h>)�”}”(hŒ)在 RViz2 中å�¯è§†åŒ–深度/彩色æµ�。”h]”(hŒ在 ”…”�”}”(hhvhhhhhKubhŒstrong”“”)�”}”(hŒRViz2”h]”hŒRViz2”…”�”}”(hh€hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hhvhhhhhKubhŒ 中å�¯è§†åŒ–深度/彩色æµ�。”…”�”}”(hhvhhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK hhshhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK hhWhhhhubh[)�”}”(hhh]”h>)�”}”(hŒ2使用 ROS 2 CLI 工具与è¯�题和æœ�务交互。”h]”(hŒ使用 ”…”�”}”(hh¡hhhhhKubh)�”}”(hŒROS 2 CLI 工具”h]”hŒROS 2 CLI 工具”…”�”}”(hh©hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hh¡hhhhhKubhŒ与è¯�题和æœ�务交互。”…”�”}”(hh¡hhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK
hhžhhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK
hhWhhhhubeh}”(h!]”h#]”h%]”h']”h)]”uh+hUhKhh,hhhhubeh}”(h!]”Œid1”ah#]”h%]”Œ简介”ah']”h)]”uh+h hKhh hhhhubhŒ
transition”“”)�”}”(hhh]”h}”(h!]”h#]”h%]”h']”h)]”uh+hÕhh hhhhhKubh
)�”}”(hhh]”(h)�”}”(hŒ!构建您的第一个相机应用”h]”hŒ!构建您的第一个相机应用”…”�”}”(hhãhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKhhàhhubh
2025-12-01 02:24:40 +00:00
)�”}”(hhh]”(h)�”}”(hŒ-步骤 1:é…�ç½® ROS 2 和工作空间环境”h]”hŒ-步骤 1:é…�ç½® ROS 2 和工作空间环境”…”�”}”(hhôhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKhhñhhubh>)�”}”(hŒ.ç¡®ä¿�å·²é…�ç½® ROS 2 和工作空间环境:”h]”hŒ.ç¡®ä¿�å·²é…�ç½® ROS 2 和工作空间环境:”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKhhñhhhhubhŒ
literal_block”“”)�”}”(hŒ&source /opt/ros/$ROS_DISTRO/setup.bash”h]”hŒ&source /opt/ros/$ROS_DISTRO/setup.bash”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”Œ xml:space”Œpreserve”uh+jhhñhhhhhKubh>)�”}”(hŒæº�ç �构建需è¦�”h]”hŒæº�ç �构建需è¦�”…”�”}”(hj$hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKhhñhhhhubj)�”}”(hŒ#source ~/ros2_ws/install/setup.bash”h]”hŒ#source ~/ros2_ws/install/setup.bash”…”�”}”hj2sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhhñhhhhhKubeh}”(h!]”Œros-2”ah#]”h%]”Œ-步骤 1:é…�ç½® ros 2 和工作空间环境”ah']”h)]”uh+h hKhhàhhhhubh
2025-10-22 03:11:03 +00:00
)�”}”(hhh]”(h)�”}”(hŒ步骤 2:å�¯åŠ¨ç›¸æœºèŠ‚ç‚¹”h]”hŒ步骤 2:å�¯åŠ¨ç›¸æœºèŠ‚ç‚¹”…”�”}”(hjMhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKhjJhhubhV)�”}”(hhh]”h[)�”}”(hhh]”h>)�”}”(hŒ在终端 1 中”h]”hŒ在终端 1 中”…”�”}”(hjahhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hK hj^hhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK hj[hhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hUhK hjJhhhhubj)�”}”(hŒ¶. ./install/setup.bash
ros2 run orbbec_camera list_devices_node #检查相机是�已连接
ros2 launch orbbec_camera gemini_330_series.launch.py # 或其他å�¯åŠ¨æ–‡ä»¶ï¼Œè§�下表”h]”hŒ¶. ./install/setup.bash
2025-12-01 02:24:40 +00:00
ros2 run orbbec_camera list_devices_node #检查相机是�已连接
ros2 launch orbbec_camera gemini_330_series.launch.py # 或其他å�¯åŠ¨æ–‡ä»¶ï¼Œè§�下表”…”�”}”hj{sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhjJhhhhhKubh>)�”}”(hŒ9如果您连接了多个相机,å�¯ä»¥æŒ‡å®šåº�列å�·ï¼š”h]”(hŒ-如果您连接了多个相机,å�¯ä»¥æŒ‡å®š”…”�”}”(hj‹hhhhhKubh)�”}”(hŒ åº�列å�·”h]”hŒ åº�列å�·”…”�”}”(hj“hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hj‹hhhhhKubhŒ:”…”�”}”(hj‹hhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK(hjJhhhhubj)�”}”(hŒ\ros2 launch orbbec_camera gemini_330_series.launch.py serial_number:=<您的相机åº�列å�·>”h]”hŒ\ros2 launch orbbec_camera gemini_330_series.launch.py serial_number:=<您的相机åº�列å�·>”…”�”}”hj«sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhjJhhhhhKubeh}”(h!]”Œid3”ah#]”h%]”Œ步骤 2:å�¯åŠ¨ç›¸æœºèŠ‚ç‚¹”ah']”h)]”uh+h hKhhàhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ!步骤 3:在 RViz2 中å�¯è§†åŒ–”h]”hŒ!步骤 3:在 RViz2 中å�¯è§†åŒ–”…”�”}”(hjÆhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhK.hjÃhhubh>)�”}”(hŒ%å�¯åЍ RViz2 并加载默认é…�置:”h]”hŒ%å�¯åЍ RViz2 并加载默认é…�置:”…”�”}”(hjÔhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hK0hjÃhhhhubhV)�”}”(hhh]”h[)�”}”(hhh]”h>)�”}”(hŒ在终端 2 中”h]”hŒ在终端 2 中”…”�”}”(hjèhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hK2hjåhhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK2hjâhhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hUhK2hjÃhhhhubj)�”}”(hŒrviz2”h]”hŒrviz2”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhjÃhhhhhKubhV)�”}”(hhh]”(h[)�”}”(hhh]”h>)�”}”(hŒI添加一个 Image 显示,将è¯�题设置为 /camera/color/image_raw。”h]”(hŒ
添加一个 ”…”�”}”(hjhhhhhKubh)�”}”(hŒImage”h]”hŒImage”…”�”}”(hj hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hjhhhhhKubhŒ 显示,将è¯�题设置为 ”…”�”}”(hjhhhhhKubhŒliteral”“”)�”}”(hŒ/camera/color/image_raw”h]”hŒ/camera/color/image_raw”…”�”}”hj4sbah}”(h!]”h#]”h%]”h']”h)]”uh+j2hjhhhhhKubhŒ。”…”�”}”(hjhhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK8hjhhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK8hjhhhhubh[)�”}”(hhh]”h>)�”}”(hŒ;为 /camera/depth/image_raw 添加å�¦ä¸€ä¸ª Image 显示。”h]”(hŒ为 ”…”�”}”(hjUhhhhhKubj3)�”}”(hŒ/camera/depth/image_raw”h]”hŒ/camera/depth/image_raw”…”�”}”hj]sbah}”(h!]”h#]”h%]”h']”h)]”uh+j2hjUhhhhhKubhŒ 添加å�¦ä¸€ä¸ª ”…”�”}”(hjUhhhhhKubh)�”}”(hŒImage”h]”hŒImage”…”�”}”(hjohhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hjUhhhhhKubhŒ
显示。”…”�”}”(hjUhhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK9hjRhhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK9hjhhhhubh[)�”}”(hhh]”h>)�”}”(hŒ>å�¯é€‰ï¼šä¸º /camera/depth/points 添加 PointCloud2 显示。”h]”(hŒ
å�¯é€‰ï¼šä¸º ”…”�”}”(hj�hhhhhKubj3)�”}”(hŒ/camera/depth/points”h]”hŒ/camera/depth/points”…”�”}”hj˜sbah}”(h!]”h#]”h%]”h']”h)]”uh+j2hj�hhhhhKubhŒ 添加 ”…”�”}”(hj�hhhhhKubh)�”}”(hŒ PointCloud2”h]”hŒ PointCloud2”…”�”}”(hjªhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h~hj�hhhhhKubhŒ
2025-10-22 03:11:03 +00:00
显示。”…”�”}”(hj�hhhhhKubeh}”(h!]”h#]”h%]”h']”h)]”uh+h=hK:hj�hhhhubah}”(h!]”h#]”h%]”h']”h)]”uh+hZhK:hjhhhhubeh}”(h!]”h#]”h%]”h']”h)]”uh+hUhK8hjÃhhhhubh>)�”}”(hŒJ现在您应该能在 RViz2 中看到彩色æµ�ã€�深度æµ�å’Œ 3D 点云。”h]”hŒJ现在您应该能在 RViz2 中看到彩色æµ�ã€�深度æµ�å’Œ 3D 点云。”…”�”}”(hjÎhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hK<hjÃhhhhubeh}”(h!]”Œrviz2”ah#]”h%]”Œ!步骤 3:在 rviz2 中å�¯è§†åŒ–”ah']”h)]”uh+h hK.hhàhhhhubeh}”(h!]”Œid2”ah#]”h%]”Œ!构建您的第一个相机应用”ah']”h)]”uh+h hKhh hhhhubhÖ)�”}”(hhh]”h}”(h!]”h#]”h%]”h']”h)]”uh+hÕhh hhhhhKubh
)�”}”(hhh]”(h)�”}”(hŒ 示例功能”h]”hŒ 示例功能”…”�”}”(hjøhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhK@hjõhhubh>)�”}”(hŒ2节点è¿�行å�Žï¼Œå°�试一些 ROS 2 CLI 命令:”h]”hŒ2节点è¿�行å�Žï¼Œå°�试一些 ROS 2 CLI 命令:”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKBhjõhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ#列出å�¯ç”¨çš„è¯�题/æœ�务/å�‚æ•°”h]”hŒ#列出å�¯ç”¨çš„è¯�题/æœ�务/å�‚æ•°”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKDhjhhubj)�”}”(hŒ1ros2 topic list
2025-12-01 02:24:40 +00:00
ros2 service list
ros2 param list”h]”hŒ1ros2 topic list
ros2 service list
ros2 param list”…”�”}”hj%sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhjhhhhhKubeh}”(h!]”Œid5”ah#]”h%]”Œ#列出å�¯ç”¨çš„è¯�题/æœ�务/å�‚æ•°”ah']”h)]”uh+h hKDhjõhhhhubh
2025-10-22 03:11:03 +00:00
)�”}”(hhh]”(h)�”}”(hŒ 回显è¯�题”h]”hŒ 回显è¯�题”…”�”}”(hj@hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKLhj=hhubh>)�”}”(hŒ查看深度相机数æ�®ï¼š”h]”hŒ查看深度相机数æ�®ï¼š”…”�”}”(hjNhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKNhj=hhhhubj)�”}”(hŒ)ros2 topic echo /camera/depth/camera_info”h]”hŒ)ros2 topic echo /camera/depth/camera_info”…”�”}”hj\sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhj=hhhhhKubeh}”(h!]”Œid6”ah#]”h%]”Œ 回显è¯�题”ah']”h)]”uh+h hKLhjõhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ 调用æœ�务”h]”hŒ 调用æœ�务”…”�”}”(hjwhhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhKThjthhubh>)�”}”(hŒ例如,获å�–设备信æ�¯ï¼š”h]”hŒ例如,获å�–设备信æ�¯ï¼š”…”�”}”(hj…hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+h=hKVhjthhhhubj)�”}”(hŒSros2 service call /camera/get_device_info orbbec_camera_msgs/srv/GetDeviceInfo '{}'”h]”hŒSros2 service call /camera/get_device_info orbbec_camera_msgs/srv/GetDeviceInfo '{}'”…”�”}”hj“sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhjthhhhhKubeh}”(h!]”Œid7”ah#]”h%]”Œ 调用æœ�务”ah']”h)]”uh+h hKThjõhhhhubh
2025-12-01 02:24:40 +00:00
)�”}”(hhh]”(h)�”}”(hŒ使用 rosbag2 录制”h]”hŒ使用 rosbag2 录制”…”�”}”(hj®hhhhhKubah}”(h!]”h#]”h%]”h']”h)]”uh+hhK\hj«hhubj)�”}”(hŒ?ros2 bag record /camera/color/image_raw /camera/depth/image_raw”h]”hŒ?ros2 bag record /camera/color/image_raw /camera/depth/image_raw”…”�”}”hj¼sbah}”(h!]”h#]”h%]”h']”h)]”Œlanguage”Œbash”j"j#uh+jhj«hhhhhKubeh}”(h!]”Œrosbag2”ah#]”h%]”Œ使用 rosbag2 录制”ah']”h)]”uh+h hK\hjõhhhhubeh}”(h!]”Œid4”ah#]”h%]”Œ 示例功能”ah']”h)]”uh+h hK@hh hhhhubeh}”(h!]”Œros”ah#]”h%]”Œros 包快速入门”ah']”h)]”uh+h hKhhhhhhubah}”(h!]”h#]”h%]”h']”h)]”Œsource”hŒtranslation_progress”}”(Œtotal”KŒ
translated”Kuuh+hŒcurrent_source”NŒ current_line”NŒsettings”Œdocutils.frontend”ŒValues”“”)�”}”(Œoutput”NhNŒ generator”NŒ datestamp”NŒ root_prefix”Œ/”Œ source_link”NŒ
2025-10-22 03:11:03 +00:00
source_url”NŒ