handlock

来自于：开发者立即使用

set modify cancel unlock

概述

常见的九宫格手势密码控件，具备设置、修改、校验、取消功能，适用于手势密码安全校验等场合。

set

设置手势密码

set({params},callback(ret, err))

params

titleName：

  • 类型：字符串
  • 描述：（可选项）默认为空,为空时没有标题栏，目前不支持设置标题栏颜色，如颜色不适用建议隐藏标题栏。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msg: "",      //字符串型；处理结果反馈信息
  3.     handPassword:“”,  //字符串型；手势密码串，例如：1,2,3,4,5,6
  4. }

err：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msg: “”    //字符串型；错误信息
  3. }

示例代码

  1. var handlock = api.require('handlock');
  2. handlock.set({
  3.     titleName : "设置手势密码"
  4. },function(ret,err){
  5.     if(ret){
  6.         var handPassword = ret.handPassword;
  7.         alert(JSON.stringify(ret))
  8.     }else{
  9.         alert(JSON.stringify(err))
  10.     }
  11. });

可用性

Android系统

可提供的1.0.0及更高版本

modify

修改手势密码，先验证原密码，后设置新密码

modify({params},callback(ret, err))

params

titleName：

  • 类型：字符串
  • 描述：（可选项）默认为空,为空时没有标题栏，目前不支持设置标题栏颜色，如颜色不适用建议隐藏标题栏。

handPassword：

  • 类型：字符串
  • 描述：已设置的密码，例如：1,2,3,4,5,6。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msg: "",      //字符串型；处理结果反馈信息
  3.     handPassword:“”,  //字符串型；重新设置后的手势密码串，例如：6,5,4,3,2,1
  4. }

err：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msgType:“”, //字符串型;错误类型；
  3.                 //validate:校验型错误，此错误一般用来提示
  4.                 //biz:业务型错误，例如：密码校验达最大次数;
  5.     msg: “”, //字符串型；错误信息
  6. }

示例代码

  1. var handlock = api.require('handlock');
  2. handlock.modify({
  3.     titleName : "",
  4.     handPassword : “1,2,3,4,5,6”
  5. },function(ret,err){
  6.     if(ret){
  7.         alert(JSON.stringify(ret))
  8.     }else{
  9.         alert(JSON.stringify(err))
  10.     }
  11. });

可用性

Android系统

可提供的1.0.0及更高版本

cancel

取消手势密码

cancel({params},callback(ret, err))

params

titleName：

  • 类型：字符串
  • 描述：（可选项）默认为空,为空时没有标题栏，目前不支持设置标题栏颜色，如颜色不适用建议隐藏标题栏。

handPassword：

  • 类型：字符串
  • 描述：已设置的密码，例如：1,2,3,4,5,6。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msg: "",      //字符串型；处理结果反馈信息
  3. }

err：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msgType:“”, //字符串型;错误类型；
  3.                 //validate:校验型错误，此错误一般用来提示
  4.                 //biz:业务型错误，例如：密码校验达最大次数;
  5.     msg: “”, //字符串型；错误信息
  6. }

示例代码

  1. var handlock = api.require('handlock');
  2. handlock.cancel({
  3.     titleName : "",
  4.     handPassword : “1,2,3,4,5,6”
  5. },function(ret,err){
  6.     if(ret){
  7.         alert(JSON.stringify(ret))
  8.     }else{
  9.         alert(JSON.stringify(err))
  10.     }
  11. });

可用性

Android系统

可提供的1.0.0及更高版本

unlock

解锁手势密码

unlock({params},callback(ret, err))

params

titleName：

  • 类型：字符串
  • 描述：（可选项）默认为空,为空时没有标题栏，目前不支持设置标题栏颜色，如颜色不适用建议隐藏标题栏。

handPassword：

  • 类型：字符串
  • 描述：已设置的密码，例如：1,2,3,4,5,6。

callback(ret, err)

ret：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msg: "",      //字符串型；处理结果反馈信息
  3. }

err：

  • 类型：JSON对象
  • 内部字段：
  1. {
  2.     msgType:“”, //字符串型;错误类型；
  3.                 //validate:校验型错误，此错误一般用来提示
  4.                 //biz:业务型错误，例如：密码校验达最大次数;
  5.     msg: “”, //字符串型；错误信息
  6. }

示例代码

  1. var handlock = api.require('handlock');
  2. handlock.unlock({
  3.     titleName : "",
  4.     handPassword : “1,2,3,4,5,6”
  5. },function(ret,err){
  6.     if(ret){
  7.         alert(JSON.stringify(ret))
  8.     }else{
  9.         alert(JSON.stringify(err))
  10.     }
  11. });

可用性

Android系统

可提供的1.0.0及更高版本