lockscreen


九宫格绘图锁插件, 包含绘图设置锁密码、绘图解锁和删除锁。

var lockscreen = rd.require('lockscreen');

方法:

回调方法:

init


初始化九宫格锁

lockscreen.init(func, iconRadius, errorTimes);
说明:

初始化九宫格锁, 并添加状态回调监听

参数:
  • func: (stateCallback) 必选 回调js的方法名
  • iconRadius: (Number) 必选 头像显示效果为圆形, 此参数为头像的半径, 默认 48
  • errorTimes: (Number) 可选 错误次数, 超过此次数进入"忘记密码" 默认5次
返回值:

无返回值

示例代码:
    function stateCallback(code){
        alert(code);
    }
    lockscreen.init(stateCallback, 50, 6);

setPointNormalColors


正常时点颜色

lockscreen.setPointNormalColors(color,outterColor);
说明:

正常时点颜色

参数:
  • color:(String) 必选 点内部颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 浅灰色 #ffd9d9d9
  • outterColor:(String) 必选 点外部颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 深灰色 #ff929292
返回值:

示例代码:
lockscreen.setPointNormalColors('#1874CD','#1C86EE');

setPointSelectedColors


选择时点颜色

lockscreen.setPointSelectedColors(color,outterColor);
说明:

选择时点颜色

参数:
  • color:(String) 必选 点内部颜色, AARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 蓝色 #ff0596f6
  • outterColor:(String) 必选 点外部颜色,ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 浅蓝色 #ff8cbad8
返回值:

示例代码:
lockscreen.setPointSelectedColors('#ff0596f6','#ff8cbad8');

setPointErrorColors


错误时点颜色

lockscreen.setPointErrorColors(color,outterColor);
说明:

错误时点颜色

参数:
  • color:(String) 必选 点内部颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 红色 #ffea0945
  • outterColor:(String) 必选 点外部颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 深红色 #ff901032
返回值:

示例代码:
lockscreen.setPointErrorColors('#ffd9d9d9','#ff929292');

setPromptFontColor


设置提示栏字体颜色

lockscreen.setPromptFontColor(color);
说明:

设置提示栏字体颜色

参数:
  • color:(String) 必选 字体颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 黑红色 #ffcc0000
返回值:

示例代码:
lockscreen.setPromptFontColor('#ffcc0000');

setPromptFontSize


设置提示栏字体大小

lockscreen.setPromptFontSize(size);
说明:

设置提示栏字体大小

参数:
  • size:(Number) 必选 字体大小
返回值:

示例代码:
lockscreen.setPromptFontSize(12);

setUsernameFontColor


设置用户名栏字体颜色

lockscreen.setUsernameFontColor(color);
说明:

设置用户名栏字体颜色

参数:
  • color:(String) 必选 字体颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 黑色 #000000
返回值:

示例代码:
lockscreen.setUsernameFontColor('#ff000000');

setUsernameFontSize


设置用户名栏字体大小

lockscreen.setUsernameFontSize(size);
说明:

设置用户名栏字体大小

参数:
  • size:(Number) 必选 字体大小
返回值:

示例代码:
lockscreen.setUsernameFontSize(14);

setBackgroundColor


设置背景颜色

lockscreen.setBackgroundColor(color);
说明:

设置背景颜色

参数:
  • color:(String) 必选 字体颜色, ARGB或RGB字符串(ARGB:是8位的颜色值,高二位为A,次二位为R,再次二位为G,最后二位为B。RGB的A默认为不透明,其他的与ARGB保持一致。), 默认 白色 #ffffff
返回值:

示例代码:
lockscreen.setBackgroundColor('#ffffffff');    

setBackgroundImage


设置背景图片

lockscreen.setBackgroundImage(imgBgUrl);
说明:

设置背景图片

参数:
  • imgBgUrl:(String) 必选 背景图片的路径(不支持网络路径)
返回值:

示例代码:
lockscreen.setBackgroundImage('cpts://main/img/main_bg.jpg');

openChangeLock


打开九宫格绘制更改锁密码,设置锁密码需要连续2次绘制一致后,锁密码才能设置成功, 否则重新设置锁密码

lockscreen.openChangeLock();
说明:

打开九宫格密码设置界面, 在此界面可以设置锁密码或更改锁密码,锁密码才能设置成功, 否则重新设置锁密码

参数:

返回值:

示例代码:
lockscreen.openChangeLock();

checkPasswordExisting


检查锁密码是否设置了

lockscreen.checkPasswordExisting();
说明:

检查锁密码是否设置了

参数:

返回值:
  • (Boolean) 是否已经设置了密码; true:设置了 false:没有设置
示例代码:
var b = lockscreen.checkPasswordExisting();

openUnLock


打开九宫格解锁界面, 不显示用户头像, 不显示用户名

lockscreen.openUnLock();
说明:

打开九宫格解锁界面, 不显示用户头像, 不显示用户名

参数:

返回值:

示例代码:
lockscreen.openUnLock();

openUnLockWithIcon


打开九宫格解锁界面, 显示用户头像, 不显示用户名

lockscreen.openUnLockWithIcon(imageUrl);
说明:

打开九宫格解锁界面, 显示用户头像, 不显示用户名

参数:
  • imageUrl:(String) 必选 头像图片的路径(仅支持协议路径),头像会显示成圆形
返回值:

示例代码:
lockscreen.openUnLockWirhIcon("cpts://main/img/sat_main.jpg");

openUnLockWithIconAndUsername


打开九宫格解锁界面, 显示用户头像, 显示用户名

lockscreen.openUnLockWithIconAndUsername(imageUrl,username);
说明:

打开九宫格解锁界面, 显示用户头像, 显示用户名

参数:
  • imageUrl:(String) 必选 头像图片的路径(仅支持协议路径),头像会显示成圆形
  • username:(String) 必选 用户名
返回值:

示例代码:
lockscreen.openUnLockWithIconAndUsername("cpts://main/img/icon.jpg","Mou");

deleteLockPassword


删除锁密码, 正常情况下调用, 如果已经设置了锁密码,需要先验证后删除

lockscreen.deleteLockPassword();
说明:

用户按正常流程删除密码

参数:

返回值:

示例代码:
lockscreen.deleteLockPassword();

clearLockPasswordPrivate


删除锁密码, 非正常情况下调用

lockscreen.clearLockPasswordPrivate();
说明:

非正常情况下删除密码(直接删除,开发者在认证用户成功后才能调用)

参数:

返回值:

示例代码:
lockscreen.clearLockPasswordPrivate();

removeLock


移除

lockscreen.removeLock();
说明:

移除锁界面

参数:

返回值:

示例代码:
lockscreen.removeLock();

stateCallback


状态回调

function stateCallback(code) {
    alert(code);
}
说明:

当解锁成功或失败、设置锁成功或失败等状态时, 通过此回调返回不同状态的code值。

参数:
  • code: (Number) 必选 回调状态值, 如下:

    0 : 成功设置锁密码或更改锁密码
    1 : 成功解锁
    2 : 忘记密码
    3 : 成功删除密码(包含:deleteLockPassword和clearLockPassword)
    4 : 还没有设置锁密码回调