家庭摄像头进 Home Assistant：乐橙 Core 集成 + 国内 openapi.lechange.cn 配置要点

家庭摄像头进 Home Assistant：乐橙 Core 集成 + 国内 openapi.lechange.cn 配置要点

HA2026.6+内置 Imou 集成 · 现行 OpenAPI · 勿用 旧版本协议（不再维护） 栏目

树莓派上的 Home Assistant 升到2026.6后，我在「添加集成」里搜到Imou——官方文档 说，乐橙摄像头可直接走Core 内置集成，不必再装 HACS。

填上 乐橙开放平台 的 App ID、App Secret，提交成功，设备列表却是空的。乐橙 App 里门口机在线、能预览。翻了两小时论坛才发现：Server region 选成了亚太，国内账号应选 China，API 走openapi.lechange.cn。改完区域，两分钟后camera实体自己冒出来。

为什么 2026.6 之后优先 Core，而不是只刷 RTSP

乐橙开放平台 面向要把乐橙 IPC 接进自己系统的开发者；2026.6 起 Imou 进入 HA 官方 Core（底层pyimouapi调开放平台），配置流填App ID、App Secret、Server region即可。

Core vs HACS：路径变了，云还是那条云

国内最容易踩的坑：region 与账号注册地不一致 → 集成成功但设备列表 0。国内账号务必China (cn)，对应网关https://openapi.lechange.cn/openapi（见 开发规范 · 域名说明）。

另：乐橙 App 能预览 ≠ 开发者资产池有设备。HA 读的是开放平台账号；设备绑在私人小号上，listDeviceDetailsByPage也是空的。

Step 0 · 开放平台注册（约 10 分钟）

① https://open.imou.com 注册 → 开发中心 → 我的应用 → appId / appSecret ② 乐橙 App 配网后，用开发者主账号绑定（控制台 / bindDevice / 开发者号登录 App 添加） ③ 脚本验收 listDeviceDetailsByPage：deviceId 出现且 online ④ HA 集成 Server region 选 China

accessToken与分页接口签名规则见 开发规范。

验收脚本（HA 配置前先跑）：

// scripts/verify-lechange-pool.jsimportcryptofrom'node:crypto';import{randomUUID}from'node:crypto';import'dotenv/config';functionsign(time,nonce,secret){returncrypto.createHash('md5').update(`time:${time},nonce:${nonce},appSecret:${secret}`,'utf8').digest('hex');}asyncfunctionplatformCall(method,params){consttime=Math.floor(Date.now()/1000);constnonce=randomUUID();constbody={system:{ver:'1.0',appId:process.env.APP_ID,sign:sign(time,nonce,process.env.APP_SECRET),time,nonce,},id:randomUUID(),params,};constres=awaitfetch(`${process.env.OPENAPI_BASE}/${method}`,{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify(body),});constjson=awaitres.json();if(json.result?.code!=='0')thrownewError(json.result?.msg);returnjson.result.data;}const{accessToken}=awaitplatformCall('accessToken',{});constpage=awaitplatformCall('listDeviceDetailsByPage',{token:accessToken,pageSize:20,page:1,source:'bindAndShare',});for(constdofpage.deviceList??[]){console.log(d.deviceId,d.deviceStatus,d.deviceModel);}console.log('count',page.deviceList?.length??0);

# .envAPP_ID=lcdxxxxxxxxxxxxAPP_SECRET=your_secretOPENAPI_BASE=https://openapi.lechange.cn/openapi

踩坑 A：列表 0 但 App 能看 → 私人号绑定，换开发者主账号（见 接入指南）。

踩坑 B：勿用停维护的deviceList方法；现行列表为listDeviceDetailsByPage。

Step 1 · HA Core 集成配置

设置 → 设备与服务 → 添加集成 → Imou （快捷入口：https://my.home-assistant.io/redirect/config_flow_start?domain=imou）

# secrets.yaml — 勿提交 Gitimou_app_id:"lcdxxxxxxxxxxxx"imou_app_secret:"your_app_secret"

提交成功后常见实体（以设备为准）：

camera.imou_door_live_view_sd camera.imou_door_live_view_hd button.imou_door_ptz_up / ptz_down / ptz_left / ptz_right button.imou_door_restart

踩坑 C：region 选 APAC/EU/NA → 国内账号列表空，改China后等约2 分钟轮询或重启集成。

踩坑 D：Invalid App ID or App secret→ 凭证与 region 不匹配；检查复制无空格。

Step 2 · 验收直播

开发者工具 → 状态 → 搜camera.：

camera.imou_porch_live_view_hd

Dashboard 加Picture Entity/Live View。转圈时查：

□ listDeviceDetailsByPage 里 online □ Server region = China □ 控制台 [我的资源](https://open.imou.com/consoleNew/resourceManage/myResource) 配额未用尽 □ HA 日志无 TK1002 / sign 错误

官方说明：每个 App ID 每月约30,000 次免费 API 请求，超出按 平台定价 计费；多路 Live View 消耗更快。

Step 3 · 自动化示例

Core 以camera + button为主。语音「看门口」：

script:show_porch:alias:看门口乐橙摄像头sequence:-service:camera.play_streamtarget:entity_id:camera.imou_porch_live_view_hddata:media_player:media_player.living_room

动检开灯：若仍用 HACS 组件的binary_sensor，可写：

automation:-id:imou_porch_lightalias:门口动检开灯trigger:-platform:stateentity_id:binary_sensor.imou_porch_motion_alarmto:"on"condition:-condition:sunafter:sunsetaction:-service:light.turn_ontarget:entity_id:light.porch

注意：Core 与 HACS勿对同一 appId 重复添加，否则配额双倍。Core 暂无 motion sensor 时，用setMessageCallback→ MQTT → HA（下节）。

Step 4 · 实时告警：OpenAPI 回调补层

Core2 分钟轮询不适合门铃级联动。在 HA 同网或公网桥接：

awaitplatformCall('setMessageCallback',{token:adminAccessToken,status:'on',callbackUrl:'https://your-ha-bridge.example.com/imou/events',callbackFlag:'alarm,deviceStatus',basePush:'2',});

详见 事件消息推送。

automation:-alias:乐橙动检推手机trigger:-platform:mqtttopic:imou/alarm/DOOR_SERIALcondition:-condition:templatevalue_template:"{{ trigger.payload_json.msgType == 'videoMotion' }}"action:-service:notify.mobile_app_your_phonedata:title:门口有动静message:"{{ now().strftime('%H:%M') }}"

回调须HTTPS + 立即 200，否则平台停推。

Checklist

□ open.imou.com 应用 + 开发者主账号绑定 □ openapi.lechange.cn 下 listDeviceDetailsByPage ≥1 online □ HA Imou 集成 region=China，camera 出画 □ secrets 未进 Git □ （可选）setMessageCallback + MQTT

Core vs HACS vs ONVIF

排错速查

安全与隐私

• appSecret仅secrets.yaml；自动化推手机前与家人确认监控范围。
• 回调日志脱敏 deviceId。

小结

乐橙摄像头进 Home Assistant，2026.6 之后优先 Core 内置 Imou 集成：

open.imou.com 注册 → 设备进资产池 → listDeviceDetailsByPage 验收 → HA 添加 Imou（Server region = China / openapi.lechange.cn） → camera 出画 → 自动化或 setMessageCallback

LAN 看直播、云端做实体与管控，两条路可并存。region 选错是国内玩家第一大坑——集成「成功」但列表空，先查 China，再查绑定。

延伸阅读

• HA 官方 Imou 集成文档
• 资源下载 · Imou Home Assistant 组件 · GitHub
• 分页查询设备详情
• 事件消息推送
• 同系列：自建全屋智能 App 前先跑通列表与回调

开始接入

在乐橙开放平台 open.imou.com注册并创建应用，领取免费设备接入与媒体带宽。平台以视频技术与安全为核心，提供 OpenAPI、OpenSDK 及Home Assistant 官方 Core 集成支持，帮助极客玩家与集成商快速把乐橙 IPC 纳入全屋智能。

建议今天两步：脚本 listDeviceDetailsByPage 看到 online→HA 添加 Imou 选 China 出第一帧画面。比囤十个插件更有成就感。

你卡在 region、绑定还是回调？评论区说说，下篇可写「Core + MQTT 动检完整桥接」。