小米开发平台屏幕指纹设备适配说明-APP开发

1. 什么是屏下指纹

小米 8 透明探索版中，我们引入屏下指纹这项新技术，即指纹传感器嵌入屏幕下。

由于是屏下指纹，所以需要出现指纹图标，提示用户指纹传感器的位置，但这样会和部分需要使用指纹验证的业务产生冲突。

2. 屏下指纹相关接口

由于各个开发者的指纹验证逻辑和 UI 样式非常不一样，所以系统不打算统一大家的样式，而是会提供相关接口，由各业务组做针对性地适配。

2.1. 是否为屏下指纹设备

// true means FOD project
PRODUCT_PROPERTY_OVERRIDES += ro.hardware.fp.fod=true

2.2. 指纹传感器的位置、大小（每次指纹验证都需要重新获取）

以下是 Android O 的接口：

//location of FOD sensor's top left corner in pixel, the top left corner of screen is (0,0)
//persist.sys.fp.fod.location.X_Y 表示sensor区域左上角的坐标，以pixel为单位，以物理屏幕左上角为（0,0）计算。
persist.sys.fp.fod.location.X_Y = 453,1640

//sensor的大小（单位也是pixel）
persist.sys.fp.fod.size.width_height = 173,173

以下是 Android P 的接口（应谷歌要求，需要加入「vendor」字样）

//location of FOD sensor's top left corner in pixel, the top left corner of screen is (0,0)
// persist.vendor.sys.fp.fod.location.X_Y 表示sensor区域左上角的坐标，以pixel为单位，以物理屏幕左上角为（0,0）计算。
persist.vendor.sys.fp.fod.location.X_Y = 453,1640

//sensor的大小（单位也是pixel）
persist.vendor.sys.fp.fod.size.width_height = 173,173

因为同一款设备，市场上可能会同时存在 Android O 和 Android P 两个版本，所以开发者需要根据 Android 版本调用不同的接口，以获取正确的位置信息。

2.3. 控制指纹图标显示、消失

调用标准的指纹监听接口即可显示指纹图标。

2.4. 指定指纹图标的颜色（黑色或白色）

由于各个业务组的界面不尽相同，我们会提供一个接口，让业务方指定要用「黑色」还是「白色」的指纹图标。

复用原有 flag 中的「0」「1」标志（原flag标志没有使用），0表示黑色，1表示白色。

mFm.authenticate(null, mCancellationSignal, 0, callback, null); // 黑色指纹图标（默认）
mFm.authenticate(null, mCancellationSignal, 1, callback, null); // 白色指纹图标