# 系统设计要求 变更日志 版本 日期 变更 v0.1 20180703 创建文档

v0.2 20180703 增加了证书交付，明确安装APP后无需打开APP

v0.3 20180704 不在白名单的APP处理方式，增加厂商型号代码

v0.4 20180704 厂商序列号、随机数增加关于重复性的要求

v0.5 20180704 重复性要求描述改进

v0.6 20180709 增加Linux系统，增加厂商和机型

v0.7 20180717 1. 默认静默打开，额外增加不静默打开配置

2. 额外增加静默安装异常的日志记录

3. 增加序列号原则，获取方式

v0.8 20180726 增加厂商和机具

v0.9 20180726 增加厂商和机具

v0.10 20180816 增加本文档适用于微信支付订制机具的描述

v0.11 20180816 增加厂商和机具

v0.12 20180817 增加厂商和机具

v0.13 20180821 增加内置APP需求

v0.14 20180822 增加系统要求

# 系统版本

# Android

android v7.1以上，平板版本。

# Windows

Windows 7以上，支持32位和64位系统

# 系统要求

# Windows 序列号路径C:\serial.txt要求可读

WxpayFaceService运行需要管理员权限

# 预装APP

设备需要预装最新稳定版刷脸支付SDK

预装要求： 重置系统之后需要保留

# 设备序列号 (All)

设备序列号，用于唯一标识一台设备。生成设备序列号时， 需要确保全局唯一性。

需要满足以下四个要求：

1. 序列号在应用里面可以获取

2. 序列号重装系统后不会变更

3. 序列号更换主板后可以写入

4. 序列号永远和机器后面铭牌上面贴的编号一致

# 序列号生成规则 注: 设备商必须保证设备SN符合微信制定要求, 否则由于SN规则不符导致的设备使用, 数据统计等问题, 设备商自行负责解决。

构成规则：

# Android:

设备商代码(2位) + 系统类型(1位) + 型号代码(2位) + 厂商序列号(10位) + 随机数(8位) 字段名 长度 内容/格式 字符取值范围 设备商代码 2 由微信支付为厂商分配 0-9, A-Z

系统类型 1 A: 表示Android, W: 表示Windows, L表示Linux 0-9, A-Z

型号代码 2 由厂商提供设备型号给微信支付, 微信支付分配型号代码给厂商 0-9, A-Z

厂商序列号 10 格式内容由厂商按自家现有规则来确定。

序列号需要全局唯一，同厂商的任意两台机器的序列号不可重复。 0-9, A-Z

随机数 8 随机数每一位在0-9, A-Z中取值。需要保证随机性，对随机数的唯一性可以不作强校验。

(注意随机数生成时，先初始化) 0-9, A-Z

# Windows: 字段名 长度 内容/格式 字符取值范围 设备商代码 2 由微信支付为厂商分配 0-9, A-Z

系统类型 1 A: 表示Android, W: 表示Windows, L表示Linux 0-9, A-Z

型号代码 2 由厂商提供设备型号给微信支付, 微信支付分配型号代码给厂商 0-9, A-Z

厂商序列号 12 使用网卡MAC地址 0-9, A-Z

随机数 6 随机数每一位在0-9, A-Z中取值。需要保证随机性，对随机数的唯一性可以不作强校验。

(注意随机数生成时，先初始化) 0-9, A-Z

# 微信读取序列号的方法

# Android

Android 8 开始声明， Build.SERIAL获取SN方式将被废弃，将使用Build.getSerial()。

Android 9 已经正式废弃原方式

# Windows

从c:\serial.txt中读取。

在安装人脸SDK之前，需要先生成这个文件。

# APP的静默升级 (Android)

由厂商ROM制定实现，让 com.tencent.wxpayface 升级时不弹窗提示。

# 异常处理

对于安装失败的情况，需要把安装异常记录在指定位置的文件里。

# 异常日志目录

Environment.getExternalStorageDirectory().getAbsolutePath() + "/wxpayface/install_log/"

# 异常日志文件名

包名.log

例如

com.tencent.wxpayface.log

# 异常日志记录格式 只需要一行，每次覆盖

数据格式：

时间戳,包名,当前版本,新安装版本,错误码

例如

1531821994,com.tencent.wxpayface,1.0.9,1.1.0,-18

# Android 人脸APK 系统预置方法

前两项测试通过后，下载刷脸SDK进行功能自测。

# 微信支付人脸APK预置说明：

1.把apk更名为wxfacepay.apk

2.新建wxfacepay目录，把wxfacepay.apk放进该目录

3.用zip工具打开wxfacepay.apk, 把里边的lib拉出来放在wxfacepay目录下，把lib目录下的armeabi-v7a目录改为arm

4.将wxfacepay目录预置到/system/priv-app/目录下。

5.最终目录结构如下：

/system/priv-app/wxfacepay目录下有一个wxfacepay.apk

/system/priv-app/wxfacepay/lib/arm目录下有wxfacepay自带的so库

注意：内置后可能存在selinux问题，需要进行功能测试