6 智能摄像机对接示范 – 商米开发者文档

6.1 店铺对齐

请参考《商米数字店铺开放平台 – > 商户店铺》章节将用户在商米数字店铺上创建的门店与Saas合作伙伴平台上的同一家门店绑定对齐，之后的所有操作都是基于该门店内的设备和数据进行

6.2 设备配网

如果您的设备是通过有线连入互联网，则可以跳过该步骤。

如果您的设备通过无线网络连入互联网，请按照以下步骤使用android SDK进行配网。（对于其它操作系统或者设备，您也可以直接调用设备API进行配网）

如果设备上的蓝灯常亮，表明设备联网成功。

如果设备上显示为绿灯，则说明网络连接异常。

6.3 设备绑定

6.3.1 接口绑定

IPC设备连入网络后，调用设备绑定接口 /device/ipc/bind 将设备绑定到指定店铺内。

请求示例：

  "method": "POST",
  "url": "https://store.uat.sunmi.com/openapi/device/ipc/bind",
  "headers": {
    "Content-Type": "application/x-www-form-urlencoded"
  },
  formData: {
    "sunmi_shop_no": "560279010307",
    "ipc_sn": "C201D8BS00089",
    "mac":"0C25766F5705",
    "app_id": "LMWWQVTW4QGCC",
    "timestamp": 1578972864,
    "random": "5dsf6698",
    "sign": "33C18A18282733A71F998BB5A5E4319D"
  }

6.3.2 store页面绑定

通过下载商米助手，打开商米助手app页面，输入对应账号密码登录到已经对齐的门店下面。
到对应店铺下点击设备，添加设备，选择设备类型，这时接通摄像机电源，电源接通后，等待约20秒，摄像机指示灯呈[绿灯闪烁]后，点击下一步。

选择网络连接方式，有线网络连接和无线网路连接两种方式：
(1)有线网络连接需要为摄像机插入网线，并将手机连接至同一网络后点击下一步，待摄像机信号灯呈[蓝色常亮]状态后，点击下一步，找到对应的ipc设备即可绑定。
(2)无线网络连接需要将手机连接至摄像机得无线网络[SUNMI_XXXX](可以在机身或包装盒上找到)，点击下一步，找到对应得ipc设备即可绑定。

添加成功之后，用户可以在手机和web上看到新添加的ipc设备。

6.4 设备配置

6.4.1 接口修改调焦(开发中)

在设备绑定之后，用户可以调用接口修改设备的调焦。

6.4.2 store页面设置进店划线

对于FS摄像机，用户需要首先设置进店划线。
打开商米助手app，输入账号密码进入对应门店，点击设备，然后点击屏幕右上角三个小点的图标进入摄像机设置，该页面点击调整画面。
这时画面会提示”请安排人员面向摄像机，站在需要识别人脸的位置”，然后点击屏幕右上角下一步，提示”调整画面大小并移动人脸框的位置，使人脸刚好填充整个人脸框”，这时相机会自动调整画面，然后提示”为保证识别精准性，您还可以移动已设置好的进店门槛线位置或拖拽门槛线端点更改门槛线的长度”，这是您可以手动在手机屏幕上划线来设置进店门槛的位置，然后点击完成即可。

6.5 查看直播

接口列表

详情可查看第7章直播回放接口


接口名称	接口描述
/media/live/start	开始远程直播
/media/live/stop	结束远程直播
/media/playback/start	开始远程回放 (开发中)
/media/playback/stop	结束远程回放 (开发中)
/media/video/getList	获取回放视频列表
/media/motionDetection/getList	获取动态侦测视频列表
/media/playback/getSnapshot	获取指定时间的监控图片
/media/live/getSnapshot	获取实时监控图片

6.6 客流统计

接口列表

详情可查看第6章人流统计接口


接口名称	接口描述
/passengerFlow/stat/today/getLatest	获取当日实时人流量(实时总人流量)
/passengerFlow/stat/today/groupByTag	获取当日人流统计信息(按照年龄以及生熟客人脸分组)
/passengerFlow/stat/today/groupByGender	获取当日人流统计信息(按照年龄以及性别分组)
/passengerFlow/stat/today/getTrendByHour	获取当日人流变化趋势(人流总数，时间粒度为小时)
/passengerFlow/stat/history/groupByTag	获取历史人流统计信息(人流总数/生熟客/会员)
/passengerFlow/stat/history/groupByGender	获取历史客群详情(年龄以及性别)
/passengerFlow/stat/history/getTrendByHour	获取历史人流变化趋势(人流总数/生熟客，时间粒度为小时)
/passengerFlow/stat/history/getTrendByDay	获取历史人流变化趋势(人流总数/生熟客，时间粒度为天)
/passengerFlow/stat/history/getTrendByWeek	获取历史人流变化趋势(人流总数/生熟客，时间粒度为周)(开发中)
/passengerFlow/stat/history/getTrendByMonth	获取历史人流变化趋势(人流总数/生熟客，时间粒度为月)(开发中)

6.7 实时获取进店 FaceID

请参考《商米数字店铺开放平台 – > 消息中心》章节用户需要先添加消息监听地址，用户将自己平台的相关HTTP地址添加到商米数字开放平台，并提供需要监听的设备以及 IPC实时获取人员消息事件就可以实时获取进店FaceID。

6.7.1 增加消息监听

接口描述：通过本接口调用，用户可以增加消息监听的HTTP回调地址。用户将自己平台的相关HTTP地址通过该接口添加到商米数字开放平台；并提供需要监听的设备以及事件。当商米数字开放平台收到该设备的该事件时，会调用该HTTP接口。
对于该回调HTTP回调的鉴权方式，遵照商米数字店铺开放平台的鉴权方式。
回调HTTP需要带以下接口参数：

参数名称	是否必须	类型	说明
sunmi_shop_no	是	string	商米数字店铺的门店唯一标识，由商米数字店铺生成
shop_id	是	string	SaaS对接店铺标识，SaaS厂商提供
event	是	int	触发消息的类型
payload	是	string	消息的具体格式（根据消息不同会有不同的json）

请求链接： /hook/add

接口参数：


参数名称	是否必须	类型	说明	示例

sunmi_shop_no	否	string	商米数字店铺平台门店唯一编号（v2.0之后为必填项）	100939070408
shop_id	否	string	店铺在SaaS软件体系下的唯一标识（此参数为后向兼容v2.0之前版本的字段，在v2.0及以后版本使用sunmi_shop_no替代，作为门店唯一标识即可）	15220
http_callback	是	string	HTTPS回调地址链接	http://xxxxxxxx/api/testHook
event_list	是	array[int]	需要监听的事件的列表	[2001]

请求示例:

  "method": "POST",
  "url": "https://store.uat.sunmi.com/openapi/hook/add",
  "headers": {
    "Content-Type": "application/x-www-form-urlencoded"
  },
  formData: {
    "sunmi_shop_no": "100939070408",
    "http_callback": "http://xxxxxxxx/api/testHook",
    "event_list": [2001],
    "app_id": "LMWWQVTW4QGCC",
    "timestamp": 1578972864,
    "random": "5dsf6698",
    "sign": "33C18A18282733A71F998BB5A5E4319D"
  }

返回值:

{
    code：0，       /* 其他错误参考错误列表 */
    msg: "succeed"，
    data: {}               
}

字段描述: event

event 取值	说明
2001	IPC实时获取人员消息

payload(event=2001):

{
    ipc_id: "928",
    face_id: "29195",
    gender: 1,
    age_range: 4，
    group_id: "8927"，
    group_name: "stranger",
    group_type": 2
}

返回字段描述 : gender

gender取值	说明
0	未知
1	男
2	女

字段描述 : age_range

age_range取值	说明
1	0~6岁
2	7~12岁
3	13~18岁
4	19~28岁
5	29~35岁
6	36~45岁
7	46~55岁
8	56~ 岁

返回字段描述: group_type

group_type取值	说明
1	生客人脸库
2	熟客人脸库
3	店员人脸库
5	自定义人脸库