OrbbecSDK_ROS2/zh/.doctrees/source/camera_devices/8_FAQ/FAQ.doctree

€•¥kŒdocutils.nodes”Œdocument”“”)�”}”(Œ	rawsource”Œ”Œchildren”]”hŒsection”“”)�”}”(hhh]”(hŒtitle”“”)�”}”(hŒ常è§�问题”h]”hŒText”“”Œ常è§�问题”…”�”}”(Œparent”hŒ	_document”hŒsource”ŒZ/home/runner/work/OrbbecSDK_ROS2/OrbbecSDK_ROS2/docs/zh/source/camera_devices/8_FAQ/FAQ.md”Œline”KubaŒ
attributes”}”(Œids”]”Œclasses”]”Œnames”]”Œdupnames”]”uŒtagname”hhK
hhhhubh
)�”}”(hhh]”(h)�”}”(hŒæ„�外崩溃”h]”hŒæ„�外崩溃”…”�”}”(hh-hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhh*hhubhŒ	paragraph”“”)�”}”(hŒÑ如果相机节点æ„�外崩溃，它将在当å‰�è¿�行目录中生æˆ�崩溃日志：Log/camera_crash_stack_trace_xx.log。请将此日志å�‘é€�给支æŒ�团队或æ��交到GitHub issue以获得进一步帮助。”h]”(hŒT如果相机节点æ„�外崩溃，它将在当å‰�è¿�行目录中生æˆ�崩溃日志：”…”�”}”(hh<hhhhhKubhŒliteral”“”)�”}”(hŒ#Log/camera_crash_stack_trace_xx.log”h]”hŒ#Log/camera_crash_stack_trace_xx.log”…”�”}”hhFsbah}”(h!]”h#]”h%]”h']”uh)hDhh<hhhhhKubhŒZ。请将此日志å�‘é€�给支æŒ�团队或æ��交到GitHub issue以获得进一步帮助。”…”�”}”(hh<hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhh*hhhhubeh}”(h!]”Œid2”ah#]”h%]”Œæ„�外崩溃”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ多相机无数æ�®æµ�”h]”hŒ多相机无数æ�®æµ�”…”�”}”(hhfhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhhchhubh;)�”}”(hŒ电æº�供应ä¸�足：”h]”(hŒstrong”“”)�”}”(hŒ电æº�供应ä¸�足”h]”hŒ电æº�供应ä¸�足”…”�”}”(hhyhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhhshhhhhKubhŒ：”…”�”}”(hhshhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK	hhchhhhubhŒbullet_list”“”)�”}”(hhh]”(hŒ	list_item”“”)�”}”(hhh]”h;)�”}”(hŒ0ç¡®ä¿�æ¯�个相机连接到å�•ç‹¬çš„集线器。”h]”hŒ0ç¡®ä¿�æ¯�个相机连接到å�•ç‹¬çš„集线器。”…”�”}”(hh™hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhh–hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhh‘hhhhubh•)�”}”(hhh]”h;)�”}”(hŒ<使用有æº�集线器为æ¯�个相机æ��供足够的电力。”h]”hŒ<使用有æº�集线器为æ¯�个相机æ��供足够的电力。”…”�”}”(hh®hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhh«hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhh‘hhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubh;)�”}”(hŒ高分辨率：”h]”(hx)�”}”(hŒ高分辨率”h]”hŒ高分辨率”…”�”}”(hhÉhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhhÅhhhhhKubhŒ：”…”�”}”(hhÅhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhhchhhhubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ0å°�试é™�低分辨率以解决数æ�®æµ�问题。”h]”hŒ0å°�试é™�低分辨率以解决数æ�®æµ�问题。”…”�”}”(hhåhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKhhâhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhhßhhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubh;)�”}”(hŒ增加usbfs_memory_mb值：”h]”(hx)�”}”(hŒ增加usbfs_memory_mb值”h]”(hŒ增加usbfs”…”�”}”(hj
hhhhhKubhŒ
_”…”�”}”(hj
hhhhhKubhŒmemory”…”�”}”(hj
hhhhhKubhŒ
_”…”�”}”(hj
hhhhhKubhŒmb值”…”�”}”(hj
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)hwhhühhhhhKubhŒ：”…”�”}”(hhühhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhhchhhhubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒs通过è¿�行以下命令将 usbfs_memory_mb 值增加到128MB（这是å�‚考值，å�¯æ ¹æ�®ç³»ç»Ÿéœ€æ±‚调整）：”h]”(hŒ通过è¿�行以下命令将 ”…”�”}”(hj,
hhhhhKubhE)�”}”(hŒusbfs_memory_mb”h]”hŒusbfs_memory_mb”…”�”}”hj4
sbah}”(h!]”h#]”h%]”h']”uh)hDhj,
hhhhhKubhŒH 值增加到128MB（这是å�‚考值，å�¯æ ¹æ�®ç³»ç»Ÿéœ€æ±‚调整）：”…”�”}”(hj,
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhj)
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhj&
hhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubhŒ
literal_block”“”)�”}”(hŒF    echo 128 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb”h]”hŒF    echo 128 | sudo tee /sys/module/usbcore/parameters/usbfs_memory_mb”…”�”}”hjV
sbah}”(h!]”h#]”h%]”h']”Œ	xml:space”Œpreserve”uh)jT
hhchhhhhKubh�)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ3è¦�使此更改永久生效，请查看此链接。”h]”(hŒ'è¦�使此更改永久生效，请查看”…”�”}”(hjk
hhhhhKubhŒ	reference”“”)�”}”(hŒ	此链接”h]”hŒ	此链接”…”�”}”(hju
hhhhhKubah}”(h!]”h#]”h%]”h']”Œrefuri”Œ5https://github.com/OpenKinect/libfreenect2/issues/807”uh)js
hKhjk
hhhhubhŒ。”…”�”}”(hjk
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhjh
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhje
hhhhubah}”(h!]”h#]”h%]”h']”uh)h�hKhhchhhhubeh}”(h!]”Œid3”ah#]”h%]”Œ多相机无数æ�®æµ�”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ如何采集和ä¿�存日志”h]”hŒ如何采集和ä¿�存日志”…”�”}”(hj¡
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKhjž
hhubhŒenumerated_list”“”)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒûSDK debug 日志
å°† launch å�‚æ•° log_level 设为 debug è¿�è¡Œå�Žï¼Œä¼šåœ¨å½“å‰�工程目录下的 Log/ 文件夹中生æˆ� SDK 日志文件。如果需è¦�为本次测试指定一个更易识别的日志文件å��，å�¯ä»¥ä¿®æ”¹å�‚æ•° log_file_name。”h]”(hx)�”}”(hŒSDK debug 日志”h]”hŒSDK debug 日志”…”�”}”(hjº
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj¶
hhhhhKubhŒ

”…”�”}”(hj¶
hhhhhKubhŒå°† launch å�‚æ•° ”…”�”}”(hj¶
hhhhhKubhE)�”}”(hŒ	log_level”h]”hŒ	log_level”…”�”}”hjÏ
sbah}”(h!]”h#]”h%]”h']”uh)hDhj¶
hhhhhKubhŒ 设为 ”…”�”}”(hj¶
hhhhhKubhE)�”}”(hŒdebug”h]”hŒdebug”…”�”}”hjà
sbah}”(h!]”h#]”h%]”h']”uh)hDhj¶
hhhhhKubhŒ, è¿�è¡Œå�Žï¼Œä¼šåœ¨å½“å‰�工程目录下的 ”…”�”}”(hj¶
hhhhhKubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”hjñ
sbah}”(h!]”h#]”h%]”h']”uh)hDhj¶
hhhhhKubhŒ‚ 文件夹中生æˆ� SDK 日志文件。如果需è¦�为本次测试指定一个更易识别的日志文件å��，å�¯ä»¥ä¿®æ”¹å�‚æ•° ”…”�”}”(hj¶
hhhhhKubhE)�”}”(hŒ
log_file_name”h]”hŒ
log_file_name”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”uh)hDhj¶
hhhhhKubhŒ。”…”�”}”(hj¶
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKhj³
hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKhj°
hhhhubah}”(h!]”h#]”h%]”h']”uh)j®
hKhjž
hhhhubhŒblock_quote”“”)�”}”(hhh]”h;)�”}”(hX
SDK 日志是追加写入的：多次�动会在�一个文件里�断累积日志。
建议：在准备打包日志å�‘给技术支æŒ�å‰�，先删除旧的日志文件，然å�Žé‡�æ–°å¤�现问题并采集新的日志，这样日志更干净ã€�定ä½�更准确。”h]”(hŒXSDK 日志是追加写入的：多次å�¯åŠ¨ä¼šåœ¨å�Œä¸€ä¸ªæ–‡ä»¶é‡Œä¸�断累积日志。”…”�”}”(hj'hhhhhKubhŒ

”…”�”}”(hj'hhhhhKubhŒ®å»ºè®®ï¼šåœ¨å‡†å¤‡æ‰“包日志å�‘给技术支æŒ�å‰�，先删除旧的日志文件，然å�Žé‡�æ–°å¤�现问题并采集新的日志，这样日志更干净ã€�定ä½�更准确。”…”�”}”(hj'hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK!hj$hhhhubah}”(h!]”h#]”h%]”h']”uh)j"hK!hjž
hhhhubj¯
)�”}”(hhh]”h•)�”}”(hhh]”h;)�”}”(hŒ¡ROS2 日志（~/.ros/log）
在 launch 文件中，将节点（或å�¯ç»„å�ˆèŠ‚点容器）的 output å�‚数设为 "log"，å�³å�¯å°† ROS2 日志ä¿�存到本地：”h]”(hx)�”}”(hŒROS2 日志（~/.ros/log）”h]”hŒROS2 日志（~/.ros/log）”…”�”}”(hjKhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjGhhhhhKubhŒ

”…”�”}”(hjGhhhhhKubhŒB在 launch 文件中，将节点（或å�¯ç»„å�ˆèŠ‚点容器）的 ”…”�”}”(hjGhhhhhKubhE)�”}”(hŒoutput”h]”hŒoutput”…”�”}”hj`sbah}”(h!]”h#]”h%]”h']”uh)hDhjGhhhhhKubhŒ å�‚数设为 ”…”�”}”(hjGhhhhhKubhE)�”}”(hŒ"log"”h]”hŒ"log"”…”�”}”hjqsbah}”(h!]”h#]”h%]”h']”uh)hDhjGhhhhhKubhŒ*，å�³å�¯å°† ROS2 日志ä¿�存到本地：”…”�”}”(hjGhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK$hjDhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK$hjAhhhhubah}”(h!]”h#]”h%]”h']”uh)j®
hK$hjž
hhhhubj#)�”}”(hhh]”h;)�”}”(hŒÏ设置为 output="log" å�Žï¼ŒROS2 日志将ä¿�存在 ~/.ros/log/ 目录下。
如需æ��交问题，请å�Œæ—¶æ‰“包 Log/ 目录下的 SDK 日志和 ~/.ros/log/ 下对应时间的 ROS2 日志，一并æ��供。”h]”(hŒ
设置为 ”…”�”}”(hj”hhhhhKubhE)�”}”(hŒoutput="log"”h]”hŒoutput="log"”…”�”}”hjœsbah}”(h!]”h#]”h%]”h']”uh)hDhj”hhhhhKubhŒ å�Žï¼ŒROS2 日志将ä¿�存在 ”…”�”}”(hj”hhhhhKubhE)�”}”(hŒ~/.ros/log/”h]”hŒ~/.ros/log/”…”�”}”hj­sbah}”(h!]”h#]”h%]”h']”uh)hDhj”hhhhhKubhŒ
 目录下。”…”�”}”(hj”hhhhhKubhŒ

”…”�”}”(hj”hhhhhKubhŒ%如需æ��交问题，请å�Œæ—¶æ‰“包 ”…”�”}”(hj”hhhhhKubhE)�”}”(hŒLog/”h]”hŒLog/”…”�”}”hjÆsbah}”(h!]”h#]”h%]”h']”uh)hDhj”hhhhhKubhŒ 目录下的 SDK 日志和 ”…”�”}”(hj”hhhhhKubhE)�”}”(hŒ~/.ros/log/”h]”hŒ~/.ros/log/”…”�”}”hj×sbah}”(h!]”h#]”h%]”h']”uh)hDhj”hhhhhKubhŒ1 下对应时间的 ROS2 日志，一并æ��供。”…”�”}”(hj”hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK'hj‘hhhhubah}”(h!]”h#]”h%]”h']”uh)j"hK'hjž
hhhhubeh}”(h!]”Œid4”ah#]”h%]”Œ如何采集和ä¿�存日志”ah']”uh)h	hKhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”h]”hŒ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”…”�”}”(hjühhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK*hjùhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ?ä¸�å�Œçš„相机具有ä¸�å�Œçš„默认分辨率和图åƒ�æ ¼å¼�。”h]”hŒ?ä¸�å�Œçš„相机具有ä¸�å�Œçš„默认分辨率和图åƒ�æ ¼å¼�。”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK,hjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK,hj	hhhhubh•)�”}”(hhh]”h;)�”}”(hŒ<为简化使用，æ¯�个相机都有自己的å�¯åŠ¨æ–‡ä»¶ã€‚”h]”hŒ<为简化使用，æ¯�个相机都有自己的å�¯åŠ¨æ–‡ä»¶ã€‚”…”�”}”(hj$hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK-hj!hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK-hj	hhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK,hjùhhhhubeh}”(h!]”Œid5”ah#]”h%]”Œ$为什么有这么多å�¯åŠ¨æ–‡ä»¶ï¼Ÿ”ah']”uh)h	hK*hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”h]”hŒ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”…”�”}”(hjEhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK/hjBhhubh;)�”}”(hŒ�如果å�¯åŠ¨æ–‡ä»¶æœªæ˜¾å¼�指定è¦�使用的设备，在å�Œæ—¶è¿žæŽ¥å¤šå�°ç›¸æœºæ—¶ï¼Œé©±åŠ¨ä¼šé»˜è®¤è¿žæŽ¥åˆ°å…¶ä¸­ä¸€ä¸ªï¼ˆé»˜è®¤è®¾å¤‡ï¼‰ã€‚”h]”hŒ�如果å�¯åŠ¨æ–‡ä»¶æœªæ˜¾å¼�指定è¦�使用的设备，在å�Œæ—¶è¿žæŽ¥å¤šå�°ç›¸æœºæ—¶ï¼Œé©±åŠ¨ä¼šé»˜è®¤è¿žæŽ¥åˆ°å…¶ä¸­ä¸€ä¸ªï¼ˆé»˜è®¤è®¾å¤‡ï¼‰ã€‚”…”�”}”(hjRhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK1hjBhhhhubh;)�”}”(hŒ3å�¯ä»¥å…ˆé€šè¿‡ä»¥ä¸‹å‘½ä»¤æŸ¥çœ‹è®¾å¤‡åº�列å�·ï¼š”h]”hŒ3å�¯ä»¥å…ˆé€šè¿‡ä»¥ä¸‹å‘½ä»¤æŸ¥çœ‹è®¾å¤‡åº�列å�·ï¼š”…”�”}”(hj_hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK3hjBhhhhubjU
)�”}”(hŒ(ros2 run orbbec_camera list_devices_node”h]”hŒ(ros2 run orbbec_camera list_devices_node”…”�”}”hjlsbah}”(h!]”h#]”h%]”h']”Œlanguage”Œbash”jc
jd
uh)jT
hjBhhhhhKubh;)�”}”(hŒ3然å�Žåœ¨å�¯åŠ¨æ—¶æ˜¾å¼�指定åº�列å�·ï¼Œä¾‹å¦‚：”h]”hŒ3然å�Žåœ¨å�¯åŠ¨æ—¶æ˜¾å¼�指定åº�列å�·ï¼Œä¾‹å¦‚：”…”�”}”(hj{hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK9hjBhhhhubjU
)�”}”(hŒIros2 launch orbbec_camera femto_bolt.launch.py serial_number:=CL8H741005J”h]”hŒIros2 launch orbbec_camera femto_bolt.launch.py serial_number:=CL8H741005J”…”�”}”hjˆsbah}”(h!]”h#]”h%]”h']”Œlanguage”Œbash”jc
jd
uh)jT
hjBhhhhhKubeh}”(h!]”Œid6”ah#]”h%]”Œ3多相机连接时如何指定å�¯åŠ¨æŸ�一个相机”ah']”uh)h	hK/hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”h]”hŒ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”…”�”}”(hj¡hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhK?hjžhhubh;)�”}”(hX
多相机系统对带宽和设备åˆ�始化时åº�è¦�求较高。如果在å�Œä¸€æ—¶é—´å�¯åŠ¨æˆ–切æ�¢å¤šä¸ªç›¸æœºæµ�，å�¯èƒ½ä¼šå¼•å�‘带宽瞬时拥塞，进而导致设备åˆ�始化失败ã€�æµ�å�¯åŠ¨å¼‚常或丢帧等问题。为确ä¿�系统稳定性，建议注æ„�以下几点：”h]”hX
多相机系统对带宽和设备åˆ�始化时åº�è¦�求较高。如果在å�Œä¸€æ—¶é—´å�¯åŠ¨æˆ–切æ�¢å¤šä¸ªç›¸æœºæµ�，å�¯èƒ½ä¼šå¼•å�‘带宽瞬时拥塞，进而导致设备åˆ�始化失败ã€�æµ�å�¯åŠ¨å¼‚常或丢帧等问题。为确ä¿�系统稳定性，建议注æ„�以下几点：”…”�”}”(hj®hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKAhjžhhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”(h;)�”}”(hŒ多相机å�¯åŠ¨é˜¶æ®µ”h]”hx)�”}”(hŒ多相机å�¯åŠ¨é˜¶æ®µ”h]”hŒ多相机å�¯åŠ¨é˜¶æ®µ”…”�”}”(hjÅhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjÁhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKChj¾hhhhubh;)�”}”(hŒŸåœ¨å�¯åŠ¨å¤šä¸ªç›¸æœºæ—¶ï¼Œå»ºè®®åœ¨æ¯�个相机å�¯åŠ¨ä¹‹é—´å¢žåŠ é€‚当的延迟（例如 2s），以é�¿å…�瞬时带宽过载或底层设备åˆ�始化冲çª�。”h]”(hŒ[在å�¯åŠ¨å¤šä¸ªç›¸æœºæ—¶ï¼Œå»ºè®®åœ¨æ¯�个相机å�¯åŠ¨ä¹‹é—´å¢žåŠ é€‚当的延迟（例如 ”…”�”}”(hj×hhhhhKubhx)�”}”(hŒ2s”h]”hŒ2s”…”�”}”(hjßhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj×hhhhhKubhŒB），以é�¿å…�瞬时带宽过载或底层设备åˆ�始化冲çª�。”…”�”}”(hj×hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKEhj¾hhhhubeh}”(h!]”h#]”h%]”h']”uh)h”hKChj»hhhhubh•)�”}”(hhh]”(h;)�”}”(hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”h]”hx)�”}”(hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”h]”hŒæµ�开关与模å¼�切æ�¢é˜¶æ®µ”…”�”}”(hj
hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjýhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKGhjúhhhhubh;)�”}”(hŒô在调用开关æµ�相关æœ�务（如 set_streams_enableã€�toggle_depthã€�toggle_color）时，ä¸�建议å�Œæ—¶è§¦å�‘多个接å�£è°ƒç”¨ï¼Œåº”在å�„æ“�作之间设置å�ˆç�†çš„时间间隔（例如 20 ms），以ä¿�è¯�æµ�状æ€�切æ�¢çš„å�¯é� æ€§ã€‚”h]”(hŒ%在调用开关æµ�相关æœ�务（如 ”…”�”}”(hjhhhhhKubhE)�”}”(hŒset_streams_enable”h]”hŒset_streams_enable”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubhŒã€�”…”�”}”(hjhhhhhKubhE)�”}”(hŒtoggle_depth”h]”hŒtoggle_depth”…”�”}”hj,sbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubhŒã€�”…”�”}”(hjhhhhhKubhE)�”}”(hŒtoggle_color”h]”hŒtoggle_color”…”�”}”hj=sbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubhŒm）时，ä¸�建议å�Œæ—¶è§¦å�‘多个接å�£è°ƒç”¨ï¼Œåº”在å�„æ“�作之间设置å�ˆç�†çš„时间间隔（例如 ”…”�”}”(hjhhhhhKubhx)�”}”(hŒ20 ms”h]”hŒ20 ms”…”�”}”(hjNhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjhhhhhKubhŒ-），以ä¿�è¯�æµ�状æ€�切æ�¢çš„å�¯é� æ€§ã€‚”…”�”}”(hjhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKIhjúhhhhubeh}”(h!]”h#]”h%]”h']”uh)h”hKGhj»hhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hKChjžhhhhubh;)�”}”(hŒ–é�µå¾ªä¸Šè¿°æ—¶åº�控制原则，有助于æ��å�‡å¤šç›¸æœºç³»ç»Ÿåœ¨å�¯åŠ¨å’Œè¿�行过程中的稳定性，å‡�少异常和ä¸�å�¯é¢„期行为的å�‘生。”h]”hŒ–é�µå¾ªä¸Šè¿°æ—¶åº�控制原则，有助于æ��å�‡å¤šç›¸æœºç³»ç»Ÿåœ¨å�¯åŠ¨å’Œè¿�行过程中的稳定性，å‡�少异常和ä¸�å�¯é¢„期行为的å�‘生。”…”�”}”(hjnhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKKhjžhhhhubeh}”(h!]”Œid7”ah#]”h%]”Œ<多相机å�¯åŠ¨æˆ–切æ�¢æµ�时为什么需è¦�设置延迟？”ah']”uh)h	hK?hhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒfemto bolt 深度æµ�æ— æ•°æ�®”h]”hŒfemto bolt 深度æµ�æ— æ•°æ�®”…”�”}”(hj…hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKLhj‚hhubh;)�”}”(hŒ¢è¯¥æ¨¡ç»„è¿�行时ä¾�èµ– OpenGL 库，若系统未安装或驱动ä¸�完整，将导致深度æµ�æ— æ•°æ�®ã€‚请先安装 OpenGL 相关库（以 Ubuntu 为例）：”h]”hŒ¢è¯¥æ¨¡ç»„è¿�行时ä¾�èµ– OpenGL 库，若系统未安装或驱动ä¸�完整，将导致深度æµ�æ— æ•°æ�®ã€‚请先安装 OpenGL 相关库（以 Ubuntu 为例）：”…”�”}”(hj’hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKNhj‚hhhhubjU
)�”}”(hŒP  sudo apt update && sudo apt install -y mesa-utils libgl1-mesa-glx libglu1-mesa”h]”hŒP  sudo apt update && sudo apt install -y mesa-utils libgl1-mesa-glx libglu1-mesa”…”�”}”hjŸsbah}”(h!]”h#]”h%]”h']”Œlanguage”Œbash”jc
jd
uh)jT
hj‚hhhhhKubh;)�”}”(hŒ;安装å�Žå�¯é€šè¿‡ä»¥ä¸‹å‘½ä»¤æ£€æŸ¥ OpenGL 是å�¦å�¯ç”¨ï¼š”h]”hŒ;安装å�Žå�¯é€šè¿‡ä»¥ä¸‹å‘½ä»¤æ£€æŸ¥ OpenGL 是å�¦å�¯ç”¨ï¼š”…”�”}”(hj®hhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKThj‚hhhhubjU
)�”}”(hŒ  glxinfo -B”h]”hŒ  glxinfo -B”…”�”}”hj»sbah}”(h!]”h#]”h%]”h']”Œlanguage”Œbash”jc
jd
uh)jT
hj‚hhhhhKubeh}”(h!]”Œ
femto-bolt”ah#]”h%]”Œfemto bolt 深度æµ�æ— æ•°æ�®”ah']”uh)h	hKLhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ图åƒ�未达到预设帧率”h]”hŒ图åƒ�未达到预设帧率”…”�”}”(hjÔhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKZhjÑhhubh;)�”}”(hŒv首先需è¦�确认图åƒ�是å�¦ç¡®å®žæœªè¾¾åˆ°é¢„设帧率。在 ROS 2 中å�¯é€šè¿‡å¤šç§�æ–¹å¼�查看帧率，例如：”h]”hŒv首先需è¦�确认图åƒ�是å�¦ç¡®å®žæœªè¾¾åˆ°é¢„设帧率。在 ROS 2 中å�¯é€šè¿‡å¤šç§�æ–¹å¼�查看帧率，例如：”…”�”}”(hjáhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK\hjÑhhhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ
ros2 topic hz”h]”hE)�”}”(hŒ
ros2 topic hz”h]”hŒ
ros2 topic hz”…”�”}”hjøsbah}”(h!]”h#]”h%]”h']”uh)hDhjôhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK^hjñhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK^hjîhhhhubh•)�”}”(hhh]”h;)�”}”(hŒrqt”h]”hE)�”}”(hŒrqt”h]”hŒrqt”…”�”}”hjsbah}”(h!]”h#]”h%]”h']”uh)hDhjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hK_hjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK_hjîhhhhubh•)�”}”(hhh]”h;)�”}”(hŒ=自定义工具（如本 ROS 包æ��供的 benchmark 工具）”h]”(hŒ*自定义工具（如本 ROS 包æ��供的 ”…”�”}”(hj0hhhhhKubhE)�”}”(hŒ	benchmark”h]”hŒ	benchmark”…”�”}”hj8sbah}”(h!]”h#]”h%]”h']”uh)hDhj0hhhhhKubhŒ
 工具）”…”�”}”(hj0hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hK`hj-hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hK`hjîhhhhubeh}”(h!]”h#]”h%]”h']”uh)h�hK^hjÑhhhhubh;)�”}”(hŒÚ需è¦�注æ„�的是，ä¸�å�Œå·¥å…·çš„统计方å¼�å’Œ QoS é…�ç½®ä¸�å�Œï¼Œå› æ­¤å¾—到的帧率结果å�¯èƒ½å­˜åœ¨å·®å¼‚。当å�‘现帧率低于预期时，请优先排查是å�¦ä¸ºå¸§çŽ‡ç»Ÿè®¡å·¥å…·æœ¬èº«å¯¼è‡´çš„误差。”h]”hŒÚ需è¦�注æ„�的是，ä¸�å�Œå·¥å…·çš„统计方å¼�å’Œ QoS é…�ç½®ä¸�å�Œï¼Œå› æ­¤å¾—到的帧率结果å�¯èƒ½å­˜åœ¨å·®å¼‚。当å�‘现帧率低于预期时，请优先排查是å�¦ä¸ºå¸§çŽ‡ç»Ÿè®¡å·¥å…·æœ¬èº«å¯¼è‡´çš„误差。”…”�”}”(hjXhhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKbhjÑhhhhubh;)�”}”(hŒN若确认图åƒ�帧率确实未达到预设值，å�¯å°�试以下排查步骤：”h]”hŒN若确认图åƒ�帧率确实未达到预设值，å�¯å°�试以下排查步骤：”…”�”}”(hjehhhhhKubah}”(h!]”h#]”h%]”h']”uh)h:hKdhjÑhhhhubj¯
)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ[é™�低分辨率或帧率，判断是å�¦ç”±äºŽ USB / 网络带宽å�—é™�导致帧率下é™�ï¼›”h]”(hx)�”}”(hŒé™�低分辨率或帧率”h]”hŒé™�低分辨率或帧率”…”�”}”(hj|hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjxhhhhhKubhŒC，判断是å�¦ç”±äºŽ USB / 网络带宽å�—é™�导致帧率下é™�ï¼›”…”�”}”(hjxhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKfhjuhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKfhjrhhhhubh•)�”}”(hhh]”h;)�”}”(hŒk确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°ï¼Œæ—§ç‰ˆæœ¬å�¯èƒ½å­˜åœ¨æ€§èƒ½æˆ–兼容性问题。”h]”(hx)�”}”(hŒ8确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°”h]”hŒ8确认相机固件版本å�Š ROS 包版本是å�¦ä¸ºæœ€æ–°”…”�”}”(hjžhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhjšhhhhhKubhŒ3，旧版本å�¯èƒ½å­˜åœ¨æ€§èƒ½æˆ–兼容性问题。”…”�”}”(hjšhhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKghj—hhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKghjrhhhhubeh}”(h!]”h#]”h%]”h']”uh)j®
hKfhjÑhhhhubh;)�”}”(hŒ{若以上方法ä»�无法解决问题，请è�”系我å�¸ FAE，或在 GitHub Issue 中æ��交问题以获得进一步支æŒ�。”h]”(hŒ7若以上方法ä»�无法解决问题，请è�”系我å�¸ ”…”�”}”(hj¾hhhhhKubhx)�”}”(hŒFAE”h]”hŒFAE”…”�”}”(hjÆhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj¾hhhhhKubhŒ
，或在 ”…”�”}”(hj¾hhhhhKubhx)�”}”(hŒGitHub Issue”h]”hŒGitHub Issue”…”�”}”(hj×hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj¾hhhhhKubhŒ+ 中æ��交问题以获得进一步支æŒ�。”…”�”}”(hj¾hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKihjÑhhhhubeh}”(h!]”Œid8”ah#]”h%]”Œ图åƒ�未达到预设帧率”ah']”uh)h	hKZhhhhhhubh
)�”}”(hhh]”(h)�”}”(hŒ软触å�‘模å¼�相关问题”h]”hŒ软触å�‘模å¼�相关问题”…”�”}”(hj÷hhhhhKubah}”(h!]”h#]”h%]”h']”uh)hhKlhjôhhubh�)�”}”(hhh]”(h•)�”}”(hhh]”h;)�”}”(hŒ¸ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�
请开å�¯å¸§æ±‡è�šåŠŸèƒ½ï¼Œå°†å�‚æ•°frame_aggregate_mode设置为full_frame，以ä¿�è¯�多传感器数æ�®åœ¨å�Œä¸€æ¬¡è§¦å�‘下å�Œæ­¥è¾“出。”h]”(hx)�”}”(hŒ*ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�”h]”hŒ*ä¿¡å�·è§¦å�‘æ—¶å�„传感器未å�Œæ—¶å‡ºæµ�”…”�”}”(hjhhhhhKubah}”(h!]”h#]”h%]”h']”uh)hwhj
hhhhhKubhŒ

”…”�”}”(hj
hhhhhKubhŒ$请开å�¯å¸§æ±‡è�šåŠŸèƒ½ï¼Œå°†å�‚æ•°”…”�”}”(hj
hhhhhKubhE)�”}”(hŒframe_aggregate_mode”h]”hŒframe_aggregate_mode”…”�”}”hj#sbah}”(h!]”h#]”h%]”h']”uh)hDhj
hhhhhKubhŒ	设置为”…”�”}”(hj
hhhhhKubhE)�”}”(hŒ
full_frame”h]”hŒ
full_frame”…”�”}”hj4sbah}”(h!]”h#]”h%]”h']”uh)hDhj
hhhhhKubhŒB，以ä¿�è¯�多传感器数æ�®åœ¨å�Œä¸€æ¬¡è§¦å�‘下å�Œæ­¥è¾“出。”…”�”}”(hj
hhhhhKubeh}”(h!]”h#]”h%]”h']”uh)h:hKnhjhhhhubah}”(h!]”h#]”h%]”h']”uh)h”hKnhjhhhhubh•)�”}”(hhh]”(h;)�”}”(hŒí自动触å�‘模å¼�下无法达到预设帧率