小米摄像头通过miot接入后HA无法预览，也没办法获取截图

[adi-hld]

HA版本：
Core ：2026.3.0
Supervisor：2026.02.3
Operating System：17.1
Frontend：20260304.0

Xiaomi Miot 版本：
V1.1.4

我的需求是想通过HA的REST API获取camera 截图。类似：curl -X GET “http://homeassistant.local:8123/api/camera_proxy/camera.xiaomi_069a03_72ee_camera_control"，无法执行

我测试了3款摄像头，都出现了一样的问题：
1.xiaomi_069a03_72ee_camera ：小米摄像头3 3k云台版
2.isa_hlc7_1e95：小米摄像头 2k
3.chuangmi_029a02_d88d

问题描述：
1.摄像头获取到的实体中其他entity_id都可用，只有camera_control的实体不可用，状态一直为unavailable。

2.我尝试了帐号集成(自动模式)、局域网集成(host+token)，都是同样的问题
3.我想查询支持的摄像头：访问；https://home.miot-spec.com/s/camera，提示：Fatal error: Composer detected issues in your platform: Your Composer dependencies require a PHP version ">= 8.2.0". You are running 7.4.33. in /var/www/vendor/composer/platform_check.php on line 24
4.当前没有反馈问题的渠道：微信群不再加人，qq群已满，TG群是什么，没用过，国内似乎很不友好

附录：
1.我的yaml文件：

2.以xiaomi_069a03_72ee_camera为例，返回的功能实体 { "success": true, "data": [ { "entity_id": "button.xiaomi_069a03_72ee_info", "state": "2026-03-12T09:04:30.130444+00:00", "attrs": { "button.info": "Xiaomi Smart Camera 3 3K", "model": "xiaomi.camera.069a03", "did": "1212212388", "mac": "00:9D:85:81:72:EE", "lan_ip": "192.168.11.23", "app_link": "mihome://device?uid=165282940&did=1212212388", "miot_type": "urn:miot-spec-v2:device:camera:0000A01C:xiaomi-069a03:1:0000D070", "available": true, "home_room": "165282940 办公室", "icon": "mdi:information", "updater": "cloud", "camera_control.on.error": "-704220043 Property value error", "camera_control.ptz_camera.error": "-704220043 Property value error", "camera_control.night_shot.error": "-704220043 Property value error", "camera_control.image_rollover.error": "-704220043 Property value error", "camera_control.time_watermark.error": "-704220043 Property value error", "camera_control.wdr_mode.error": "-704220043 Property value error", "glimmer_full_color-2-7.error": "-704220043 Property value error", "camera_control.human_tracking": false, "camera_control.recording_mode.error": "-704220043 Property value error", "memory_card_management.status": 1, "storage_total_space-3-2.error": "-704220043 Property value error", "storage_free_space-3-3.error": "-704220043 Property value error", "storage_used_space-3-4.error": "-704220043 Property value error", "dialog_ejected-3-5.error": "-704220043 Property value error", "remaining_recording_duration-3-6.error": "-704220043 Property value error", "motion_detection.error": "-704220043 Property value error", "detection_sensitivity-5-3.error": "-704220043 Property value error", "motion_detection_start_time-5-4.error": "-704220043 Property value error", "motion_detection_end_time-5-5.error": "-704220043 Property value error", "motion_detection.alarm_interval": 16, "indicator_light.on": true, "speaker.volume": 30, "speaker.mute.error": "-704220043 Property value error", "ai_detection.human_detection.error": "-704220043 Property value error", "ai_detection.move_detection.error": "-704220043 Property value error", "move_detection_sensitivity-8-28.error": "-704220043 Property value error", "p2p_stream.video_codec.error": "-704220043 Property value error", "p2p_stream.audio_codec.error": "-704220043 Property value error", "p2p_stream.audio_bit_width.error": "-704220043 Property value error", "p2p_stream.audio_smp_rate.error": "-704220043 Property value error", "p2p_stream.audio_channel.error": "-704220043 Property value error", "p2p_stream.talk_codec.error": "-704220043 Property value error", "p2p_stream.distortion_crt_osdx.error": "-704220043 Property value error", "p2p_stream.distortion_crt_osdy.error": "-704220043 Property value error", "p2p_stream.resolution_types.error": "-704220043 Property value error", "p2p_stream.talk_mode.error": "-704220043 Property value error", "camera_ipc_cloud.gop_value.error": "-704220043 Property value error", "camera_ipc_cloud.vip_offset_num.error": "-704220043 Property value error", "non_vip_offset_num-14-3.error": "-704220043 Property value error", "nas.status.error": "-704220043 Property value error", "qrcode_information-23-1.error": "-704220043 Property value error", "self_check.self_check_results.error": "-704220043 Property value error", "self_check.manual_check_results.error": "-704220043 Property value error", "converters": [ "button.info", "light.indicator_light.on", "camera.camera_control", "sensor.memory_card_management.status", "sensor.storage_free_space-3-3", "sensor.storage_used_space-3-4", "switch.camera_control.on", "switch.camera_control.time_watermark", "switch.camera_control.wdr_mode", "switch.glimmer_full_color-2-7", "switch.motion_detection", "switch.indicator_light.on", "number.camera_control.image_rollover", "number.motion_detection.alarm_interval", "select.camera_control.night_shot", "select.camera_control.recording_mode", "select.detection_sensitivity-5-3", "select.move_detection_sensitivity-8-28" ], "customizes": { "miot_cloud_action": true, "sensor_properties": "memory_card_management.status,storage_free_space,storage_used_space", "select_properties": "night_shot,recording_mode,detection_sensitivity", "switch_properties": "on,time_watermark,motion_tracking,motion_detection,wdr_mode,glimmer_full_color", "number_properties": "image_rollover,alarm_interval" }, "updated_at": "2026-03-12 17:24:53.303830+08:00", "info": null, "device_class": "update", "friendly_name": "Xiaomi Smart Camera 3 3K 信息" } },

{
  "entity_id": "camera.xiaomi_069a03_72ee_camera_control",
  "state": "unavailable",
  "attrs": {
    "entity_picture": "/api/camera_proxy/camera.xiaomi_069a03_72ee_camera_control?token=ef3c2b14a1a1feb8e22ca4fda6a1a37dbfa07e14851de9daad40cf18aa2bfca4",
    "friendly_name": "Xiaomi Smart Camera 3 3K 摄像机控制",
    "supported_features": 0,
    "keep_streaming": true,
    "video_attribute": 1,
    "check_lan": true,
    "miot_cloud": true
  }
}

]
}

[github-actions]

根据您提供的信息，小米摄像头接入后 camera_control 实体显示为 unavailable 的问题，通常与设备状态同步和云端视频流获取机制有关。以下是具体原因分析和解决方案：

问题根源

1. 错误码分析：您提供的实体属性中包含大量 -704220043 Property value error 错误，这表明设备部分属性值不符合 MIoT 协议规范，导致摄像头实体无法正常初始化。

2. 视频流获取机制：根据插件设计，摄像头视频流需要通过小米云端接口获取，特别是需要依赖"看家助手"功能产生的视频片段。如果云端未生成有效视频流，camera 实体会保持 unavailable 状态。

解决方案

步骤 1：在米家 APP 中开启看家助手

这是最关键的一步。请确保在米家 APP 中为摄像头开启 看家助手 功能：

• 打开米家 APP → 选择摄像头设备 → 进入设置 → 找到"看家助手"或"移动侦测"功能并启用
• 建议设置侦测区域和灵敏度，确保能触发视频录制

步骤 2：添加自定义属性优化兼容性

在 configuration.yaml 中为摄像头添加自定义属性，尝试修复视频流兼容性问题：

# configuration.yaml
xiaomi_miot:
  device_customizes:
    xiaomi.camera.069a03:  # 您的小米摄像头 3 3K 型号
      motion_stream_slice: -1  # 尝试获取静止视频帧
      cloud_delay_update: 6    # 增加云端状态同步延迟
    isa.camera.hlc7:           # 小米摄像头 2K 型号
      motion_stream_slice: -1
      cloud_delay_update: 6
    chuangmi.camera.029a02:    # 第三款摄像头型号
      motion_stream_slice: -1
      cloud_delay_update: 6

修改后请重启 Home Assistant。

步骤 3：检查网络连通性

确保 HA 能正常访问小米服务器：

• 进入 配置 > 系统 > 修复 > 右上角三个点 > 系统信息
• 检查 Xiaomi Miot Auto 是否有 unreach 标记
• 通过 SSH 执行：curl -v https://api.io.mi.com 测试连通性

步骤 4：切换集成模式

如果问题依旧，尝试以下方式重新添加设备：

1. 删除现有集成
2. 重新添加时选择 账号集成 → 云端模式（非自动/本地模式）
3. 只勾选摄像头设备，避免其他设备干扰

关于设备支持查询

您提到的 home.miot-spec.com 网站 PHP 错误是临时性问题，可以通过以下替代方式查询支持列表：

• 访问 GitHub 上的支持设备列表：miot_local_devices.py
• 查看摄像头专项支持：camera-recording-notify.yaml

反馈渠道

虽然微信群和 QQ 群已满，您仍可通过以下方式反馈：

• GitHub Issues：https://github.com/al-one/hass-xiaomi-miot/issues/new/choose
• 在 Issue 中附上您的设备型号、实体属性和日志信息

REST API 获取截图的前提条件

只有当 camera.xiaomi_069a03_72ee_camera_control 实体状态变为 idle 或 streaming 后，以下 API 才能正常工作：

curl -X GET "http://homeassistant.local:8123/api/camera_proxy/camera.xiaomi_069a03_72ee_camera_control" \
  -H "Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN"

请先完成上述步骤解决 unavailable 问题，再测试 API 调用。

[github-actions]

根据您提供的信息，小米摄像头接入后camera_control实体显示unavailable，且无法获取截图，这通常与视频流配置和设备兼容性有关。以下是具体原因分析和解决方案：

问题原因

从实体属性可以看到大量错误："camera_control.on.error": "-704220043 Property value error"，这表明设备属性读取失败。摄像头实体需要正确的视频流配置才能正常工作，默认配置可能不适用于您的设备型号。

解决方案

1. 开启米家APP中的"看家助手"功能

在米家APP中找到摄像头设备，确保已开启看家助手（移动侦测录像）功能。这是获取视频流和截图的前提条件。

2. 添加自定义属性配置

在configuration.yaml中为摄像头实体添加自定义属性，解决视频编码兼容性问题：

# configuration.yaml
xiaomi_miot:
  device_customizes:
    xiaomi.camera.069a03:  # 您的摄像头型号
      motion_stream_slice: -1  # 解决编码兼容性问题
      # 如果仍不行，尝试添加以下配置
      # video_attribute: 1
      # keep_streaming: true

说明：

• motion_stream_slice: -1：针对部分摄像头编码问题，可显示静止视频画面
• 配置完成后需重启Home Assistant

3. 检查设备连接模式

您的日志显示"updater": "cloud"，说明当前使用云端连接。建议尝试：

• 账号集成时选择"云端模式"：部分摄像头仅支持云端获取视频流
• 避免使用"本地模式"：摄像头可能不支持本地miot协议

4. 验证REST API调用方式

配置生效后，使用以下格式获取截图：

# 确保使用正确的token和entity_id
curl -X GET "http://homeassistant.local:8123/api/camera_proxy/camera.xiaomi_069a03_72ee_camera_control" \
  -H "Authorization: Bearer YOUR_LONG_LIVED_ACCESS_TOKEN"

注意：camera_proxy接口需要有效的长期访问令牌（Long-Lived Access Token），而不是API密码。

5. 检查支持的设备列表

您提到的网站访问问题，可以直接查看GitHub上的支持列表：

• 支持本地miot协议的设备：https://github.com/al-one/hass-xiaomi-miot/blob/master/custom_components/xiaomi_miot/core/miot_local_devices.py
• 摄像头特定配置：FAQ - 常见问题 #100 (comment)

其他建议

1. 更新插件版本：您使用的是v1.1.4，建议更新到最新版本以获得更好的兼容性
2. 查看完整日志：在HA中检查Settings > System > Logs中的Xiaomi Miot相关错误
3. 尝试Blueprint：如需录像通知功能，可参考官方提供的摄像头录像蓝图

如果以上方法仍无法解决，建议在GitHub Issues页面提交问题，并提供完整的设备型号和日志信息。

[adi-hld]

1.我根据你提供的支持本地miot协议的设备进行查询，目前我的3台设备中只有isa_hlc7这台是在支持的设备列表中的。但是设备支持本地miot协议和我当前的需求：获取摄像头实时截图、获取摄像头实时预览视频流是强相关的吗？必须设备要支持miot本地协议才能实现我的需求吗？
设备1.xiaomi_069a03_72ee_camera
设备2.isa_hlc7_1e95
设备3.chuangmi_029a02_d88d

2.我当前的yaml配置如下：

default_config:

# Load frontend themes from the themes folder
frontend:
  themes: !include_dir_merge_named themes

automation: !include automations.yaml
script: !include scripts.yaml
scene: !include scenes.yaml
homeassistant:
  customize:
    camera.xiaomi_069a03_72ee_camera_control:
      motion_stream_slice: -1
      keep_streaming: true
      video_attribute: 1
      check_lan: true
      miot_cloud: true

xiaomi_miot:
  device_customizes:
    xiaomi.camera.069a03:  
      motion_stream_slice: -1  
      cloud_delay_update: 6   
      video_attribute: 1
      keep_streaming: true
    isa.camera.hlc7:           
      motion_stream_slice: -1
      cloud_delay_update: 6
      video_attribute: 1
      keep_streaming: true
    chuangmi.camera.029a02:    
      motion_stream_slice: -1
      cloud_delay_update: 6
      video_attribute: 1
      keep_streaming: true

在当前配置下，我打开了 设备1.xiaomi_069a03_72ee_camera 和 设备2.isa_hlc7_1e95的看家助手，的确可以在HA看到设备的最后一个看家助手视频 #466 , 但是仍然无法在HA看到摄像头的实时预览流，当前hass-xiaomi-miot插件是无法支持在HA上实时预览camera的嘛？只能获取“看家助手"功能产生的视频片段？

3.我通过如下命令获取到的图片是设备的最后一个看家助手视频的最后一帧图像，我想获取的是camera的实时截图，获取ipc camera的实时截图hass-xiaomi-miot插件是支持的吗

curl -X GET "http://homeassistant.local:8123/api/camera_proxy/camera.xiaomi_069a03_72ee_camera_control" \
    -H "Authorization: Bearer token" \
  --output snapshot.jpg