您的位置:

Android CountDownTimer使用详解

一、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()方法来停止倒计时。