feat(DevAssist): 新增 DevTimerAssist

Former-commit-id: 0dc5847

lib/DevAssist/src/main/java/dev/assist/DevTimerAssist.java

@@ -0,0 +1,185 @@
+package dev.assist;
+
+import android.os.Handler;
+
+import java.util.concurrent.atomic.AtomicLong;
+
+import dev.utils.app.timer.DevTimer;
+
+/**
+ * detail: 定时器辅助类
+ * @author Ttt
+ * <pre>
+ *     在 {@link DevTimer} 基础上实现, 经过指定时长后进行通知处理
+ * </pre>
+ */
+public class DevTimerAssist {
+
+    // 总时长 ( 毫秒 )
+    private final AtomicLong        mDuration = new AtomicLong();
+    // 循环时间 ( 每隔多少毫秒执行一次 )
+    private final long              mPeriod;
+    // 定时器 TAG
+    private       String            mTag;
+    // UI Handler
+    private       Handler           mHandler;
+    // 回调方法
+    private       DevTimer.Callback mCallback;
+    // 当前定时器
+    private       DevTimer          mTimer;
+
+    /**
+     * 构造函数
+     * @param duration 总时长
+     */
+    public DevTimerAssist(long duration) {
+        this(duration, 100L);
+    }
+
+    /**
+     * 构造函数
+     * @param duration 总时长
+     * @param period   循环时间 ( 每隔多少毫秒执行一次 )
+     */
+    public DevTimerAssist(
+            long duration,
+            long period
+    ) {
+        this.mDuration.set(duration);
+        this.mPeriod = period;
+    }
+
+    // =============
+    // = 对外公开方法 =
+    // =============
+
+    /**
+     * 设置 TAG
+     * @param tag TAG
+     * @return {@link DevTimerAssist}
+     */
+    public DevTimerAssist setTag(final String tag) {
+        if (mTimer == null) {
+            mTag = tag;
+        }
+        return this;
+    }
+
+    /**
+     * 设置 UI Handler
+     * <pre>
+     *     如果没设置 Handler 回调方法则属于非 UI 线程
+     * </pre>
+     * @param handler {@link Handler}
+     * @return {@link DevTimerAssist}
+     */
+    public DevTimerAssist setHandler(final Handler handler) {
+        if (mTimer == null) {
+            mHandler = handler;
+        }
+        return this;
+    }
+
+    /**
+     * 设置回调事件
+     * @param callback {@link DevTimer.Callback}
+     * @return {@link DevTimerAssist}
+     */
+    public DevTimerAssist setCallback(final DevTimer.Callback callback) {
+        if (mTimer == null) {
+            mCallback = callback;
+        }
+        return this;
+    }
+
+    /**
+     * 获取定时器
+     * @return {@link DevTimer}
+     */
+    public DevTimer getTimer() {
+        if (mTimer == null) {
+            mTimer = createTimer();
+        }
+        return mTimer;
+    }
+
+    // ==========
+    // = 核心方法 =
+    // ==========
+
+    /**
+     * 运行定时器
+     * @return {@link DevTimerAssist}
+     */
+    public DevTimerAssist start() {
+        if (!isDurationEnd()) {
+            getTimer().start();
+        }
+        return this;
+    }
+
+    /**
+     * 关闭定时器
+     * @return {@link DevTimerAssist}
+     */
+    public DevTimerAssist stop() {
+        if (!isDurationEnd()) {
+            getTimer().stop();
+        }
+        return this;
+    }
+
+    // ==========
+    // = 内部方法 =
+    // ==========
+
+    // 内部 Callback
+    private final DevTimer.Callback mInnerCallback = new DevTimer.Callback() {
+        @Override
+        public void callback(
+                DevTimer timer,
+                int number,
+                boolean end,
+                boolean infinite
+        ) {
+            long result = mDuration.addAndGet(-mPeriod);
+            if (result <= 0L) {
+                timer.stop();
+                if (mCallback != null) {
+                    mCallback.callback(timer, number, true, infinite);
+                }
+                return;
+            }
+            if (mCallback != null) {
+                mCallback.callback(timer, number, false, infinite);
+            }
+        }
+    };
+
+    /**
+     * 创建定时器
+     * @return {@link DevTimer}
+     */
+    private DevTimer createTimer() {
+        return new DevTimer.Builder(mPeriod, mPeriod)
+                .setTag(mTag).build()
+                .setCallback(mInnerCallback)
+                .setHandler(mHandler);
+    }
+
+    /**
+     * 是否总时长已结束
+     * @return {@code true} yes, {@code false} no
+     */
+    private boolean isDurationEnd() {
+        long result = mDuration.get();
+        if (result <= 0L) {
+            getTimer().stop();
+            if (mCallback != null) {
+                mCallback.callback(mTimer, 0, true, true);
+            }
+            return true;
+        }
+        return false;
+    }
+}

lib/DevEngine/build.gradle

@@ -25,6 +25,7 @@ dependencies {
     api deps.lib.glide
     // Gson https://github.com/google/gson
     api deps.lib.gson
+    kapt deps.lib.glide_compiler
     // Fastjson2 https://github.com/alibaba/fastjson2
     api deps.lib.fastjson2_android
     // 基于 mmap 的高性能通用 key-value 组件 https://github.com/Tencent/MMKV/blob/master/README_CN.md

lib/DevEngine/src/main/java/dev/engine/media/MediaData.kt

@@ -131,9 +131,9 @@ open class MediaData : IMediaEngine.EngineData {
     // 是否压缩状态
     private var mCompressState = false
 
-    // ==============
+    // =============
     // = 对外公开方法 =
-    // ==============
+    // =============
 
     /**
      * 获取可用资源 Uri