fingerprint.html 4.5 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. <!DOCTYPE HTML>
  2. <html>
  3. <head>
  4. <meta charset="utf-8">
  5. <meta name="viewport" content="initial-scale=1.0, minimum-scale=1.0, maximum-scale=1.0, user-scalable=no">
  6. <meta name="HandheldFriendly" content="true">
  7. <meta name="MobileOptimized" content="320">
  8. <title>Fingerprint Document</title>
  9. <link rel="stylesheet" type="text/css" href="res/doc.css" charset="utf-8">
  10. <link rel="stylesheet" type="text/css" href="res/prettify.sons.css" charset="utf-8">
  11. <script type="text/javascript" src="res/doc.js" charset="utf-8"></script><script type="text/javascript" src="res/prettify.js" charset="utf-8"></script>
  12. </head>
  13. <body><div id="content" class="content">
  14. <h1><a name="plus.fingerprint">fingerprint</a></h1>
  15. <p>Fingerprint模块管理指纹识别。</p>
  16. <h2>方法:</h2>
  17. <ul>
  18. <li>
  19. <a href="#plus.fingerprint.isSupport">isSupport</a>: 当前设备环境是否支持指纹识别</li>
  20. <li>
  21. <a href="#plus.fingerprint.isKeyguardSecure">isKeyguardSecure</a>: 当前设备是否设置密码锁屏</li>
  22. <li>
  23. <a href="#plus.fingerprint.isEnrolledFingerprints">isEnrolledFingerprints</a>: 当前设备是否已经录入指纹</li>
  24. <li>
  25. <a href="#plus.fingerprint.authenticate">authenticate</a>: 指纹识别认证</li>
  26. <li>
  27. <a href="#plus.fingerprint.cancel">cancel</a>: 取消指纹识别认证</li>
  28. </ul>
  29. <h2>对象:</h2>
  30. <ul>
  31. <li>
  32. <a href="#plus.fingerprint.AuthenticateOptions">AuthenticateOptions</a>: JSON对象,指纹识别认证参数</li>
  33. <li>
  34. <a href="#plus.fingerprint.FingerprintError">FingerprintError</a>: JSON对象,指纹识别错误信息</li>
  35. </ul>
  36. <h2>回调方法:</h2>
  37. <ul>
  38. <li>
  39. <a href="#plus.fingerprint.FingerprintSuccessCallback">FingerprintSuccessCallback</a>: 指纹识别认证成功回调函数</li>
  40. <li>
  41. <a href="#plus.fingerprint.FingerprintErrorCallback">FingerprintErrorCallback</a>: 指纹识别认证失败的回调函数</li>
  42. </ul>
  43. <h2>权限:</h2>
  44. <p>5+功能模块(permissions)</p>
  45. <pre class="prettyprint linenums">
  46. {
  47. // ...
  48. "permissions":{
  49. // ...
  50. "Fingerprint": {
  51. "description": "指纹识别"
  52. }
  53. }
  54. }
  55. </pre>
  56. <h1><a name="plus.fingerprint.AuthenticateOptions">AuthenticateOptions</a></h1>
  57. <p>JSON对象,指纹识别认证参数</p>
  58. <pre class="prettyprint linenums">
  59. interface AuthenticateOptions {
  60. readonly attribute String message;
  61. }
  62. </pre>
  63. <h2>说明:</h2>
  64. <p class="des">
  65. 用于设置指纹识别认证界面显示的提示信息等。
  66. </p>
  67. <h2>属性:</h2>
  68. <ul><li>message: <em>(<font class="type">String</font>
  69. 类型
  70. )</em>在指纹识别过程中显示在界面上的提示信息<br><p>
  71. 如果指纹识别认证过程中不显示提示框,则不显示此信息。
  72. </p>
  73. </li></ul>
  74. <h1><a name="plus.fingerprint.FingerprintError">FingerprintError</a></h1>
  75. <p>JSON对象,指纹识别错误信息</p>
  76. <pre class="prettyprint linenums">
  77. interface FingerprintError {
  78. const Number UNSUPPORT = 1;
  79. const Number KEYGUARD_INSECURE = 2;
  80. const Number FINGERPRINT_UNENROLLED = 3;
  81. const Number AUTHENTICATE_MISMATCH = 4;
  82. const Number AUTHENTICATE_OVERLIMIT = 5;
  83. const Number CANCEL = 6;
  84. const Number UNKNOWN_ERROR = 7;
  85. readonly attribute Number code;
  86. readonly attribute String message;
  87. }
  88. </pre>
  89. <h2>属性:</h2>
  90. <ul>
  91. <li>code: <em>(<font class="type">Number</font>
  92. 类型
  93. )</em>错误代码<br><p>
  94. 取值范围为FingerprintError对象的错误常量值。
  95. </p>
  96. </li>
  97. <li>message: <em>(<font class="type">String</font>
  98. 类型
  99. )</em>错误描述信息<br><p>
  100. 详细错误描述信息。
  101. </p>
  102. </li>
  103. </ul>
  104. <h1><a name="plus.fingerprint.FingerprintSuccessCallback">FingerprintSuccessCallback</a></h1>
  105. <p>指纹识别认证成功回调函数</p>
  106. <pre class="prettyprint linenums">
  107. void onSuccess() {
  108. // Authenticate success code.
  109. }
  110. </pre>
  111. <h2>参数:</h2>
  112. <p>无</p>
  113. <h2>返回值:</h2>
  114. <font class="type">void</font>
  115. : 无<h1><a name="plus.fingerprint.FingerprintErrorCallback">FingerprintErrorCallback</a></h1>
  116. <p>指纹识别认证失败的回调函数</p>
  117. <pre class="prettyprint linenums">
  118. function void onError(FingerprintError error) {
  119. // Handle error
  120. var code = error.code; // 错误编码
  121. var message = error.message; // 错误描述信息
  122. }
  123. </pre>
  124. <h2>参数:</h2>
  125. <ul><li>error:
  126. <em>(
  127. <a href="#plus.fingerprint.FingerprintError">FingerprintError</a>
  128. )
  129. 必选 </em>获取加速度操作的错误信息<br>
  130. 可通过error.code(Number类型)获取错误编码;
  131. 可通过error.message(String类型)获取错误描述信息。
  132. </li></ul>
  133. <h2>返回值:</h2>
  134. <font class="type">void</font>
  135. : 无<br><br>
  136. </div></body>
  137. </html>