Skip to content

Latest commit

 

History

History
241 lines (190 loc) · 10.1 KB

README-ZH.md

File metadata and controls

241 lines (190 loc) · 10.1 KB
Raw

BlurLockView

WoWoViewPager BoomMenu CoCoin BlurLockView LeeCo GithubWidget JellyToggleButton FaceOffToggleButton

BlurLockView

毛玻璃效果的解锁界面。

English Version

备注

  1. 使用了500px-android-blur的毛玻璃效果。
  2. 会添加更多显示、隐藏BlurLockView的动画。
  3. 在demo里，使用了Material-Dialogs以便调整颜色。

使用

Demo
Gradle
快速使用
显示和隐藏
Listeners
毛玻璃效果
键盘
文本
字体
风格
错误密码

Demo

下载demo：
Download from Fir
Download from Github
Fir
Demo中含有目前BlurLockView的所有功能
Settings Operations

Gradle

添加到module的build.gradle中

dependencies {
    ...
    compile 'com.nightonke:blurlockview:1.0.0'
    ...
}

快速使用

加入到xml中：

<com.nightonke.blurlockview.BlurLockView
    android:id="@+id/blurlockview"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    />

注意BlurLockView应该放置在需要被覆盖的控件的正上方，也就是覆盖其他控件。

加入以下代码即可使用：

// Set the view that need to be blurred
blurLockView.setBlurredView(imageView1);

// Set the password
blurLockView.setCorrectPassword(getIntent().getStringExtra("PASSWORD"));

显示和隐藏

你可以选择显示或隐藏的时延、方式、缓动函数。 比如，本文开头的gif以ShowType.FADE_IN为方式，以1000ms为时延来显示，以HideType.FADE_OUT为方式，以1000ms为时延来隐藏。 你可以在demo中尝试各种效果。

Ease

Listeners

BlurLockView.OnPasswordInputListener

@Override
public void correct(String inputPassword) {
    // the input password is correct
    // you can hide the BlurLockView, for example
}

@Override
public void incorrect(String inputPassword) {
    // the input password is incorrect
}

@Override
public void input(String inputPassword) {
    // the password is being input
}

BlurLockView.OnLeftButtonClickListener

@Override
public void onClick() {
    // The left button is being clicked
}

实现以上Listeners然后加入以下代码：

blurLockView.setOnLeftButtonClickListener(this);
blurLockView.setOnPasswordInputListener(this);

注意右下角的按钮是用于退格的，所以没有右下角按钮的监听器。

毛玻璃效果

你可以使用三种不同的参数来调整毛玻璃效果：

  1. 用setDownsampleFactor(int downsampleFactor)来调整DownsampleFactor，其值越小，毛玻璃效果越淡。
  2. 用setBlurRadius(int blurRadius)来调整BlurRadius，其值越小，毛玻璃效果越淡。
  3. 用setOverlayColor(int color)来调整OverlayColor，可以改变毛玻璃效果颜色。

例子：
clear unclear

red blue

键盘

你可以用不同的键盘来输入不同类型的密码。

setType(Password type, boolean smoothly);

密码类型有Password.NUMBER（默认）和Password.TEXT，还可以选择是否顺畅切换键盘。 注意字母类型密码是不区分大小写的，我会改进这个不足。

Password Type

文本

  1. 用setTitle(String string)来改变标题文本。
  2. 用setLeftButton(String string)来改变左下角按钮文本。
  3. 用setRightButton(String string)来改变右下角按钮文本。

字体

用setTypeface(Typeface typeface)来改变BlurLockView的字体。

风格

1. 改变字母类型密码的按钮背景，可以用setSmallButtonViewsBackground(int id)，默认的背景是：

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item android:state_pressed="true" >
        <shape android:shape="oval"  >

        </shape>
    </item>
    <item android:state_focused="true">
        <shape android:shape="oval"  >
            <stroke android:width="1dip" android:color="@color/default_button_press" />
            <solid android:color="@android:color/transparent"/>
        </shape>
    </item>
    <item >
        <shape android:shape="oval"  >
            <stroke android:width="1dip" android:color="@color/default_button_press" />
            <solid android:color="@android:color/transparent"/>
        </shape>
    </item>
</selector>

2. 改变字母类型密码的按钮效果，可以用setBigButtonViewsClickEffect(int id)，默认的效果是：

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item >
        <shape android:shape="oval"  >
            <solid android:color="@color/default_button_press"/>
        </shape>
    </item>
</selector>

3. 当点击按钮时，上述提到的按钮效果会渐逝，可以用setSmallButtonViewsClickEffectDuration(int duration)来调整时延。

4. 类似的，可以用这三个函数来改变数字类型密码的风格setBigButtonViewsBackground(int id)，setBigButtonViewsClickEffect(int id)和setBigButtonViewsClickEffectDuration(int duration)。

5. 可以用setTextColor(int color)来改变所有文字颜色。

6. 下面的函数可以获得BlurLockView的各个控件：

  1. public TextView getTitle() {return title;}获取标题控件。
  2. public TextView getLeftButton() {return leftButton;}获取左下角按钮控件。
  3. public TextView getRightButton() {return rightButton;}获取右下角按钮控件。
  4. public BigButtonView[] getBigButtonViews() {return bigButtonViews;}获取10个数字按钮控件。
  5. public SmallButtonView[][] getSmallButtonViews() {return smallButtonViews;} 获取所有的字母按钮控件，注意有些数组元素为null，具体的控件下标如下表：
private final char CHARS[][] = {
        {'1', '2', '3', '4', '5', '6', '7', '8', '9', '0'},
        {'Q', 'W', 'E', 'R', 'T', 'Y', 'U', 'I', 'O', 'P'},
        {   'A', 'S', 'D', 'F', 'G', 'H', 'J', 'K', 'L'  },
        {        'Z', 'X', 'C', 'V', 'B', 'N', 'M'       }
};

错误密码

BlurLockView会记录输入错误密码次数，可以用getIncorrectInputTimes()来获取当前错误密码次数，或者用setIncorrectInputTimes(int incorrectInputTimes)来重置次数。

版本

1.0.0

Todo

  1. 更多的动画效果。
  2. 让字母密码输入类型可以输入大小写字母和其他特殊符号。

License

Copyright 2016 Nightonke

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.