沃土开放平台

常见问题
1、账号类问题
Q:账号注册邮件收不到是怎么回事?
A:部分邮箱可能会有拦截,可以在邮箱的垃圾邮件中查看一下,并将其设置为不再拦截。
Q:在网站上申请的账号,为什么在Uface App和门控App上都能登录?这两个App有什么区别?
A:账号是全平台通用的,可以登录沃土、智能前台的后台(控制台),也可以登录Uface、Uface门控App。
  • 智能前台后台与Uface App数据互通,是一体化的软件
  • Uface门控App是我司基于沃土API开发的软件,使用的是我司自己的沃土账号,用户使用门控App相当于是使用了二次开发的成品软件,设备配置选项由我司维护。
  • 沃土后台是开发者平台,用户可使用自己的沃土账号在平台上进行人员、设备、识别记录管理,设备配置选项可自定义修改;同时提供API接口文档,开发人员可自行调用接口进行测试;后续将发布沃土App,沃土后台数据与沃土App数据会互通。
2、设备类问题
Q:设备已经连上网线了,但还是提示请连接网线/网络异常。
A:可按如下步骤确认问题:
1.尝试设备重启。
2.将设备连接别的网线,确认网线是否有网、插口是否松动。
3.设备为自动获取IP的DHCP模式,请检查网络环境是否需要分配静态IP或需要将设备的mac地址备案。
4.查看路由器是否将此设备拉入黑名单。
若仍未解决问题,请联系客服人员(客服热线:0571-87293191)。
Q:设备断网能够识别吗?
A:设备在离线断网的情况下仍可以使用,可以识别已经成功授权到设备上的人员,但识别记录上传及消息推送会延迟。
当设备恢复联网后,设备上的离线识别数据会自动上传云端服务器,云服务器会调用已配置好的回调地址,向回调地址发送识别数据。
Q:设备不能显示视频图像,只显示人形框。
A:在沃土平台“设备管理—修改配置—屏幕图像可视化”处将配置更改为预览模式,开启屏幕视频流。完成修改后,设备重启即可生效配置。
Q:如何在设备屏幕上显示设备名称?
A:在沃土平台“设备管理—修改配置—设备名称显示”处选择设备名称显示类型,可以选择显示应用名称、设备名称或同时显示。完成修改后,设备重启即可生效配置。
Q:设备一直在初始化状态。
A:先尝试重启设备,若无法进入正常界面,设备需要进行重置,联网再升级。操作步骤为:
1.在沃土平台“设备管理—设备重置”处进行设备重置,等待设备重启进入二维码界面;若平台上点击重置后设备无反应,则需进行物理重置:长按RESET小孔8秒后松开。
2.设备出现二维码界面,此时可对设备进行联网升级。
3.升级成功后,进行数据校对,将设备数据与云端保持一致,设备进入识别界面。
数据校对一般是在重置、初始化和特殊情况下校对使用。
Q:如何设置语音播报?
A:在沃土平台“设备管理—修改配置”处,可进行语音播报内容、屏幕显示内容、串口输出内容、识别距离、视频流开关、识别精度、设备名称显示类型、设备logo、陌生人开关等设置。完成修改后,设备重启即可生效配置。语音播报可选择打开或关闭,播报内容可自定义,详情见修改设备配置接口。
Q:设备logo在哪,怎么用?
A:设备logo位于设备屏幕上的动画窗格内,在沃土平台“设备管理—修改配置”处,可上传jpg、png、mp4格式的文件。logo窗格高160宽214;若调用接口修改设备配置,则logoUrl字段需传文件的url,文件格式同上。设备重启后修改的配置才会生效。
Q:设备识别人员的数据没有收到是怎么回事?
A:请按照如下步骤检查:
1.是否为设备所绑定的应用指定了回调地址。在应用管理中,编辑查看应用详情,确认该应用配置了回调地址。
2.检查回调地址输入是否正确,在回调管理中,检查回调地址URL。
3.检查回调地址服务器是否能够调通,若是回调地址服务器存在问题,请解决后再次尝试。
4.检查回调地址接口接收参数名称/类型是否正确。
Q:设备不升级是否会影响数据回调?
A:不会影响。设备升级可以修复bug、增加功能,同时不影响已有数据,建议空余时段对设备进行升级。
Q:设备有时候会自动断网,重启后又连上网了,这是什么问题?
A:现场网络不稳定的情况下,设备会断网。
Q:设备一直是待机屏保界面(或设备卡在某个界面),屏幕上显示转圈,人站在设备面前没反应。
A:尝试重启设备,若无法修复请联系客服人员。
Q:下发了60个人员到设备,但是设备屏幕上显示不到60人,是不是设备同步有问题?
A:调用数据校对接口后,设备数据会与云端数据保持一致,以设备上显示的授权人数为准。
Q:设备的存储容量是多少?若设备容量满了,会删除什么内容?
A:设备里存储的不仅有识别记录,还有人员注册照、识别现场照。
1.人员注册照片:始终存储在设备内,不会删除,每张照片小于400K,实际上设备可以存储2万张,为了确保识别率,建议3000张以内。
2.识别记录:限定上限100万条(含最近1万张现场照),若超出则会覆盖之前的记录。
3.现场照:系统存储空间小于3G就会删除最早的1G照片,设备一共存储8G
3、接口类问题
Q:回调怎么用?
A:应用配置了回调url地址后,当有人员被设备成功识别后(设备网络通畅),云端服务器会向回调URL地址发送识别记录数据。
POST请求,字段deviceKey、personGuid(创建人员时生成)、showTime(yyyy-MM-dd HH:mm:ss)、photoUrl(设备识别人员时的现场照,回调photoUrl要求设备为v2.7及以上版本)和type(识别出的人员分类,0:时间段内,1:时间段外,2:陌生人)。
回调有补发机制,若即时回传消息给回调URL未成功,会重试五次发送,间隔为65秒,70秒,5分钟,30分钟,1小时,3小时,6小时,12小时,24小时。
Q:回调地址添加好了,但是完成人脸识别之后,并未收到识别记录是怎么回事?
A:可能是应用没有配置这个回调地址。点开应用详情里面设置回调地址。
Q:token必须按照协议去获取吗?
A:token是按照协议去获取的,建议一天获取1次,也可以定时18小时获取1次。
Q:token传参方式错误,token是写在URL里带还是数据包里带?
A:根据HTTP的method,POST类token及其他参数都放body里,GET、PUT、DELETE类token及其他参数放URL里。
Q:设备重复添加报错、无法绑定是怎么回事?
A:需要先调用设备删除接口,将设备与原来的应用项目解绑,才能调用设备创建接口;成功调用创建接口后,才能继续调用其他业务接口。
Q:有没有接口能查询设备的状态?比如,是否在线,版本号等。
A:有的,使用设备查询接口。
Q:人员和照片可以批量注册吗?
A:目前未提供批量注册接口,可循环调用人员录入、人员照片注册接口。
Q:人员可以批量添加到设备吗?
A:批量添加人员到设备,就是将批量的人员授权到设备上;用设备授权人员接口,一台设备可以添加多个人员。
Q:批量添加人员后,设备会进行同步,同步是什么意思?
A:同步的意思是,刚才批量添加的人员数据信息存入云端服务器后,设备在0-30s内自动向服务器请求同步,将新增的授权人员信息同步到设备上。
Q:设备授权人员这个接口调用一次就会进行设备同步,短时间内多次调用会不会有问题?
A:调用设备授权人员接口时,设备0-30s内自动向服务器请求同步,将这30s内云端新增的人员数据同步到设备上。短时间内多次调用设备授权人员,同步将持续进行,将新增的人员同步到设备上。
Q:需要在短时间内把几个人员都授权到设备上,怎么样做比较快?
A:依次录入人员、卡号、注册照片,调用人员设备授权接口或设备授权人员接口,授权指令完成后,设备30s后自动向服务器请求同步,将新增的授权人员信息同步到设备上。若在授权指令完成后,再调用设备同步接口,设备会立刻开始同步,将新增的授权人员信息同步到设备上。
Q:更新人员照片是调用哪个接口?人员照片补发接口吗?
A:照片没有更新,只有删除(人员照片删除接口)和新增(人员照片注册接口)。
Q:为一个人员添加了一张照片,显示添加成功,然后调用人员照片状态查询接口,返回结果是调用成功,但data字段没有任何内容。
A:人员照片状态查询接口返回结果是成功,是指接口调用成功。人员没有授权到设备上,设备上就没有人员信息,也不会有照片信息。人员照片状态查询接口需要人员id和设备序列号,但是这个人员id信息不在这个设备上,所以不存在照片状态及信息,data数据返回为空。
Q:人员授权设备后,添加照片,返回是success,还是不能识别人员。
A:返回success是指照片存入云端服务器,一个人员最多可以在云端存储3张照片。随后,照片自动下发到人员授权过的设备上。调用人员照片状态查询接口,若照片在设备上的状态为注册成功,则可以验证设备能否正确识别人员;若照片在设备上的状态为注册失败,则照片存在人脸框过小、人脸不止一个、人脸角度过大等问题;若照片在设备上的状态为注册中,则需等待人员照片信息同步到设备上,或调用人员照片补发接口。
解决方法:查询照片状态后,调用人员照片删除接口,删除在设备上注册失败的照片,重新添加新的照片。
Q:怎样调用接口获取识别时的视频流数据?
A:暂时不提供读视频流的接口。
4、人员、照片、识别类问题
Q:人员照片有什么要求?
A:
1.照片内只有一个人脸
2.人脸角度不要超过±15°,包括垂直、水平、旋转3个方向
3.人脸五官切勿遮挡,勿上传模糊照、浓妆、PS、表情夸张照片
4.戴眼镜的照片中最好不要出现镜片反光
5.照片中人脸不能小于1/3。
Q:识别场景有要求吗?
A:
1.光线太暗或者逆光会影响识别
2.识别人员本人与照片差距不能过大
3.人员面对摄像头时,脸的角度不宜过大,如侧脸、仰视、俯视等。
Q:戴眼镜的照片影响大吗?
A:如果照片里眼镜上有反光或亮点,识别会受影响。
建议:
1.用新的照片替换掉有反光的照片
2.识别的时候,尝试不直视镜头,规避掉眼镜反光
Q:录入人员,是否一定要身份证信息?对这个参数是否有格式验证,可否用我方系统里的ID代替?
A:可以使用其他系统ID,若要刷卡识别,则卡号需为IC卡/市民卡/身份证,限制长度为32个字符。
Q:人员录入失败,名字是用微信注册的,微信昵称包含了特殊字符。
A:name字段有特殊字符会造成人员添加失败,目前不建议使用特殊字符进行录入。
Q:对人员姓名、身份证、手机号码有进行唯一判断吗?添加人员的时候,发现可以重复的添加相同的信息。
A:同名同姓也是有可能的,系统分配给的人员guid是唯一的;设备使用的场景很多,不进行唯一校验。
Q:手机、身份证是必须要填的吗?
A:不是必须的,可以不填。
Q:人员录入了,人员照片注册成功了,设备无法识别人员。
A:可能原因有:
1.人员没有添加/授权到设备
2.照片没有在设备上注册成功
3.照片和真人差距过大。
Q:设备无法识别授权人员,查询照片状态得知照片在设备上的状态为注册中。
A:调用人员照片补发接口,服务端会把这张照片下发到授权的设备上,不用重新进行人员授权到设备。
Q:设备难以识别人员,识别较慢,或出现误识别。
A:可能原因有:
1.该人员上传的照片过于相似
2.照片上有镜片反光,影响了人脸
3.识别时,人员戴有眼镜且镜片反光严重
识别阈值提高可以提高识别精度,但也会增加识别的时间。
Q:设备识别人脸不流畅,需要比较大的动作幅度才能识别。
A:设备会一直追踪屏幕内的人脸框,识别过一次后,追踪没断之前不会继续进行识别。
建议:尝试人走进镜头,或者侧过头再对准镜头,观察识别是否流畅。
Q:新增的照片会删掉原来那张吗,新增的照片会自动下发到人员授权的设备上吗?
A:新增照片不会删除之前的照片,一个人目前可以创建最多三张照片。新增的照片,若人员已经授权到设备,则会自动下发到所有授权的设备上;若人员无授权,则不会下发。
Q:是不是只要有一张照片在设备上注册成功就能识别人员了?
A:原则上是的,但是会出现误识别。建议上传3张,尽量不要修图或美图,也不要太过于相似。
5、大屏类问题
Q:设备HDMI连接大屏显示时,是否支持设备端显示屏同时显示?
A:目前不支持。设备连接大屏时,设备屏幕为黑屏,摄像头开启且正常运作,识别界面会在大屏上显示。
Q:大屏文字内容是否可编辑?如何编辑?
A:文字内容可编辑,通过修改配置接口可以编辑简介和标语,通过设备更新接口可编辑设备名称,应用名称在应用管理中编辑。