gestureUnlock

立即使用

Method

open close hide show

概述

本模块封装了手势解锁功能

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

open

打开手势解锁/设置页面

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

params

rect:

类型：JSON对象
描述：(可选项）手势解锁/设置页面的位置及长宽

{
      x: 0,    //（可选项）数字类型；手势解锁/设置页面 x 坐标（相对于所属的 Window 或 Frame）；默认值：0
      y: 0,    //（可选项）数字类型；手势解锁/设置页面 y 坐标（相对于所属的 Window 或 Frame）；默认值：100
      w: 320,  //（可选项）数字类型；手势解锁/设置页面（相对于所属的 Window 或 Frame）；默认值：屏幕宽度
      h: 300,  //（可选项）数字类型；手势解锁/设置页面（相对于所属的 Window 或 Frame）；默认值：屏幕宽度
}

password：

类型：字符串类型
描述：（可选项）用户设置的手势密码，手势解锁时必须设置此参数

type：

类型：字符串类型
描述：（可选项）页面类型
默认值：’unlock’
取值范围：
- unlock (手势解锁)
- set（手势密码设置）

showArrowDirection：

类型：布尔
描述：（可选项）是否显示指示手势划过的方向箭头
默认值：false（不显示）

styles：

类型：JSON 对象
描述：（可选项）手势解锁/设置页面样式设置
默认值：见内部字段
内部字段：

{
    bg:'rgba(0,0,0,0)', //（可选项）字符串类型；手势解锁/设置页面背景颜色，支持#、rgb、rgba；默认：rgba(0,0,0,0)
    circle:{    //json对象，手势圆圈样式设置
      circleNormalColor:'#87CEFA',  //（可选项）字符串类型；手势圆圈正常的颜色，支持#、rgb、rgba；默认：#87CEFA
      circleSelectedColor:'#1E90FF',//（可选项）字符串类型；手势圆圈选中的颜色，支持#、rgb、rgba；默认：#1E90FF
      circleErrorColor:'#FF0000',   //（可选项）字符串类型；手势圆圈错误的颜色，支持#、rgb、rgba；默认：#FF0000
      circleBorderWidth:1,          //(可选项）数字类型；外空心圆边界宽度；默认：1（仅iOS支持）
      circleRatio:0.3,              //(可选项）数字类型；内部的实心圆所占外圆的比例大小；取值范围：0 - 1；默认：0.3（仅iOS支持）
      arrowH:8,                     //(可选项）数字类型；三角形箭头的边长；默认：8（仅iOS支持）
     radius:0.6,                   //（可选项）小数类型；圆圈半径大小，取值范围 0 -1；（仅android支持）
    },
    line:{     //json对象，线样式设置
      lineW:4,                      //(可选项）数字类型；连线的宽度；默认：4
      lineNormalColor:'#1E90FF',    //（可选项）字符串类型；连线正常的颜色，支持#、rgb、rgba；默认：#1E90FF（仅iOS支持）
      lineErrorColor:'#FF0000',     //（可选项）字符串类型；连线错误的颜色，支持#、rgb、rgba；默认：#FF0000（仅iOS支持）
    }
}

fixedOn:

类型：字符串
描述：（可选项）添加到哪个frame，与fixed一起使用

fixed:

类型：布尔
描述：（可选项）模块是否随所属 window 或 frame 滚动
默认值：true（不随之滚动）

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    isCorrect:true,   //布尔类型；手势密码是否正确，手势解锁时返回
    gestureCode:''    //字符串类型；手势密码
}

示例代码

var gestureUnlock = api.require('gestureUnlock');
gestureUnlock.open({
    rect:{
      x: 0,   
      y: 0,    
      w: 320,  
      h: 300,
    },
    styles:{
     bg:'rgba(0,0,0,0)', 
     circle:{   
      circleNormalColor:'#87CEFA',  
      circleSelectedColor:'#1E90FF',
      circleErrorColor:'#FF0000',  
      circleBorderWidth:1,  
      circleRatio:0.3, 
      arrowH:8
     },
     line:{    
      lineW:4,             
      lineNormalColor:'#1E90FF', 
      lineErrorColor:'#FF0000'
     }
   },
    password:'012345678',
    fixedOn: api.frameName,
    fixed: false
}, function(ret) {
    alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

close

关闭手势解锁/设置页面

close()

示例代码

var gestureUnlock = api.require('gestureUnlock');
gestureUnlock.close();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

hide

隐藏手势解锁/设置页面

hide()

示例代码

var gestureUnlock = api.require('gestureUnlock');
gestureUnlock.hide();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

show

显示已隐藏的手势解锁/设置页面

show()

示例代码

var gestureUnlock = api.require('gestureUnlock');
gestureUnlock.show();

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本