Android CountDownTimer使用详解

小蓝 • 2024-11-25 17:24 • 编程

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

原创文章，作者：小蓝，如若转载，请注明出处：https://www.506064.com/n/184537.html