在 Android 中倒计时功能是比较常用的一个功能,比如短信验证码,付款倒计时等。实现方式有Handler、Thread 等,但是实现起来都有点麻烦,其实Android已经为我们封装好了一个抽象类 CountDownTimer,可以简单的实现倒计时功能,如下图所示。
countDown.gif
CountDownTimer 实现倒计时功能的机制也是用Handler 消息控制,只是它帮我们已经封装好了,先看一下它的介绍。
Schedule a countdown until a time in the future, with regular notifications on intervals along the way. Example of showing a 30 second countdown in a text field:
new CountDownTimer(30000, 1000) {
public void onTick(long millisUntilFinished) {
mTextField.setText("seconds remaining: " + millisUntilFinished / 1000);
}
public void onFinish() {
mTextField.setText("done!");
}
}.start();
大致意思是,设置一个倒计时,直到完成这个时间段的计时,并会实时更新时间的变化,最后举了一个30秒倒计时的例子,如下:
new CountDownTimer(30000, 1000) {
public void onTick(long millisUntilFinished) {
mTextField.setText("seconds remaining: " + millisUntilFinished / 1000);
}
public void onFinish() {
mTextField.setText("done!");
}
}.start();
详解
可以看到,上面示例中构造方法需要传入两个参数,如下:
/**
* @param millisInFuture The number of millis in the future from the call to start()
* until the countdown is done and onFinish() is called.
* @param countDownInterval The interval along the way to receive onTick(long) callbacks.
*/
public CountDownTimer(long millisInFuture, long countDownInterval) {
mMillisInFuture = millisInFuture;
mCountdownInterval = countDownInterval;
}
第一个参数是倒计时的总时间,第二个参数是倒计时的时间间隔(每隔多久执行一次),注意这里传入的两个时间参数的单位都是毫秒。
它提供的几个方法也很简单,如下:
methods.png
- start():开始倒计时。
- cancel():取消倒计时。
- onFinish():倒计时完成后回调。
- onTick(long millisUnitilFinished):当前任务每完成一次倒计时间隔时间时回调。
验证码示例
短信验证码倒计时原理很简单,也就是点击获取验证码开启倒计时,在倒计时内不可点击,倒计时结束后方可重新获取,如下所示:
new CountDownTimer(millisUntilFinished, 1000) {
/**
* 当前任务每完成一次倒计时间隔时间时回调
* @param millisUntilFinished
*/
public void onTick(long millisUntilFinished) {
if (btn_Code != null) {
//按钮不可用
btn_Code.setClickable(false);
btn_Code.setEnabled(false);
btn_Code.setText(millisUntilFinished / 1000 + "s");
}
}
/**
* 倒计时完成后回调
*/
public void onFinish() {
if (btn_Code != null) {
//按钮可用
btn_Code.setText("重新获取");
btn_Code.setClickable(true);
btn_Code.setEnabled(true);
}
//取消倒计时
cancel();
}
}.start();
注:在Activity或Fragment销毁的时候记得调用 cancle() 方法,否则它的 onTick() 方法还会继续执行,容易造成内存泄漏。
网友评论