luxonis/depthai-library

DepthAI Python/C++库及工具Docker镜像

镜像概述和主要用途

本Docker镜像包含运行DepthAI示例程序所需的DepthAI Python/C++库、辅助工具及依赖项。其主要用途是提供一个预配置的一致环境，简化DepthAI相关应用的开发、测试和运行流程，避免开发者手动配置复杂的依赖关系。Dockerfile源码托管于https://github.com/luxonis/depthai-python/blob/main/ci/Dockerfile%E3%80%82

核心功能和特性

• 完整依赖集成：预安装DepthAI Python库、C++库及所有必要系统依赖，无需手动配置环境
• 工具支持：包含运行DepthAI示例程序所需的辅助工具，简化开发流程
• 环境一致性：确保不同设备上的运行环境一致，减少"在我机器上能运行"的问题
• 易于扩展：可基于此镜像进一步定制，添加项目特定依赖或配置

使用场景和适用范围

• 快速运行DepthAI官方示例程序
• DepthAI开发者学习和测试环境搭建
• 跨平台部署DepthAI应用原型
• 教学和演示场景中快速展示DepthAI功能

使用方法和配置说明

获取镜像

方法1：从源码构建（推荐）

bash
# 克隆仓库
git clone https://github.com/luxonis/depthai-python.git
cd depthai-python

# 构建镜像
docker build -f ci/Dockerfile -t depthai-dev:latest .

方法2：拉取预构建镜像（如官方提供）

bash
docker pull docker.xuanyuan.run/luxonis/depthai-python:latest  # 注：具体镜像名称以官方发布为准

运行容器

基本运行命令

bash
docker run -it --rm docker.xuanyuan.run/depthai-dev:latest

运行示例程序

bash
# 进入容器后运行示例
docker run -it --rm docker.xuanyuan.run/depthai-dev:latest python3 examples/ColorCamera/rgb_preview.py

挂载本地示例代码

如需运行本地修改的示例代码，可通过卷挂载方式：

bash
docker run -it --rm -v $(pwd)/my_examples:/app/examples docker.xuanyuan.run/depthai-dev:latest python3 /app/examples/my_custom_example.py

注意事项

• 确保主机已安装Docker环境
• 如涉及硬件访问（如DepthAI设备），可能需要添加--device参数挂载设备，具体取决于示例程序需求
• 镜像版本应与DepthAI示例程序版本匹配，避免兼容性问题