Skip to content

FlowEvent(进出事件明细)

按「事件」返回镜头区域的进出明细,同时覆盖进店顾客(限定从入口通道进入)与店内员工(常驻店内,不做入口过滤)。在 flowEvents 查询中使用。

query {
flowEvents(storeId: 1, startDate: "2026-08-01", endDate: "2026-08-20", roles: [STAFF]) {
peopleId
eventType
eventTime
deviceSn
zoneId
role
}
}
字段 类型 说明
peopleId String! 行人身份 ID(uuid)
eventType FlowEventType! 事件类型:ENTER / LEAVE
eventTime String! 事件发生时间,ISO8601(+08:00),如 2026-08-20T14:23:05+08:00
deviceSn String! 拍摄/抓拍该事件的摄像头 SN
zoneId Int! 摄像头区域 ID
role PeopleRole! 行人身份:CUSTOMER(顾客)/ STAFF(员工)/ OTHER(其他)
值 说明
ENTER 进入(进店)
LEAVE 离开(出店)
参数 类型 说明
storeId Int! 门店 ID
startDate String! 起始日期,YYYY-MM-DD
endDate String! 结束日期,YYYY-MM-DD
roles [PeopleRole!] 可选。传 CUSTOMER 仅返回顾客(始终应用入口过滤),传 STAFF 仅返回员工,传 OTHER 仅返回其他身份;不传返回全部
  • 顾客(CUSTOMER):仅包含有入口通道(pass_type=1)进入事件的顾客,过滤发生在服务端 —— 传不传 roles 都一样;
  • 员工(STAFF):常驻店内、不走入口,不做入口过滤;
  • 不传 roles 时返回「入口进店顾客 + 员工」的并集。