mtlGestureUnlock

概述

本插件封装了手势解锁功能。支持打开设置手势密码页面,设置不符合规范会给出相应提示。亦支持打开一个解锁界面。注意设置手势密码界面和解锁界面都是 open 的一个 window。可以在相应事件的监听里做自己需求的逻辑处理。

注意:手势密码数字为0-8

插件接口

create

打开设置手势密码页面

create({params},callback(ret))

params

animate:

  • 类型:布尔
  • 描述:(可选项)打开和关闭设置密码页面是否带动画效果
  • 默认:true

isOri:

  • 类型:布尔
  • 描述:(可选项)是否为横屏显示
  • 默认:false

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    evnetType:''     //字符串类型;交互事件类型;取值范围:
                     //back:用户点击返回按钮
                     //complete:用户设置完成手势密码
}

示例代码

var mtlGestureUnlock = api.require('mtlGestureUnlock');
mtlGestureUnlock.create({
   animate:false,
   isOri:true
},function(ret) {
    api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

validate

打开验证手势密码页面

validate({params},callback(ret))

params

animate:

  • 类型:布尔
  • 描述:(可选项)打开和关闭验证密码页面是否带动画效果
  • 默认:true

track:

  • 类型:布尔
  • 描述:(可选项)是否显示手势轨迹
  • 默认:true

user:

  • 类型:JSON对象
  • 描述:(可选项)用户信息,不传则不显示(暂仅支持iOS)
  • 内部字段:
   avatar:'',     //(可选项)字符串类型;头像地址,不传显示默认头像
   name:''        //(可选项)字符串类型;用户名,不传则不显示;    

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    evnetType:''     //字符串类型;交互事件类型;取值范围:
                     //back:用户点击返回按钮
                     //error:用户设置四次密码均错误
                     //other:用户点击其他账号登陆按钮 (暂仅支持iOS)
                     //forget:用户点击忘记密码按钮
                     //notSet:尚未设置手势密码
                     //success:尚未设置手势密码
}

示例代码

var mtlGestureUnlock = api.require('mtlGestureUnlock');
mtlGestureUnlock.validate({
   animate:false,
   track:false,
   user:{
      avatar:'https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fc-ssl.duitang.com%2Fuploads%2Fitem%2F201912%2F28%2F20191228105602_4Wm5z.thumb.1000_0.jpeg&refer=http%3A%2F%2Fc-ssl.duitang.com&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=auto?sec=1658385616&t=079fe00219af308f8adc32950c9b6825',
      name:'Lovery'
   }
},function(ret) {
    api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

delete

删除设置的手势密码

delete()

示例代码

var mtlGestureUnlock = api.require('mtlGestureUnlock');
mtlGestureUnlock.delete();

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

gesturesPassword

获取设置的手势密码

gesturesPassword(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    status:true,    //布尔类型;是否获取成功
    password:''     //字符串类型;当前设置的手势密码
}

示例代码

var mtlGestureUnlock = api.require('mtlGestureUnlock');
mtlGestureUnlock.gesturesPassword(function(ret) {
    api.alert({msg:JSON.stringify(ret)});
});

可用性

iOS 系统,Android 系统

可提供的 1.0.0 及更高版本

是否仍需要帮助? 请保持联络!
最后更新于 2024/11/11