AppCan插件API功能扩展之uexGestureUnlockWord文件下载.docx
《AppCan插件API功能扩展之uexGestureUnlockWord文件下载.docx》由会员分享,可在线阅读,更多相关《AppCan插件API功能扩展之uexGestureUnlockWord文件下载.docx(16页珍藏版)》请在冰豆网上搜索。
1.2、开源源码
点击至插件详情页(插件测试用例与插件包已经提供)
1.3、插件截图
2、API
2.1、方法
isGestureCodeSet检测是否已设置手势密码
uexGestureUnlock.isGestureCodeSet();
说明
∙检测系统储存中是否存在已设置的手势密码
∙会触发回调
cbIsGestureCodeSet检测是否已设置手势密码的回调方法
参数
无
平台支持
Android2.2+
iOS7.0+
版本支持
Android3.0.0+
iOS3.0.0+
示例
1.uexGestureUnlock.isGestureCodeSet();
resetGestureCode重置手势密码
uexGestureUnlock.resetGestureCode();
∙移除系统储存中的手势密码(如果存在)
1.uexGestureUnlock.resetGestureCode();
config配置插件
uexGestureUnlock.config(param);
∙配置插件的相关属性
∙每次调用此接口,均会覆盖之前的配置
∙所有的key均是可选参数,不传时会设置为默认值
1.varparams={
2.minimumCodeLength:
3.maximumAllowTrialTimes:
4.errorRemainInterval:
5.successRemainInterval:
6.backgroundColor:
7.normalThemeColor:
8.selectedThemeColor:
9.errorThemeColor:
10.creationBeginPrompt:
11.codeLengthErrorPrompt:
12.codeCheckPrompt:
13.checkErrorPrompt:
14.creationSucceedPrompt:
15.verificationBeginPrompt:
16.verificationErrorPrompt:
17.verificationSucceedPrompt:
18.cancelVerificationButtonTitle:
19.cancelCreationButtonTitle:
20.restartCreationButtonTitle:
21.backgroundImage:
22.iconImage:
23.}
各字段含义如下:
key
value类型
默认值
备注
minimumCodeLength
Number
设置密码时的最短长度
4
至少为1
maximumAllowTrialTimes
验证密码时的最多尝试次数
5
设置为0时表示没有上限,
errorRemainInterval
错误状态的保留时间
1.0
successRemainInterval
操作成功后的保留时间
0.2
操作成功后,经过此时间之后才会关闭插件UI
backgroundColor
String
手势解锁界面的背景色
“#F1F1F1”
支持3位6位8位的HEXcolor/RBG/RBGA
normalThemeColor
普通状态下的主题颜色
“#002849”
同上
selectedThemeColor
选中状态下的主题颜色
“#22B2F6”
errorThemeColor
错误状态下的主题颜色
“#FE525C”
creationBeginPrompt
设置手势密码前的提示文字
“请设置手势密码”
codeLengthErrorPrompt
密码长度低于最短长度的错误提示文字
“请至少连续绘制%d个点”
%d会被替换成当前的最短密码长度
codeCheckPrompt
确认手势手势密码,要求再次绘制的提示文字
“请再次绘制手势密码”
checkErrorPrompt
再次绘制的图案不一致的提示文字
“与首次绘制不一致,请再次绘制”
creationSucceedPrompt
设置手势密码成功的提示文字
“手势密码设置成功”
verificationBeginPrompt
验证手势前的提示文字
“请验证手势密码”
verificationErrorPrompt
验证手势密码失败的提示文字
“验证错误!
您还可以尝试%d次”
%d会被替换成当前剩余次数
verificationSucceedPrompt
验证手势密码成功的提示文字
“验证通过”
cancelVerificationButtonTitle
取消验证的按钮文字
“忘记密码?
”
cancelCreationButtonTitle
取消设置手势密码的按钮文字
“取消设置手势密码”
restartCreationButtonTitle
重新设置手势密码的按钮文字
“重新设置手势密码”
backgroundImage
背景图的文件路径
图片不存在时不会显示,只支持file:
//wgt:
//res:
//
iconImage
头像的文件路径
1.vardata={
2.backgroundImage:
"
res:
//bgImage.jpg"
3.iconImage:
//icon.png"
4.normalThemeColor:
#F1F1F1"
5.selectedThemeColor:
rgb(33,233,164)"
6.errorThemeColor:
rgba(250,45,116,0.4)"
7.cancelVerificationButtonTitle:
切换其他账号"
8.minimumCodeLength:
9.}
10.uexGestureUnlock.config(JSON.stringify(data));
verify验证手势密码
uexGestureUnlock.verify();
∙打开插件页面进行验证手势密码操作
∙验证过程中会会有监听onEventOccur插件事件发生的监听方法
∙验证过程结束会有回调cbVerify验证手势密码的回调方法
1.uexGestureUnlock.verify();
create设置手势密码
uexGestureUnlock.create(params);
∙打开插件页面,先验证手势密码,再进行设置手势密码的操作
∙如果当前未设置手势密码,则会跳过验证手势密码的步骤
∙验证过程结束会有回调cbCreate设置手势密码的回调方法
2.isNeedVerifyBeforeCreate:
3.}
参数名称
参数类型
是否必选
isNeedVerifyBeforeCreate
Boolean
否
创建密码之前是否需要验证已经设置的手势密码,默认为true。
当为false时,会强制跳过验证手势密码的步骤直接设置新密码
1.vardata={
false
3.}
4.uexGestureUnlock.create(JSON.stringify(data));
cancel终止手势密码验证/设置过程
uexGestureUnlock.cancel();
∙强制关闭由verify或者create调起的插件界面,终止相应的操作步骤
1.uexGestureUnlock.cancel();
2.2、回调方法
uexGestureUnlock.cbIsGestureCodeSet(param);
检测是否已设置手势密码的回调方法
param为json字符串
1.varparam={
2.result:
//Boolean,必选,是否已设置手势密码true/false
1.window.uexOnload=function(type){
2.uexGestureUnlock.cbIsGestureCodeSet=function(info){
3.alert(info);
4.}
5.}
cbVerify验证手势密码的回调方法
uexGestureUnlock.cbVerify(param);
验证手势密码的回调方法
2.isFinished:
//Boolean,必选,是否完成了手势密码验证
3.errorCode:
//Number,可选,仅isFinished为false时有此参数,验证未完成的错误代码
4.errorString:
//String,可选,仅isFinished为false时有此参数,验证未完成的错误描述
∙errorCode详见附录-uexGestureUnlockError错误代码列表
2.uexGestureUnlock.cbVerify=function(info){
cbCreate设置手势密码的回调方法
uexGestureUnlock.cbCreate(param);
∙设置手势密码的回调方法
//Boolean,必选,是否完成了手势密码设置
//Number,可选,仅isFinished为false时有此参数,设置手势密码未完成的错误代码
//String,可选,仅isFinished为false时有此参数,设置手势密码未完成的错误描述
∙当且仅当isFinished回调为true时,会将用户设置的密码存入本地储存
∙应用重启/覆盖升级不影响密码储存,但应用删除会清除掉密码记录
2.uexGestureUnlock.cbCreate=function(info){
2.3、监听方法
onEventOccur插件事件发生的监听方法
uexGestureUnlock.onEventOccur(param);
∙当插件触发相应的事件时,会触发此监听
1.varparam={
2.eventCode:
//Number,必选,插件事件代码
∙eventCode详见附录-uexGestureUnlockEvent事件代码列表
2.uexGestureUnlock.onEventOccur=function(info){
3、附录
uexGestureUnlockError错误代码列表
errorCode
描述
1
在未设置密码的情况下进行验证密码操作
2
用户取消了创建密码过程
3
用户取消了验证密码过程
尝试密码次数过多
插件被cancel接口强制关闭
6
发生未知错误
uexGestureUnlockEvent事件代码列表
eventCode
插件初始化
开始手势密码验证
手势密码验证失败
验证过程被用户取消
手势密码验证成功
开始手势密码设置
7
用户输入的密码不符合长度要求
8
开始第二次输入手势密码
9
两次输入的密码不一致
10
手势密码设置被用户取消
11
手势密码设置完成
4、更新历史
iOS
API版本:
uexGestureUnlock-3.0.2
最近更新时间:
2015-12-26
历史发布版本
更新内容
3.0.2
添加IDE支持
3.0.1
修复maximumAllowTrialTimes拼写错误
3.0.0
uexGestureUnlock发布
Android
uexGestureUnlock-3.0.0
2015-12-04