常见问题和帮助

开发常见问题

阅读指引

为了更快地在机具上完成收银应用开发,以及加快刷脸应用和iot sdk的集成联调开发,机具端侧开发过程中的问题汇总如下。

FT1 MINI硬件调试开发

Q:ISV开发测试建议

A:由于团餐场景的特点,就餐速度快,排队人数多,付费过程快等因素。建议ISV根据实际场景和环境对设备和软件进行相关的压测,实际场景会有很多刷脸的状况和意外情况,所以请ISV务必进行压测,尽量将问题暴露在压测阶段。做过压测后无问题再投入市场使用。

Q:设备如何进行adb调试连接?

A:  推出FT1 MINI设备键盘,拆开维保码下面的防水盖,插入micro USB口连接FT1 MINI和PC机。 不支持debug调试,需要打印日志方式调试。在adb调试过程中,确保RJ45和键盘USB没有插入。

Q:如何排查深度摄像头硬件是否工作正常?

A:在FT1 MINI应用列表界面,点击”MarioSdk“图标进入摄像头工厂模式界面,再点击”D2C测试“按钮,查看摄像头预览界面是否正常。如果有类似马赛克的界面则初步判断正常,参考画面如下:

Q:如何排查键盘不响应?

A:第一步:确认是否延长线断裂不通,可以将键盘不用延长线插入机器尝试确认。

第二步:不用延长线直接插入键盘,可以进入CIT模式做单体测试(在FT1 MINI应用列表界面点击CIT图标),确认键盘是否不良。

第三步:更换键盘再确定机器USB是否通路,用U盘或鼠标测试确认。如不通,报修或更换整机。

Q:如何排查NFC不能正常工作?

A:进入设置界面,看NFC 的设置开关是否可以正常打开、关闭。要确认NFC设置为“打开”状态。合作方对NFC的监听应用需要独立于机具的收银应用工作,NFC的开发采用标准的android NFC开发原理。

Q:机器长时间运行状况,是否连续数天处于不关机状态?

A:如无人为关机行为,建议客户设置定时开关机,连续数天不关机可能造成机器长时间老化导致卡顿,延迟,寿命缩短等问题。

Q:机器开机默认霸屏模式,如何退出霸屏模式

A:同时按下键盘上 “功能”+“+”+“设置”即可退出霸屏模式。

Q:键盘外置的情况下,安装建议?

A:键盘外置时,需要连接延长线,建议在接头位置包裹绝缘胶带以起到放松防水作用。

Q:键盘套使用

A: 我们的键盘具有IP55级别防尘放水,并使用的防油污材料。但是由于食堂环境油污严重,环境复杂,后期我们将随设备配套键盘保护套,请在安装时同步装上键盘保护套。防止油污进入键盘,影响键盘使用。

Q:频繁刷脸运行后,设备卡顿,设备反应慢,频繁发生。

A:有以下两种可能原因,需要客户自查。

1,可能原因:线程操作有问题,频繁调用smile 导致smile 发生ANR,客户的APP 一直在等待,导致界面卡死,出现白屏、黑屏。建议客户不要在主线程有过多的耗时操作,后续客户修改逻辑正常。

2、可能原因2 :APP 也是频繁操作,导致资源没有来得及释放,出现内存泄漏导致机器卡顿,重启APP正常,建议客户:适当优化释放时间,后正常。

Q:副屏显示设置建议。

A:建议副屏显示设置的文字越大越好,对比度越大越好,利于食堂阿姨能够更清晰的看到消费金额。

Q:排插选型

A:由于我们使用的是插墙式的适配器,适配器本体比较宽,所以建议客户选宽间距的排插。窄间距的排插利用率较低。适配器宽度尺寸为51*51mm。

Q:键盘不响应。

A:偶然出现,建议重新插拔键盘或者重启设备。

   出现概率比较高的情况,如何排查键盘不响应

1、确认是否延长线断裂不通,可以将键盘不用延长线插入机器尝试确认。

2、不用延长线直接插入键盘,可以进入CIT模式做单体测试(在海马应用列表界面点击CIT图标),确认键盘是否不良。

3、更换键盘再确定机器USB是否通路,用U盘或鼠标测试确认。如不通,报修或更换整机。

Q:设备用有线网络的话,对网线种类有要求吗?用无线网路的话,对无线路由器有要求吗?

A:设备需要稳定的网络,要求采用国标超五类及以上的网线或者企业级无线路由器。

Q:设备的安装方式

A:设备配有标准滑入式挂架,可以吊装,左装,右装,贴合玻璃,配合桌面支架安装(桌面支架需要单独购买)。安装方式详情请参考开发指南的安装指引。

Q:设备安装高度是多少?

A:根据设备安装点位最大程度贴近学校平均身高即可。

   参照平均身高选择安装高度(摄像头距地面的距离)。

高度角度身高范围(距离60cm) 
1400125(最低)175(最高)
1500135(最低)185(最高)
1600145(最低)195(最高)

假设安装高度160cm的话, 覆盖145~195cm 身高人群。如果是上下垂直调整的话, 就直接相减即可。比如安装高度下降30cm至 130cm的位置, 则覆盖身高变为115~165cm。如果离得更近,那身高范围会缩小一些。以上是理论计算, 实际测试会比这个范围大。

Q:摄像头无法识别人脸。

A:在FT1 MINI应用列表界面,点击”MarioSdk“图标进入摄像头工厂模式界面,再点击”D2C测试“按钮,查看摄像头预览界面是否正常。如果有类似马赛克的界面则初步判断正常(参考图如下),如显示正常,请在联网状态下打开smilepay软件,选项—正式环境—刷脸,如刷脸正常,即可判定摄像头为正常。需要从软件方向寻找问题原因。

如以上检查无法正常刷脸或者深度读取不正常,可判定摄像头不良,需走售后流程安排维修或者换机。

Q:如何进行设备单项功能测试

A:设备应用界面—点 CIT—选择  单项测试—进行判断可能问题的单项测试。