docs: update example READMEs for clarity and consistency, add usage guides in multiple languages

This commit is contained in:
ob-yalian
2026-09-28 17:46:08 +08:00
parent 31a0181f6a
commit db5404d1fe
5 changed files with 47 additions and 168 deletions
@@ -1,28 +1,17 @@
# Attach Cameras to a Shared Component Container
# Shared Component Container
This example shows how to load two Gemini 330 Series camera components into one externally
created ROS 2 component container.
This example loads two Gemini 330 Series camera components into one ROS 2 component container.
Before starting the example, update the `usb_port` values in
`multi_camera_shared_container.launch.py` to match your two cameras. The default values are
`2-1` and `2-2`.
## Before running
Update both `usb_port` values in `multi_camera_shared_container.launch.py` to match your cameras. The defaults are `2-1` and `2-2`. Give each camera a unique `camera_name`.
## Run
```bash
ros2 launch orbbec_camera multi_camera_shared_container.launch.py
```
The example performs three steps:
## Full guide
1. Starts one multithreaded component container named `shared_orbbec_container`.
2. Includes the example-specific `gemini_330_series_shared_container.launch.py` once for each
camera.
3. Passes `attach_to_shared_component_container=true` and the same
`component_container_name` to both includes, so neither include creates its own container.
`use_intra_process_comms=true` enables intra-process communication for the loaded camera
components. Keep every `camera_name` unique, and make sure the shared container is running
before a camera component is loaded.
The package's main `launch/gemini_330_series.launch.py` is not modified by this example. The
example-specific launcher mirrors its Gemini 330 Series parameters and adds only the component
container selection controls needed for this demonstration.
[Efficient intra-process communication (English)](https://orbbec.github.io/OrbbecSDK_ROS2/en/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html) · [中文指南](https://orbbec.github.io/OrbbecSDK_ROS2/zh/source/camera_devices/5_advanced_guide/performance/efficient_intra_process_communication.html)