Android基礎到進階UI 計時器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」秒，

以上就是本文的全部內容，希望對大家學習Android Chronometer有所幫助和啟發，

轉載請註明出處，本文鏈接：https://www.uj5u.com/yidong/290122.html

標籤：其他

上一篇：Android | APP設定啟動頁（Java）

下一篇：Android全面決議Handler