gestureUnlock

立即使用

概述

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

注意:手势密码数字为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及更高版本