一、CountDownTimer简介
CountDownTimer是Android系统提供的一个用于倒计时的工具类。它可以设置倒计时的总时间以及每隔一定时间间隔回调一个onTick()方法,在这个方法中可以更新UI。倒计时结束后会回调onFinish()方法,可以在这个方法中做一些善后工作。
下面是一个简单的CountDownTimer的使用示例:
new CountDownTimer(60000, 1000) { public void onTick(long millisUntilFinished) { mTextView.setText("倒计时:" + millisUntilFinished / 1000 + "秒"); } public void onFinish() { mTextView.setText("倒计时结束"); } }.start();
这个示例中,我们设置总时间为60秒,每隔1秒回调一次onTick()方法,更新TextView的倒计时显示。倒计时结束后会回调onFinish()方法,更新TextView的文本为“倒计时结束”。
二、CountDownTimer的参数详解
CountDownTimer的构造方法有两个参数,第一个参数是倒计时的总时间,单位为毫秒;第二个参数表示倒计时的时间间隔,同样单位为毫秒。这两个参数可以通过set方法进行修改。以下是CountDownTimer的四个方法:
1、onTick(long millisUntilFinished):每次倒计时间隔结束时回调,参数millisUntilFinished表示倒计时剩余的时间,单位为毫秒。
2、onFinish():倒计时结束时回调。
3、cancel():取消倒计时。
4、start():开始或恢复倒计时。
可以通过以下代码设置倒计时总时间和时间间隔:
CountDownTimer countDownTimer = new CountDownTimer(60000, 1000) { public void onTick(long millisUntilFinished) { // do something } public void onFinish() { // do something } }; countDownTimer.start(); // 开始倒计时 countDownTimer.cancel(); // 取消倒计时 countDownTimer.onTick(30000); // 设置倒计时时间为30秒 countDownTimer.onTick(5000); // 设置倒计时时间为5秒
三、CountDownTimer的注意事项
1、CountDownTimer不是线程安全的,不能在多个线程中共享。
2、CountDownTimer默认在UI线程中执行,因此不能在onTick()和onFinish()方法中进行耗时操作,会导致ANR。
3、CountDownTimer倒计时结束后不会自行停止,需要手动调用cancel()方法停止倒计时,并且不能再次调用start()方法,否则会抛出IllegalStateException异常。
四、实例应用:验证码倒计时
验证码倒计时功能是很多手机应用中常见的功能,下面通过实例来演示如何使用CountDownTimer实现验证码倒计时功能。
首先,在xml布局文件中添加一个Button控件,用于显示获取验证码的按钮。在Activity中为这个按钮添加点击事件,在点击事件中启动CountDownTimer。
mButton.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // 启动倒计时 CountDownTimer countDownTimer = new CountDownTimer(60000, 1000) { public void onTick(long millisUntilFinished) { mButton.setText("剩余时间:" + millisUntilFinished / 1000 + "秒"); mButton.setClickable(false); } public void onFinish() { mButton.setText("重新获取"); mButton.setClickable(true); } }.start(); } });
在CountDownTimer的onTick()方法中,我们每次更新Button的文本,让其显示剩余的倒计时时间,并将Button设置为不可点击。倒计时结束后,我们恢复Button的原本文本“重新获取”,并将Button设置为可点击状态。
五、总结
CountDownTimer是一个方便实用的倒计时工具类,可以应用于很多场景,比如验证码倒计时、倒计时闹钟等。在使用CountDownTimer时,需要注意它的线程安全性,不能在onTick()和onFinish()方法中进行耗时操作,以及必须手动调用cancel()方法来停止倒计时。