Android平台6.0及以上系统支持,仅适配Google官方指纹识别的标准接口的设备。

方法:

  • isSupport: 当前设备环境是否支持指纹识别
  • isKeyguardSecure: 当前设备是否设置密码锁屏
  • isEnrolledFingerprints: 当前设备是否已经录入指纹
  • authenticate: 指纹识别认证
  • cancel: 取消指纹识别认证

对象:

  • AuthenticateOptions: JSON对象,指纹识别认证参数
  • FingerprintError: JSON对象,指纹识别错误信息

回调方法:

  • FingerprintSuccessCallback: 指纹识别认证成功回调函数
  • FingerprintErrorCallback: 指纹识别认证失败的回调函数

权限:

5+功能模块(permissions)

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#ffffff">{</span>
<span style="color:#87ceeb">// ...</span>
<span style="color:#ffa0a0">"permissions"</span><span style="color:#ffffff">:{</span><span style="color:#87ceeb">// ...</span><span style="color:#ffa0a0">"Fingerprint"</span><span style="color:#ffffff">:</span> <span style="color:#ffffff">{</span><span style="color:#ffa0a0">"description"</span><span style="color:#ffffff">:</span> <span style="color:#ffa0a0">"指纹识别"</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span></code></span></span>

isSupport

当前设备环境是否支持指纹识别

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>boolean</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isSupport</span><span style="color:#ffffff">();</span></code></span></span>

说明:

目前还有很多设备没有指纹识别模块,需要调用此方法判断是否可使用指纹识别功能。

参数:

返回值:

Boolean : 设备支持指纹识别则返回true,否则返回false。

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 判断设备是否支持指纹识别</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getElementById</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'result'</span><span style="color:#ffffff">).</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isSupport</span><span style="color:#ffffff">()?</span><span style="color:#ffa0a0">'支持'</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'不支持'</span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span> <span style="color:#ffffff">{</span><span style="color:#ffffff">console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"请更新版本"</span><span style="color:#ffffff">);</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">当前设备环境是否支持指纹识别:</span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><p</strong></span> <span style="color:#bdb76b"><strong>id</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"result"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">...</span><span style="color:#f0e68c"><strong></p></strong></span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

isKeyguardSecure

当前设备是否设置密码锁屏

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>boolean</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isKeyguardSecure</span><span style="color:#ffffff">();</span></code></span></span>

说明:

如果设备没有设置密码锁屏,则无法使用指纹识别功能,建议调用指纹识别前先使用此接口检查。 调用plus.fingerprint.authenticate会返回失败。

参数:

返回值:

Boolean : 设备已设置密码锁屏则返回true,否则返回false。

平台支持:

  • Android (支持) :

    要求设置密码锁屏才可以使用指纹识别,如果没有设置密码锁屏应该提示用户进行设置。

  • iOS (不支持) :

    不支持此功能,返回true。

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 判断设备是否设置密码锁屏</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getElementById</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'result'</span><span style="color:#ffffff">).</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isKeyguardSecure</span><span style="color:#ffffff">()?</span><span style="color:#ffa0a0">'是'</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'否'</span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span> <span style="color:#ffffff">{</span><span style="color:#ffffff">console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"请更新版本"</span><span style="color:#ffffff">);</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">当前设备是否设置密码锁屏:</span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><p</strong></span> <span style="color:#bdb76b"><strong>id</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"result"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">...</span><span style="color:#f0e68c"><strong></p></strong></span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

isEnrolledFingerprints

当前设备是否已经录入指纹

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>boolean</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isEnrolledFingerprints</span><span style="color:#ffffff">();</span></code></span></span>

说明:

如果设备没有录入指纹,则无法使用指纹识别功能,建议调用指纹识别前先使用此接口检查。 调用plus.fingerprint.authenticate会返回失败。

参数:

返回值:

Boolean : 设备已经录入指纹则返回true,否则返回false。

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 判断设备是否已经录入指纹</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getElementById</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'result'</span><span style="color:#ffffff">).</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isEnrolledFingerprints</span><span style="color:#ffffff">()?</span><span style="color:#ffa0a0">'是'</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'否'</span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span> <span style="color:#ffffff">{</span><span style="color:#ffffff">console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"请更新版本"</span><span style="color:#ffffff">);</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">当前设备是否已经录入指纹:</span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><p</strong></span> <span style="color:#bdb76b"><strong>id</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"result"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">...</span><span style="color:#f0e68c"><strong></p></strong></span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

authenticate

指纹识别认证

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#ffffff">successCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> errorCB</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> options</span><span style="color:#ffffff">);</span></code></span></span>

说明:

用户可以开始输入指纹进行识别,如果认证成功则触发successCB回调,识别失败则触发errorCB回调返回错误信息。

参数:

  • successCB: ( FingerprintSuccessCallback ) 必选 识别认证成功回调

    指纹识别操作认证成功时调用。

  • errorCB: ( FingerprintErrorCallback ) 必选

    指纹识别操作认证失败时调用,每次指纹识别错误都会触发一次错误回调。

  • options: ( AuthenticateOptions ) 可选 识别认证参数

    用于设置指纹识别界面显示的提示信息等。

返回值:

void : 无

平台支持:

  • Android (支持) :

    指纹识别过程中不会弹出任何界面,需要开发者根据业务需求弹出提示信息。

  • iOS (支持) :

    指纹识别过程中会弹出系统界面。

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> result </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">getElementById</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'result'</span><span style="color:#ffffff">);</span><span style="color:#87ceeb">// 检查是否支持指纹识别</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(!</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isSupport</span><span style="color:#ffffff">())</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">result</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">'此设备不支持指纹识别'</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>return</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(!</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isKeyguardSecure</span><span style="color:#ffffff">())</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">result</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">'此设备未设置密码锁屏,无法使用指纹识别'</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>return</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(!</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">isEnrolledFingerprints</span><span style="color:#ffffff">())</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">result</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">'此设备未录入指纹,请到设置中开启'</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>return</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#ffffff">result</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">'此设备支持指纹识别'</span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong>else</strong></span> <span style="color:#ffffff">{</span><span style="color:#ffffff">result</span><span style="color:#ffffff">.</span><span style="color:#ffffff">innerText </span><span style="color:#ffffff">=</span> <span style="color:#ffa0a0">'当前环境不支持指纹识别API,请更新到最新版本'</span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#87ceeb">// 指纹识别认证 </span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> fingerpring</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> waiting </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">closeWaiting</span><span style="color:#ffffff">();</span><span style="color:#87ceeb">//兼容Android平台关闭等待框</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别成功'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#f0e68c"><strong>switch</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>case</strong></span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">AUTHENTICATE_MISMATCH</span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">toast</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹匹配失败,请重新输入'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>case</strong></span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">AUTHENTICATE_OVERLIMIT</span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">closeWaiting</span><span style="color:#ffffff">();</span><span style="color:#87ceeb">//兼容Android平台关闭等待框</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败次数超出限制,请使用其它方式进行认证'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>default</strong></span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">closeWaiting</span><span style="color:#ffffff">();</span><span style="color:#87ceeb">//兼容Android平台关闭等待框</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败('</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">+</span><span style="color:#ffa0a0">'),请重试'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#ffffff">});</span><span style="color:#87ceeb">// Android平台弹出等待提示框 </span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'Android'</span><span style="color:#ffffff">==</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">showWaiting</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别中...'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">指纹识别认证:</span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><p</strong></span> <span style="color:#bdb76b"><strong>id</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"result"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">...</span><span style="color:#f0e68c"><strong></p></strong></span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">fingerpring</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">指纹识别</span><span style="color:#f0e68c"><strong></button></strong></span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

cancel

取消指纹识别认证

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">cancel</span><span style="color:#ffffff">();</span></code></span></span>

说明:

取消当前正在处理的指纹识别认证操作。 如果当前没有进行指纹识别则不进行任何操作;如果当前正在进行指纹识别则触发错误回调(错误码为“CANCEL”)。

参数:

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 自动调用指纹识别</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">toast</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别成功'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败('</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">+</span><span style="color:#ffa0a0">')'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">});</span><span style="color:#87ceeb">// iOS平台指纹识别提示框会阻塞界面操作,定时调用</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'iOS'</span><span style="color:#ffffff">==</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">setTimeout</span><span style="color:#ffffff">(</span><span style="color:#ffffff">cancelFingerpring</span><span style="color:#ffffff">,</span> <span style="color:#cd5c5c">10000</span><span style="color:#ffffff">);</span><span style="color:#ffffff">}</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#87ceeb">// 取消指纹识别</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> cancelFingerpring</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">cancel</span><span style="color:#ffffff">();</span>
<span style="color:#ffffff">}</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">取消指纹识别认证</span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#f0e68c"><strong><button</strong></span> <span style="color:#bdb76b"><strong>onclick</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"</span><span style="color:#ffffff">cancelFingerpring</span><span style="color:#ffffff">()</span><span style="color:#ffa0a0">"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">取消识别</span><span style="color:#f0e68c"><strong></button></strong></span><span style="color:#f0e68c"><strong><br/></strong></span><span style="color:#ffffff">注意:iOS平台10秒后自动取消</span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

AuthenticateOptions

JSON对象,指纹识别认证参数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>interface</strong></span> <span style="color:#98fb98">AuthenticateOptions</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">String</span><span style="color:#ffffff"> message</span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">}</span>         </code></span></span>

说明:

用于设置指纹识别认证界面显示的提示信息等。

属性:

  • message: (String 类型 )在指纹识别过程中显示在界面上的提示信息

    如果指纹识别认证过程中不显示提示框,则不显示此信息。

    平台支持

    • Android - (不支持) :

      指纹识别认证过程中不显示提示框,需要开发者自定义显示。

    • iOS - (支持) :

      指纹识别认证过程中显示系统提示框,在提示框中显示此信息(默认显示信息为空字符串)。

    <span style="background-color:#333333"><code>
    <span style="color:#cccccc"><!DOCTYPE html></span>
    <span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
    <span style="color:#87ceeb">// H5 plus事件处理</span>
    <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> waiting </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span><span style="color:#87ceeb">// 自动调用指纹识别</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">waiting</span><span style="color:#ffffff">&&(</span><span style="color:#ffffff">waiting</span><span style="color:#ffffff">.</span><span style="color:#ffffff">onclose</span><span style="color:#ffffff">=</span><span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">);</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">closeWaiting</span><span style="color:#ffffff">();</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别成功'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">AUTHENTICATE_MISMATCH </span><span style="color:#ffffff">==</span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">){</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">toast</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹匹配失败,请重新输入'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>return</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#ffffff">waiting</span><span style="color:#ffffff">&&(</span><span style="color:#ffffff">waiting</span><span style="color:#ffffff">.</span><span style="color:#ffffff">onclose</span><span style="color:#ffffff">=</span><span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">);</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">closeWaiting</span><span style="color:#ffffff">();</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败('</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">+</span><span style="color:#ffa0a0">')'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},{</span><span style="color:#ffffff">message</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'通过Home键验证已有手机指纹'</span><span style="color:#ffffff">});</span><span style="color:#87ceeb">// Android平台使用自定义等待框显示 </span><span style="color:#f0e68c"><strong>if</strong></span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">"Android"</span><span style="color:#ffffff">==</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">os</span><span style="color:#ffffff">.</span><span style="color:#ffffff">name</span><span style="color:#ffffff">){</span><span style="color:#ffffff">waiting </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">showWaiting</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'验证已有手机指纹'</span><span style="color:#ffffff">,{</span><span style="color:#ffffff">width</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'196px'</span><span style="color:#ffffff">,</span><span style="color:#ffffff">height</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'196px'</span><span style="color:#ffffff">,</span><span style="color:#ffffff">padding</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'16px'</span><span style="color:#ffffff">,</span><span style="color:#ffffff">loading</span><span style="color:#ffffff">:{</span><span style="color:#ffffff">height</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'96px'</span><span style="color:#ffffff">,</span><span style="color:#ffffff">icon</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'fp.png'</span><span style="color:#ffffff">},</span><span style="color:#ffffff">background</span><span style="color:#ffffff">:</span><span style="color:#ffa0a0">'rgba(0,0,0,0.3)'</span><span style="color:#ffffff">});</span><span style="color:#ffffff">waiting</span><span style="color:#ffffff">.</span><span style="color:#ffffff">onclose </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">waiting </span><span style="color:#ffffff">=</span> <span style="color:#f0e68c"><strong>null</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">cancel</span><span style="color:#ffffff">();</span><span style="color:#ffffff">}</span><span style="color:#ffffff">}</span>
    <span style="color:#ffffff">}</span><span style="color:#ffffff">
    document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">指纹识别认证</span><span style="color:#f0e68c"><strong></body></strong></span>
    <span style="color:#f0e68c"><strong></html></strong></span></code></span>

FingerprintError

JSON对象,指纹识别错误信息

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>interface</strong></span> <span style="color:#98fb98">FingerprintError</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> UNSUPPORT </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">1</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> KEYGUARD_INSECURE </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">2</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> FINGERPRINT_UNENROLLED </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">3</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> AUTHENTICATE_MISMATCH </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">4</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> AUTHENTICATE_OVERLIMIT </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">5</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> CANCEL </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">6</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>const</strong></span> <span style="color:#98fb98">Number</span><span style="color:#ffffff"> UNKNOWN_ERROR </span><span style="color:#ffffff">=</span> <span style="color:#cd5c5c">7</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">Number</span><span style="color:#ffffff"> code</span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>readonly</strong></span><span style="color:#ffffff"> attribute </span><span style="color:#98fb98">String</span><span style="color:#ffffff"> message</span><span style="color:#ffffff">;</span>
<span style="color:#ffffff">}</span>         </code></span></span>

常量:

  • UNSUPPORT: (Number 类型 )不支持指纹识别

    当前设备不支持指纹识别功能时返回此错误,错误代码常量值为1。

  • KEYGUARD_INSECURE: (Number 类型 )设备未设置密码锁屏

    当前设备为设置密码锁屏导致无法使用指纹识别功能时返回此错误,错误代码常量值为2。

  • FINGERPRINT_UNENROLLED: (Number 类型 )未录入指纹识别

    当前设备未录入指纹导致无法使用指纹识别功能时返回此错误,错误代码常量值为3。

  • AUTHENTICATE_MISMATCH: (Number 类型 )指纹识别不匹配

    用户指纹识别认证不通过时返回此错误,错误代码常量值为4。 用户每次尝试指纹识别认证未通过都会触发此错误,此时还可以继续识别认证。

  • AUTHENTICATE_OVERLIMIT: (Number 类型 )指纹识别次数超过限制

    用户多次指纹识别认证不通过时返回此错误,错误代码常量值为5。 通常出现此错误后系统会锁定一段时间禁止使用指纹识别,如果再次调用指纹识别认证会立即返回此错误,因此出现此错误时应该提示用户使用其它方式进行认证。

  • CANCEL: (Number 类型 )取消指纹识别

    用户取消指纹识别认证时返回此错误,错误代码常量值为6。

  • UNKNOWN_ERROR: (Number 类型 )未知错误

    其它未知错误,错误代码常量值为7。

属性:

  • code: (Number 类型 )错误代码

    取值范围为FingerprintError对象的错误常量值。

  • message: (String 类型 )错误描述信息

    详细错误描述信息。

FingerprintSuccessCallback

指纹识别认证成功回调函数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onSuccess</span><span style="color:#ffffff">()</span> <span style="color:#ffffff">{</span><span style="color:#87ceeb">// Authenticate success code.</span>
<span style="color:#ffffff">}</span></code></span></span>

参数:

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 自动调用指纹识别</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别成功'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#ffffff">console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败('</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">+</span><span style="color:#ffa0a0">')'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">});</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">指纹识别认证</span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

uni-app使用plus注意事项

FingerprintErrorCallback

指纹识别认证失败的回调函数

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#f0e68c"><strong>function</strong></span> <span style="color:#f0e68c"><strong>void</strong></span><span style="color:#ffffff"> onError</span><span style="color:#ffffff">(</span><span style="color:#98fb98">FingerprintError</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#87ceeb">// Handle error</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> code </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">;</span> <span style="color:#87ceeb">// 错误编码</span><span style="color:#f0e68c"><strong>var</strong></span><span style="color:#ffffff"> message </span><span style="color:#ffffff">=</span><span style="color:#ffffff"> error</span><span style="color:#ffffff">.</span><span style="color:#ffffff">message</span><span style="color:#ffffff">;</span> <span style="color:#87ceeb">// 错误描述信息</span>
<span style="color:#ffffff">}</span></code></span></span>

参数:

  • error: ( FingerprintError ) 必选 获取加速度操作的错误信息

    可通过error.code(Number类型)获取错误编码; 可通过error.message(String类型)获取错误描述信息。

返回值:

void : 无

示例:

<span style="background-color:#333333"><span style="color:#474747"><code>
<span style="color:#cccccc"><!DOCTYPE html></span>
<span style="color:#f0e68c"><strong><html></strong></span><span style="color:#f0e68c"><strong><head></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>charset</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"utf-8"</span><span style="color:#f0e68c"><strong>></strong></span><span style="color:#f0e68c"><strong><meta</strong></span> <span style="color:#bdb76b"><strong>name</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"viewport"</span> <span style="color:#bdb76b"><strong>content</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"width=device-width,initial-scale=1.0,maximum-scale=1.0,user-scalable=no"</span><span style="color:#f0e68c"><strong>/></strong></span><span style="color:#f0e68c"><strong><title></strong></span><span style="color:#ffffff">Fingerprint Example</span><span style="color:#f0e68c"><strong></title></strong></span><span style="color:#f0e68c"><strong><script</strong></span> <span style="color:#bdb76b"><strong>type</strong></span><span style="color:#ffffff">=</span><span style="color:#ffa0a0">"text/javascript"</span><span style="color:#f0e68c"><strong>></strong></span>
<span style="color:#87ceeb">// H5 plus事件处理</span>
<span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">(){</span><span style="color:#87ceeb">// 自动调用指纹识别</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">fingerprint</span><span style="color:#ffffff">.</span><span style="color:#ffffff">authenticate</span><span style="color:#ffffff">(</span><span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(){</span><span style="color:#ffffff">console</span><span style="color:#ffffff">.</span><span style="color:#ffffff">log</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别成功'</span><span style="color:#ffffff">);</span><span style="color:#ffffff">},</span> <span style="color:#f0e68c"><strong>function</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">){</span><span style="color:#f0e68c"><strong>switch</strong></span><span style="color:#ffffff">(</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">)</span> <span style="color:#ffffff">{</span><span style="color:#f0e68c"><strong>case</strong></span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">AUTHENTICATE_MISMATCH</span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹匹配失败,请重新输入'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>case</strong></span><span style="color:#ffffff"> e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">AUTHENTICATE_OVERLIMIT</span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败次数超出限制,请使用其它方式进行认证'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#f0e68c"><strong>default</strong></span><span style="color:#ffffff">:</span><span style="color:#ffffff">plus</span><span style="color:#ffffff">.</span><span style="color:#ffffff">nativeUI</span><span style="color:#ffffff">.</span><span style="color:#ffffff">alert</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'指纹识别失败('</span><span style="color:#ffffff">+</span><span style="color:#ffffff">e</span><span style="color:#ffffff">.</span><span style="color:#ffffff">code</span><span style="color:#ffffff">+</span><span style="color:#ffa0a0">'),请重试'</span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong>break</strong></span><span style="color:#ffffff">;</span><span style="color:#ffffff">}</span><span style="color:#ffffff">});</span>
<span style="color:#ffffff">}</span><span style="color:#ffffff">
document</span><span style="color:#ffffff">.</span><span style="color:#ffffff">addEventListener</span><span style="color:#ffffff">(</span><span style="color:#ffa0a0">'plusready'</span><span style="color:#ffffff">,</span><span style="color:#ffffff"> plusReady</span><span style="color:#ffffff">,</span> <span style="color:#f0e68c"><strong>false</strong></span><span style="color:#ffffff">);</span><span style="color:#f0e68c"><strong></script></strong></span><span style="color:#f0e68c"><strong></head></strong></span><span style="color:#f0e68c"><strong><body</strong></span> <span style="color:#f0e68c"><strong>></strong></span><span style="color:#ffffff">指纹识别认证</span><span style="color:#f0e68c"><strong></body></strong></span>
<span style="color:#f0e68c"><strong></html></strong></span></code></span></span>

fingerprint模块管理指纹识别相关推荐

  1. FPC1011半导体电容式指纹识别模块

    产品介绍: MZ628半导体指纹模块是广州微正智能科技有限公司推出的稳定量产的产品. MZ628半导体指纹模块以高性能高速DSP处理器MZ628R3为核心,结合瑞典FPC1011传感器,在无需上位机参 ...

  2. MZ628光学指纹识别模块

    产品介绍 MZ628光学指纹模块是广州微正智能科技有限公司推出的稳定量产的产品. MZ628光学指纹模块以高性能高速DSP处理器MZ628R3为核心,结合光学指纹传感器,在无需上位机参与管理的情况下, ...

  3. vnr光学识别怎么打开_干货|指纹锁的指纹识别模块的前世今生,智能锁的指纹识别到底有多智能?...

    智能锁现在也有很多叫法:指纹锁.电子锁.可见指纹识别是智能锁的核心功能了,那我们今天来聊聊智能锁的指纹识别模块. 指纹识别的历史 指纹识别认证的流程 指纹识别技术的种类 指纹识别的历史 早在2000多 ...

  4. 通过指纹识别模块验证用户,解锁手机

    项目简介: 手机端编写屏保软件,利用蓝牙与蓝牙串口模块和指纹识别器组成的指纹采集.识别系统进行通信,从而获取用户指纹验证信息, 软件获取指纹识别器发送的验证结果,以决定是否允许用户解锁锁屏,进入手机主 ...

  5. Web简单快捷的指纹识别小工具_在线指纹识别平台设计

    Web 指纹识别 本文通过分析 Web 指纹的检测对象.检测方法.检测原理及常用工具,设计了一个简易的指纹搜集脚本来协助发现新指纹,并提取了多个开源指纹识别工具的规则库并进行了规则重组,开发了一个简单 ...

  6. 毕业设计 单片机指纹识别考勤系统 - 嵌入式 物联网

    文章目录 1 简介 2 指纹考勤的背景意义 3 课题目标 4 系统设计 4.1 硬件电路设计 4.1.1 单片机主控 4.1.2 LCD 显示屏 4.1.3 实时时钟 4.1.4 指纹识别模块 4.2 ...

  7. 了解ThinkPad指纹识别系统设置

    来源:天极笔记本   本文主要旨意介绍ThinkPad的Fingerprint Reader(指纹识别)软件的基本应用,多图以求清楚. 首次打开指纹识别软件,就看到了一个简洁的欢迎界面(如图一), 我 ...

  8. 单片机毕业设计 stm32指纹识别考勤系统

    文章目录 1 简介 2 指纹考勤的背景意义 3 课题目标 4 系统设计 4.1 硬件电路设计 4.1.1 单片机主控 4.1.2 LCD 显示屏 4.1.3 实时时钟 4.1.4 指纹识别模块 4.2 ...

  9. 基于ATMEGA32的指纹识别防盗门锁的设计

    0 前言 人体生物特征是人体所固有的生理特征与行为特征,如指纹.掌纹.面像.眼虹膜.视网膜.声音.签字.步态等.这些特征具有随身性,因而使用方便,不易遗忘或丢失:人体的生物特征与人体又是唯一绑定的,且 ...

  10. 单片机毕业设计 stm32指纹识别考勤系统 - 嵌入式 物联网

    文章目录 1 简介 2 指纹考勤的背景意义 3 课题目标 4 系统设计 4.1 硬件电路设计 4.1.1 单片机主控 4.1.2 LCD 显示屏 4.1.3 实时时钟 4.1.4 指纹识别模块 4.2 ...

最新文章

  1. IBM的医疗AI为何失败
  2. python应用中调用spark_在python中使用pyspark读写Hive数据操作
  3. python视频编辑过场动画_视频剪辑什么鬼?Python 带你高效创作短视频
  4. 小数转换成二进制c语言,只写出了十进制小数转换成二进制的,求二进制小数转十进制的...
  5. 批量修改txt内容_不用再慢慢手动修改,用Excel批量修改文件名
  6. 求数组中数的最大值、最小值(C语言)
  7. 18岁智商低的表现_孩子反应慢并不是智商低,三个原因很关键,第一个跟父母有关...
  8. arm 服务器cpu型号,挑战英特尔ARM Tilera发布36核服务器CPU
  9. SQL Server 2012基本介绍
  10. Kvaser新品推介:一款坚固耐用的单通道CAN / CAN FD转USB接口-Kvaser U100 编码:73-30130-01173-1
  11. Oracle同英超联赛数据统计和展示的结合
  12. 少年不惧岁月长,彼方尚有荣光在
  13. RestCloud 微服务监控中心
  14. 解决idea里面Tomcat无论怎么重新启动总是启动原先的项目问题
  15. SpringBoot在线教育项目(十二)
  16. LSTM预测算法(股票预测 天气预测 房价预测)
  17. 用网络摄像头做延时摄影(WPF+Emgu.CV)
  18. c# 备份oracle waitforexit()方法死锁,从过程的空的stdout原因同步读数据死锁[重复](Synchronized reading dat...
  19. PHP表单登记表,输出复选框的值
  20. 一种具有椭圆型金属钛球体的C4炸弹

热门文章

  1. CDN回源原理和CDN多级缓存
  2. 雷霆传奇linux源码,【雷霆传奇H5服务端】2020.07首发超漂亮大翅膀传奇网页游戏客户端[附超详细搭建教程]...
  3. 信号复数及希尔伯特变换的理解
  4. Oracle误删除dbf文件和表空间恢复
  5. python词组语义相似度_语义相似度
  6. ActiveMQ反序列化漏洞CVE-2015-5254复现
  7. 安卓linux获取最高权限获取,安卓root是什么意思(获取手机最高权限)
  8. 脑电数据处理分析教程汇总(eeglab, mne-python)
  9. 阿里云部署RSSHub踩坑笔记
  10. 【RK2206】3. 处理迪文屏事件