Android 计时器Chronometer 使用及源码分析

Chronometer

        Chronometer是一个「简单的计时器」组件，继承自TextView。但是Chronometer「不显示当前时间」，它显示的是从某个起始时间开始，一共过去了多长时间。

主要XML属性如下：

• 「android:countDown」 是否倒计时，默认false。

• 「android:format」 设置显示时间格式。如果指定，第一个 「"%s"」 替换为"MM:SS"或"H:MM:SS"形式的当前计时器值。

常用方法

• 「start()」：开始计时

• 「stop()」：停止计时

• 「setBase(long)」：设置计时器起始时间。

• 「setFormat(String)」：设置显示时间格式

• 「setCountDown(boolean)」：设置是否是倒计时(SDK版本大于23)。

• 「setOnChronometerTickListener(OnChronometerTickListener)」：为计时器绑定事件监听，当计时器改变时触发该监听器。

示例

看上面介绍十分简单，咱们还是搞个实例了解一下吧，先看效果图。

主界面布局文件

        仅保留Chronometer相关布局

<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical"
    android:padding="@dimen/dimen_20">
    <Chronometer
        android:id="@+id/chronometer"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="@dimen/dimen_20"
        android:padding="@dimen/dimen_10"
        android:layout_gravity="center_horizontal"
        android:textColor="@color/color_188FFF" />
    <Chronometer
        android:id="@+id/ch_format"
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:textSize="@dimen/dimen_20"
        android:padding="@dimen/dimen_10"
        android:layout_gravity="center_horizontal"
        android:textColor="@color/color_ff0000" />
</LinearLayout>

主界面代码

public class ChronometerActivity extends AppCompatActivity implements View.OnClickListener {
    private Button btn_start,btn_stop,btn_reset,btn_format_1;
    private Chronometer chronometer,ch_format;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_textview_chronometer);//加载布局文件
        initView();
    }
    private void initView() {
        btn_start = findViewById(R.id.btn_start);
        btn_stop = findViewById(R.id.btn_stop);
        btn_reset = findViewById(R.id.btn_reset);
        chronometer = findViewById(R.id.chronometer);
        btn_start.setOnClickListener(this);
        btn_stop.setOnClickListener(this);
        btn_reset.setOnClickListener(this);
        chronometer.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @RequiresApi(api = Build.VERSION_CODES.N)
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                MLog.e(String.valueOf(chronometer.getBase()));
                //当前时间-基准时间>20秒
                if(SystemClock.elapsedRealtime()-chronometer.getBase()>20*1000)
                {
                    chronometer.setCountDown(true);
                }
            }
        });
 
        btn_format_1 = findViewById(R.id.btn_format_1);
        ch_format = findViewById(R.id.ch_format);
        btn_format_1.setOnClickListener(this);
        ch_format.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                //当前时间-基准时间
                long time = SystemClock.elapsedRealtime()-chronometer.getBase();
                Date d = new Date(time);
                SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss", Locale.US);
                sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
                //设置为HH:mm:ss格式
                ch_format.setText(sdf.format(d));
            }
        });
    }
 
    @RequiresApi(api = Build.VERSION_CODES.N)
    @Override
    public void onClick(View v) {
        switch (v.getId()){
            case R.id.btn_start:
                //SystemClock.elapsedRealtime(),自启动以来经过的毫秒数。
                //设置基准时间
                chronometer.setBase(SystemClock.elapsedRealtime());
                //true,倒计时
                chronometer.setCountDown(false);
                chronometer.setFormat("计时: %s 秒");
                //开始计时
                chronometer.start();
                break;
            case R.id.btn_stop:
                //结束计时
                chronometer.stop();
                //文字显示
                ch_format.setText("00:00");
                break;
            case R.id.btn_reset:
                //重置基准时间
                chronometer.setBase(SystemClock.elapsedRealtime());
                break;
            case R.id.btn_format_1:
                ch_format.setBase(SystemClock.elapsedRealtime());
                ch_format.setCountDown(false);
                ch_format.start();
                break;
        }
    }
}

Format格式修改

        将Format默认的显示格式是00:00(MM:SS),修改为00:00:00(H:MM:SS)的显示格式。

        只要Chronometer发生变化，「onChronometerTick」都会被触发，所以我们可以在触发后进行处理。得到我们想要显示样式。

        ch_format.setOnChronometerTickListener(new Chronometer.OnChronometerTickListener() {
            @Override
            public void onChronometerTick(Chronometer chronometer) {
                //当前时间-基准时间
                long time = SystemClock.elapsedRealtime()-chronometer.getBase();
                Date d = new Date(time);
                SimpleDateFormat sdf = new SimpleDateFormat("HH:mm:ss", Locale.US);
                sdf.setTimeZone(TimeZone.getTimeZone("UTC"));
                //设置为HH:mm:ss格式
                ch_format.setText(sdf.format(d));
            }
        });

源码分析

setBase()

public void setBase(long base) {
        //设置基准时间
        mBase = base;
        //触发监听事件
        dispatchChronometerTick();
        //修改当前界面
        updateText(SystemClock.elapsedRealtime());
    }

dispatchChronometerTick()

//触发监听事件
void dispatchChronometerTick() {
        if (mOnChronometerTickListener != null) {
            mOnChronometerTickListener.onChronometerTick(this);
        }
    }

updateText()

        「修改当前界面」，首先拿「当前时间和mBase时间作比较」，second是两种之间的「差值」。DateUtils把second格式化，一般是"MM:SS"或"H:MM:SS"，输出text。

        如果定义了format格式，利用Formatter将text进一步格式化。

//修改
private synchronized void updateText(long now) {
        mNow = now;
        long seconds = mCountDown ? mBase - now : now - mBase;
        seconds /= 1000;
        boolean negative = false;
        if (seconds < 0) {
            seconds = -seconds;
            negative = true;
        }
        String text = DateUtils.formatElapsedTime(mRecycle, seconds);
        if (negative) {
            text = getResources().getString(R.string.negative_duration, text);
        }
 
        if (mFormat != null) {
            Locale loc = Locale.getDefault();
            if (mFormatter == null || !loc.equals(mFormatterLocale)) {
                mFormatterLocale = loc;
                mFormatter = new Formatter(mFormatBuilder, loc);
            }
            mFormatBuilder.setLength(0);
            mFormatterArgs[0] = text;
            try {
                mFormatter.format(mFormat, mFormatterArgs);
                text = mFormatBuilder.toString();
            } catch (IllegalFormatException ex) {
                if (!mLogged) {
                    Log.w(TAG, "Illegal format string: " + mFormat);
                    mLogged = true;
                }
            }
        }
        setText(text);
    }

start()

public void start() {
        mStarted = true;
        updateRunning();
    }

stop()

public void stop() {
        mStarted = false;
        updateRunning();
    }

updateRunning()

「start()」 和「stop()」 方法修改了「mStarted」的状态，然后调用「updateRunning()」。 Chronometer状态由三部分组成，「mVisible」（Window是否可见）、「mStarted」(Chronometer开始计时)和「isShown」(View是否可见)。

如果状态变化，修改当前控件。

• updateText(long)修改界面。

• dispatchChronometerTick()触发监听事件。

• postDelayed(Runnable, long)在一秒后修改界面。

private void updateRunning() {
        boolean running = mVisible && mStarted && isShown();
        if (running != mRunning) {
            if (running) {
                updateText(SystemClock.elapsedRealtime());
                dispatchChronometerTick();
                postDelayed(mTickRunnable, 1000);
            } else {
                removeCallbacks(mTickRunnable);
            }
            mRunning = running;
        }
    }

setFormat(String)

    //默认"MM:SS"或"H:MM:SS"形式
    public void setFormat(String format) {
        mFormat = format;
        if (format != null && mFormatBuilder == null) {
            mFormatBuilder = new StringBuilder(format.length() * 2);
        }
    }

setCountDown()

public void setCountDown(boolean countDown) {
        mCountDown = countDown;
        updateText(SystemClock.elapsedRealtime());
    }

还有updateText()

当你setCountDown(true)时，直接在当前计时数值前加"-"。如:

• setCountDown(false)显示：计时器：「20」秒，

• setCountDown(true)显示：计时器：「-20」秒，

转载:https://blog.csdn.net/g984160547/article/details/119041328