gestureUnlock

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
      circleRatio:0.3,              //(可选项）数字类型；内部的实心圆所占外圆的比例大小；取值范围：0 - 1；默认：0.3
      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) {
    api.alert({msg: 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及更高版本

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