librealsense Ubuntu 22.04 Python 深度相机上手30分钟拿到第一帧深度图【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsenselibrealsense 是 RealSense 深度相机 SDKUbuntu 22.04 下 Python 连接相机最常见的两个卡点——lsusb看不到设备、import pyrealsense2报错——本文给出从内核补丁到最小验证代码的完整解法。读完后你能独立跑通深度流采集并知道深度对齐、点云渲染该看哪些官方示例。设备识别失败先看这个报错dmesg里反复出现uvcvideo: module verification failed拔掉再插相机依然没有新设备节点这一步解决相机插上却被系统无视的问题。RealSense 深度数据依赖打过补丁的uvcvideo内核模块Ubuntu 自带内核驱动采集不到有效数据所以 SDK 提供了补丁脚本。先装齐依赖依赖包作用安装命令libusb-1.0-0-devUSB 通信SDK 后端基础sudo apt-get install libusb-1.0-0-devlibudev-dev事件驱动的设备热插拔检测sudo apt-get install libudev-devlibssl-dev、pkg-config、libgtk-3-dev编译期链接与 GUI 支持sudo apt-get install libssl-dev pkg-config libgtk-3-devgit、wget、cmake、build-essential构建工具链sudo apt-get install git wget cmake build-essentiallibglfw3-dev、libgl1-mesa-dev、libglu1-mesa-dev、atOpenGL 图形示例与后端sudo apt-get install libglfw3-dev libgl1-mesa-dev libglu1-mesa-dev at执行下面命令前请先拔掉所有 RealSense 相机。git clone https://gitcode.com/GitHub_Trending/li/librealsense cd librealsense ./scripts/setup_udev_rules.sh ./scripts/patch-realsense-ubuntu-lts-hwe.sh # 22.04 LTS HWE 内核适用 sudo dmesg | tail -n 50dmesg中出现新的uvcvideo驱动注册记录就算成功。随后打开realsense-viewercmake ../ -DBUILD_EXAMPLEStrue后安装即可运行看到左侧列出相机即代表系统层就绪编译 pyrealsense2 的必要参数这一步解决import pyrealsense2找不到模块的问题。关键是-DBUILD_PYTHON_BINDINGS:booltrue和-DPYTHON_EXECUTABLE两个参数缺一不可。参数作用-DBUILD_PYTHON_BINDINGS:booltrue启用 Python 绑定编译默认关闭-DPYTHON_EXECUTABLE$(which python3)指定绑定目标解释器避免版本错位-DCMAKE_BUILD_TYPERelease开启优化调试阶段可省略sudo apt-get install python3-dev cd build cmake ../ -DBUILD_PYTHON_BINDINGS:booltrue -DPYTHON_EXECUTABLE$(which python3) make -j$(nproc) sudo make install export PYTHONPATH$PYTHONPATH:/usr/local/lib三行代码确认环境可用import pyrealsense2 as rs print(rs.__version__) print(rs.context().query_devices()) # 应列出你的相机最小验证10 行代码拿到中心点距离这一步解决环境到底能不能出数据的问题。下面是最短的深度流采集脚本深度值单位是毫米除以 1000 才是米import pyrealsense2 as rs pipeline rs.pipeline() config rs.config() config.enable_stream(rs.stream.depth, 640, 480, rs.format.z16, 30) pipeline.start(config) try: while True: depth pipeline.wait_for_frames().get_depth_frame() if depth: print(f中心距离: {depth.get_distance(320, 240) / 1000:.2f} m) finally: pipeline.stop()enable_stream的参数依次是流类型、宽、高、格式、帧率。帧率不够时优先降分辨率或只开必需的流。进阶对齐、点云与回放跑通基础深度后两个高频需求有现成官方脚本位于 wrappers/python/examples/align-depth2color.py演示把深度帧对齐到彩色流坐标系read_bag_example.py演示录制与回放先录后放适合离线调试。回放内部的线程分发机制可以配合 doc/img/playback/playback-flow.png 这张时序图理解避坑对照表现象原因处理提示Multiple realsense udev-rules were found!apt 安装包与源码编译两种安装并存二选一卸载多余的一份uvcvideo: module verification failed: signature ... tainting kernel4.4-30 内核对未签名模块的标准警告忽略不影响功能Modprobe uvcvideo ... not loaded补丁模块版本与当前内核不匹配uname -r核对内核重新走依赖与补丁流程ModuleNotFoundError: pyrealsense2PYTHONPATH未包含安装目录确认/usr/local/lib或把librealsense2.so、pyrealsense2.so拷到脚本同目录绑定编译进错误 Python 版本系统存在多个解释器-DPYTHON_EXECUTABLE指定完整路径虚拟机里识别不到相机USB 3.0 透传层不支持官方不保证 VM 环境使用物理机或 VMware 正确模拟 USB3延伸阅读wrappers/python/examples/read_bag_example.py录制与回放 bag 文件wrappers/python/examples/align-depth2color.py深度对齐彩色流doc/record-and-playback.md录制回放机制说明doc/troubleshooting.md更多排查案例深度、彩色、点云都在同一个 pipeline 对象里后面想加什么流、做什么处理照着 examples 目录找同名脚本改参数就行。【免费下载链接】librealsenseRealSense SDK项目地址: https://gitcode.com/GitHub_Trending/li/librealsense创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
