tiancheng91 小米摄像头截图技能
通过 Miloco 后端服务获取小米摄像头的实时画面截图。
首次设置流程
步骤 1: 启动 Miloco 服务
docker run -d \
--name miloco \
--network host \
-e BACKEND_PORT=8001 \
ghcr.io/tiancheng91/miloco-backend:dev
步骤 2: 完成小米账号认证
服务启动后，引导用户完成以下操作：
- 打开浏览器访问:
http://localhost:8001 - 登录小米账号: 使用小米账号完成登录认证
- 设置密码: 设置一个六位数字密码（用于后续 API 调用）
等待用户确认: 询问用户是否已完成认证和密码设置，等待用户回复"已完成"或"确认"后继续。
步骤 3: 验证配置
用户确认后，尝试获取摄像头列表验证配置是否成功：
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--list
步骤 4: 保存配置（可选）
如果获取摄像头列表成功，询问用户是否保存以下信息以便后续使用：
- 密码: 保存到
MILOCO_PASSWORD环境变量或配置文件 - 摄像头列表: 记录摄像头 ID 和名称的对应关系
示例保存方式：
# 保存到环境变量（当前会话）
export MILOCO_PASSWORD="你的六位密码"
# 或保存到 shell 配置文件（永久保存）
echo 'export MILOCO_PASSWORD="你的六位密码"' >> ~/.zshrc
后续使用流程
完成首次设置后，后续可直接获取摄像头截图：
1. 确认服务状态
docker ps | grep miloco
如果服务未运行，先启动：
docker start miloco
2. 获取摄像头截图
# 使用已保存的密码环境变量
python scripts/camera_client.py \
--server http://localhost:8001 \
--password $MILOCO_PASSWORD \
--camera-id "CAMERA_ID" \
--output ./images
脚本功能说明
脚本位于 scripts/camera_client.py，支持以下功能：
列出所有摄像头
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--list
输出示例：
摄像头列表:
--------------------------------------------------------------------------------
ID: 1036201996
名称: 客厅摄像头
在线: 是
位置: 我家 - 客厅
--------------------------------------------------------------------------------
获取指定摄像头截图
# 使用默认文件名 (日期_did_时分秒.jpg)
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--camera-id "1036201996" \
--output ./images
# 指定自定义文件名
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--camera-id "1036201996" \
--output ./images \
--filename "living_room_snapshot"
持续获取截图（监控模式）
# 每30秒获取一次
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--camera-id "1036201996" \
--output ./images \
--loop
# 每60秒获取一次，自动清理1天前的图片
python scripts/camera_client.py \
--server http://localhost:8001 \
--password YOUR_PASSWORD \
--camera-id "1036201996" \
--output ./images \
--loop --interval 60 --cleanup
参数说明
| 参数 | 短参数 | 说明 | 必填 |
|---|---|---|---|
--server |
-s |
Miloco 服务器地址 | 是 |
--password |
-p |
密码（也可通过 MILOCO_PASSWORD 环境变量设置） |
是 |
--username |
-u |
用户名，默认 admin | 否 |
--list |
-l |
列出所有摄像头 | 否 |
--camera-id |
-c |
摄像头设备ID (did) | 否* |
--output |
-o |
输出目录，默认当前目录 | 否 |
--filename |
-f |
自定义文件名（不含扩展名） | 否 |
--loop |
持续获取图片 | 否 | |
--interval |
-i |
循环间隔秒数，默认30 | 否 |
--cleanup |
自动清理过期图片 | 否 | |
--cleanup-days |
清理多少天前的图片，默认1 | 否 | |
--debug |
-d |
启用调试日志 | 否 |
* 获取截图时必填
工作流程总结
首次使用:
┌─────────────────┐
│ 1. 启动 Docker │
└────────┬────────┘
▼
┌─────────────────────────────────┐
│ 2. 引导用户访问 localhost:8001 │
│ 完成小米账号认证 + 设置密码 │
└────────┬────────────────┘
▼
┌─────────────────────────────────┐
│ 3. 等待用户确认完成 │
└────────┬────────────────┘
▼
┌─────────────────────────────────┐
│ 4. 尝试获取摄像头列表 │
└────────┬────────────────┘
▼
┌─────────────────────────────────┐
│ 5. 询问是否保存密码和摄像头信息 │
└────────┬────────────────┘
▼
┌─────────────────────────────────┐
│ 6. 完成，可随时获取截图 │
└─────────────────────────────────┘
后续使用:
┌─────────────────┐
│ 确认服务运行 │
└────────┬────────┘
▼
┌─────────────────┐
│ 直接获取截图 │
└─────────────────┘
注意事项
- 确保摄像头设备在线才能获取截图
- 截图文件名默认格式：
日期_did_时分秒.jpg - 支持的图片格式：JPG、PNG（根据响应自动判断）
- 如果认证失败会自动重试登录一次
- 密码为六位数字，在 Miloco Web 界面设置
项目信息
- Miloco 项目地址: https://github.com/tiancheng91/xiaomi-miloco
- Docker 镜像:
ghcr.io/tiancheng91/miloco-backend:dev