刷脸设备海马S1(FT1 MINI)开发指南

更新时间:2020/12/22 访问次数:11820
版本历史

版本号

修改内容

日期

V2.1

设备签约

2020/09/02

V2.0

增加小程序支持

2020/07/15

 

文档阅读对象

适合于有团餐场景开发能力的ISV

1. 产品介绍

1.1 适合场景

适用于校园、园区、社区、企事业单位的食堂和餐厅的消费支付。提供商户一款集刷脸、扫码、刷卡一体的智能收银受理设备,ISV可以在这款设备上进行二次开发,满足商户的个性化结算需求。

针对食堂档口复杂环境设计,支持档口的多种安装方式。采用键盘分离设计方式,采用防油污材和防火阻燃材料设计,支持IP55防水和V0防火等级,机具易于清洁保护。海马S1产品及规格介绍,请查阅

1.2 开发步骤


申请邻客蚁权限:

联系支付宝业务BD或技术支持同学申请开通,需提供要访问邻客蚁平台人员的邮箱账号。在支付宝审批通过后,申请人员会在提交的邮箱里面收到注册邀请邮件,申请人员点击确认后就可以在邻客蚁平台上看到相关的邻客蚁项目。

申请参考DEMO:

在申请到邻客蚁平台权限后,如果开发需要刷脸和扫码的demo进行参考,请联系支付宝技术支持同学。

1.3 硬件版本

硬件有4G版和WIFI版两种。为区分行业场景,机具所适用的场景由支付宝分配的物料id进行区分,合作伙伴在采购时根据自身所需采购合适的版本。不同的物料id,不能在行业间错用、乱用。

  • K12版本(用于中小学场景)

名称:商米FT1 mini团餐设备         物料id(Item ID):2019071603138886     供应商id(Supplier ID):2018041600054976

 

  • 高校团餐版本(用于高校和企业场景)

名称:商米FT1 mini高校团餐设备   物料id(Item ID):2019091904075657      供应商id(Supplier ID):2018041600054976

1.4 硬件架构

设备支持3个接口:RJ45网口、USB2.0*2。同时支持Micro USB和PSAM卡槽。          说明:Micro USB接口使用时不能和RJ45网口/USB口同时使用。

具体接口定义和位置说明,请见文档

1.5 软件架构

设备出厂ROM预置有刷脸smile apk、IOT Sdk、小程序容器xpass。合作方在拿到设备后,即可进行方案的对接和产品开发,开发属于自己的收银应用,实现刷脸支付。

合作方可选择的开发技术:
  • 如果用于封闭人脸场景识别,支持android native应用开发;
  • 如果用于非封闭人脸场景识别,支持android native应用开发,也支持支付宝小程序应用开发;

     

2. 设备签约

为了保证设备推送应用内容的准确性,需要ISV服务商在设备管理平台上完成签约操作后,服务商才能提出申请或自主完成应用的分发及运营操作。具体操作流程:

第一步:渠道或服务商购买设备后,通知厂商完成设备出货进件。

渠道或服务商需提供支付宝pid给到厂商(商米),厂商在进件平台完成设备出货进件后,ISV服务商(用设备进件账号的pid登录)在商家智能设备平台(具体路径:服务商平台 -> 运营中心 -> 经营工具 -> 商家智能设备)上能够看到该账号下已完成进件的设备列表,同时每台设备的角色里面能看到”申请者“。如果没有申请者角色,意味着这台设备最初的购买是别的合作方。

注意:平台在厂商进件审批完成后上T+1显示所进件的设备清单。


第二步:设备申请者完成初始化签约,获取设备的”所有者“角色,完成设备的归属。

渠道、服务商或商家是申请者的话,可以在设备管理平台(具体路径:服务商平台 -> 运营中心 -> 经营工具 -> 商家智能设备)上对设备进行初始化签约,获取设备的”所有者“角色。具备”所有者“角色的渠道、服务商或商家有设备的应用分发及设备的运营权。具体:在每台设备对应的操作一栏选择”签约“按钮。

注意:一个进件单下的某一台设备sn签约会自动触发这个单子下的其余设备签约,自动签约会有同步时间,请间隔一段时间刷新查看其它设备的签约情况。如果在未完成自动签约前手动点击签约,平台会报“签约冲突”错误。


如果设备已经签约,设备的”所有者“可以转给其它的合作方。具体:

- 转移方在设备管理页面,点击下方的”批量转签约“按钮,在设备列表页面选择需要转签的设备,选择好后输入接收方的支付宝账号。

- 接收方在设备管理页面,查看被转移进来的设备。

3. 安装部署

3.1 安装部署关键事项

  • 设备注册激活必需要有访问外网的IP网络。对于需要设置网络白名单的,请见域名清单
  • 注册激活的设备关机后,再开机务必保证设备有网络物理连接。
  • 设备关机后,务必确保24小时内有网络能够连接外网。
  • 避免强光干扰,影响识别效果。
  • 地面布置“识别最佳点位”指引线。 

3.2 安装部署方式

五种安装方式:左侧挂式安装、顶部挂式安装、右侧挂式安装、玻璃挂式安装、台式支架安装。台式支架需要向商米另行采购。具体安装方案,请见文档

3.3 机具安装高度

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

高度

角度

身高范围(距离60cm)

140

0

125(最低)

175(最高)

150

0

135(最低)

185(最高)

160

0

145(最低)

195(最高)

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

4. 售后维保

设备出现故障,可以扫描机身的售后统一维保码进行报修,根据商米的售后维保政策享受售后服务。

维保码示例:

5. 机具系统升级

为保障支付的稳定和延续性,在系统检测到有新的版本可升级时,需要现场工作人员手动点击更新。如果需要支付宝强制系统升级,请联系对应的BD。

5.1 版本历史

系统ROM版本的更新,请见海马重要公告。 

5.2 升级方法

5.2.1 查看固件版本号&升级信息

『设置』-『系统』-『关于设备』-『系统升级』

5.2.2 版本号说明

当前版本:即当前系统的版本号信息

升级版本:即将被升级的版本号信息;

5.2.3 升级操作说明

  1. 如有版本更新,在『系统升级』菜单项会提示,『升级版本』;
  2. 点击后进入到『系统升级』弹出框界面,『升级版本』信息会有如下提示:
  • 『暂无可用版本』:表示无更新;
  • 『xxxxx 下载中..』:表示正在下载升级包,先退出系统设置,过5分钟后再查看相关信息;
  • 『xxxxx』:表示版本已下载完成,同时右下角会出现『确认』按钮,如点击『确认』,则再20秒后重启并直接进行升级;否则,不进行任何升级操作。

上面的xxxxx表示升级版本号,格式一般为1.2.0.201910229153_RS

6. 设备adb调试

为确保上线设备的系统安全,adb接口的使用按照最小访问原则开放,如果需要用到调试功能,需要权限申请。注意:账号仅限于申请公司内部开发使用,不可泄露。发现相关风险,账号将会被封禁。

6.1 申请流程

申请账号参考【ADB账号申请】文档。

6.2 使用及下载

参考【ADB使用说明】

6.3 FAQ

参考【adb云控使用FAQ】

 

- adb devices 没有显示设备
  • 在『设置』-『系统』-『关于设备』-『版本号』,连续点击进入『开发者模式』;
  • 返回到『系统』,进入『开发者选项』,并『开启』此选项;
  • 滑动到『调试』,点击开启『USB调试』;
  • 然后在pc上输入 adb devices ,机具系统会弹出授权框,点击授权;

- 其它未知问题

    在PC的 .android 目录中找到 logfile.txt 文件,单独发给 @伊索 suhao.s@antfin.com进行排查;

7. 支付应用开发

设备支持刷脸、扫码和刷卡三种身份识别介质,身份识别出来后,由ISV根据自己的收银、结算的业务逻辑完成收银的端到服务侧开发。扫码和刷脸复用摄像头,刷脸和扫码是互斥行为。在收银结算支付环节,建议UI默认处于扫码支付,刷脸支付由用户或收银人员点击启动进入刷脸。

 

刷脸支付支持两种模式:封闭场景人脸识别和在线人脸识别两种方案。根据场景的不同,有针对性的方案可供接入: 

方案名称 UI交互视效(建议) Native应用开发技术 小程序应用开发技术 说明
K12行业封闭场景方案 参考
基于Android Native开发指南


不支持
高校行业本地比对在线付场景方案 参考 基于小程序开发指南 与企业团餐在线方案类似,可以参考企业团餐在线场景方案
企业团餐本地比对在线付场景方案 参考 基于小程序开发指南 目前企业团餐无行业归属,需要isv服务商自行开发接入
云支付版 N/A N/A 云支付版应用,免开发

8. IOT设备绑定

设备IOT注册、绑定具体接口及使用说明,请见链接

因所属行业对设备的绑定不同,如需对接iot设备绑定需要接口权限申请,具体流程:

合作方向业务BD提出申请,业务BD邮件发送到iot_campus@service.alipay.com。邮件内容需包括:ISV名称、ISV PID、ISV APPID、业务合作背景

 

为方便合作伙伴快速调试,如果合作方没有正式的学校不能够创建门店,可以在联调阶段使用如下测试门店ID:

- K12:

   商户PID:2088211521646673

   测试门店id(shop_id):2020011400077000000086853157

   测试门店名称:第一中学一餐厅

- 团餐:

   商户PID:2088211521646673

   测试门店id(shop_id):2020011500077000000086876078

   测试门店名称:浙大第一餐厅

9. 常见问题和帮助

常见问题和帮助,点击链接

FAQ

关于此文档暂时还没有FAQ
返回
顶部