| name | lock-history |
| description | 智能门锁历史记录查询技能。用于查询门锁开关门记录、逗留抓拍、门铃响铃等历史事件记录。不支持控制操作。 |
门锁历史记录查询功能Skill
1. 必读项
本技能用于查询门锁的历史记录,包括开关门记录、回家记录、开门记录、门铃记录、逗留抓拍、门铃响铃、告警记录等。不支持控制操作。
记录类型说明
通过eventData事件中的字段进行区分:
2. 触发关键字
当用户提到以下关键词时,应加载本技能:
- 开门记录
- 关门记录
- 逗留抓拍
- 门铃响铃
- 上锁
- 添加用户
- 添加密码|指纹|掌静脉|人脸
- 开锁记录
- 操作记录
- 历史记录
3. 用户语料示例
- "查询开门记录"
- "今天谁开门了"
- "查看关门记录"
- "有逗留抓拍吗"
- "门铃响了几次"
- "最近有什么开锁记录"
- "查看历史记录"
- "谁回家了"
- "孩子几点到家的"
4. 相关参数说明
4.1 服务ID(sid)
| sid | 功能 | 说明 |
|---|
eventData | 门锁事件 | 查询门锁所有记录,包括告警和正常事件 |
4.2 eventData参数说明
| 参数 | 说明 |
|---|
data | data字段为下列字段组成的json格式的字符串 |
type | 固定枚举范围,区分告警和正常门锁事件,0-记录,1-告警 |
uic | 取值范围0-100,用户头像ID |
un | 用户名称 |
up | 区分用户操作,详见上方操作类型说明 |
das | 区分告警类型,详见上方告警类型说明 |
rt | 记录类型,0-普通,1-视频2,-照片 |
cl | 绑定联系人使用emergencyContact服务中的联系人id,多个id用,隔开 |
aid | 1、上报好望云报警事件的id,用于获取视频流;2、up=50-门铃呼叫手机记录时内容:"接听结果:通话时长" |
et | 事件发生时间,如20191226T075719Z |
5. 调用示例
5.1 查询某个用户的历史记录
默认近 24 小时
node common-skill/bin/smarthome-claw.js get_device_histories \
--dev-id "xxx" \
--sid "eventData" \
--verbose
今天
node common-skill/bin/smarthome-claw.js get_device_histories \
--dev-id "xxx" \
--sid "eventData" \
--date today
--verbose
昨天
node common-skill/bin/smarthome-claw.js get_device_histories \
--dev-id "xxx" \
--sid "eventData" \
--date yesterday
--verbose
最近 7 天
node common-skill/bin/smarthome-claw.js get_device_histories \
--dev-id "xxx" \
--sid "eventData" \
--last-days 7
--verbose
最近 30 天
node common-skill/bin/smarthome-claw.js get_device_histories \
--dev-id "xxx" \
--sid "eventData" \
--last-days 30
--verbose
5.2 数据筛选
根据本技能中sid的参数部分及用户需求,对获得的信息进行筛选
5.3 数据展示格式
开头固定:当前您家门锁记录如下:
- 展示开关门记录(按时间倒序)
- 展示门铃响铃记录(如有)
- 展示逗留抓拍记录(如有)
- 展示告警记录(如有)
6. 注意事项
- 本技能仅支持查询,不支持控制操作
- 历史记录查询使用
get_device_histories 命令
- 记录类型通过
up 和 das 字段进行区分