修改 Toast 跨页面显示的实现方式

优化框架获取 Toast 默认延迟时间

Author: getActivity

HelpDoc-en.md

@@ -157,7 +157,7 @@ public class ToastStrategy {
 ToastParams params = new ToastParams();
 params.text = "I am a Toast that can be displayed across pages";
 // Indicates that this Toast needs to be displayed across pages
-params.crossPageShow = true;
+params.priorityType = ToastParams.PRIORITY_TYPE_GLOBAL;
 Toaster.show(params);
 
 #### Why the framework prefers to use window manager to implement toast

HelpDoc-zh.md

@@ -173,7 +173,7 @@ public class ToastStrategy {
 ToastParams params = new ToastParams();
 params.text = "我是一个能跨页面展示的 Toast";
 // 表示这个 Toast 需要跨页面展示
-params.crossPageShow = true;
+params.priorityType = ToastParams.PRIORITY_TYPE_GLOBAL;
 Toaster.show(params);
 ```
 

app/src/main/java/com/hjq/toast/demo/MainActivity.java

@@ -60,7 +60,7 @@ public void showLongToast(View v) {
     public void showCrossPageToast(View v) {
         ToastParams params = new ToastParams();
         params.text = getString(R.string.demo_show_cross_page_toast_result);
-        params.crossPageShow = true;
+        params.priorityType = ToastParams.PRIORITY_TYPE_GLOBAL;
         Toaster.show(params);
     }
 

library/src/main/java/com/hjq/toast/ToastParams.java

@@ -12,6 +12,13 @@
  */
 public class ToastParams {
 
+    /** 优先级类型：框架默认选择最优方案来显示，具体实现可以看一下 {@link ToastStrategy#createToast(ToastParams)} */
+    public static final int PRIORITY_TYPE_DEFAULT = 0;
+    /** 优先级类型：优先使用全局级 Toast 来显示（显示在所有应用上面，可能需要通知栏权限或者悬浮窗权限） */
+    public static final int PRIORITY_TYPE_GLOBAL = 1;
+    /** 优先级类型：优先使用局部的 Toast 来显示（显示在当前 Activity） */
+    public static final int PRIORITY_TYPE_LOCAL = 2;
+
     /** 显示的文本 */
     public CharSequence text;
 
@@ -26,8 +33,8 @@ public class ToastParams {
     /** 延迟显示时间 */
     public long delayMillis = 0;
 
-    /** 是否跨页面展示（如果为 true 则优先用系统 Toast 实现） */
-    public boolean crossPageShow;
+    /** 优先级类型 */
+    public int priorityType = PRIORITY_TYPE_DEFAULT;
 
     /** Toast 样式 */
     public IToastStyle<?> style;

library/src/main/java/com/hjq/toast/ToastStrategy.java

@@ -97,11 +97,15 @@ public int computeShowDuration(CharSequence text) {
     public IToast createToast(ToastParams params) {
         Activity foregroundActivity = getForegroundActivity();
         IToast toast;
-        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&
+        if ((params.priorityType == ToastParams.PRIORITY_TYPE_DEFAULT ||
+             params.priorityType == ToastParams.PRIORITY_TYPE_GLOBAL) &&
+                Build.VERSION.SDK_INT >= Build.VERSION_CODES.M &&
                 Settings.canDrawOverlays(mApplication)) {
             // 如果有悬浮窗权限，就开启全局的 Toast
             toast = new GlobalToast(mApplication);
-        } else if (!params.crossPageShow && isActivityAvailable(foregroundActivity)) {
+        } else if ((params.priorityType == ToastParams.PRIORITY_TYPE_DEFAULT ||
+                    params.priorityType == ToastParams.PRIORITY_TYPE_LOCAL) &&
+                    isActivityAvailable(foregroundActivity)) {
             // 如果没有悬浮窗权限，就开启一个依附于 Activity 的 Toast
             toast = new ActivityToast(foregroundActivity);
         } else if (Build.VERSION.SDK_INT == Build.VERSION_CODES.N_MR1) {
@@ -131,13 +135,13 @@ public void showToast(ToastParams params) {
             case SHOW_STRATEGY_TYPE_IMMEDIATELY: {
                 // 移除之前未显示的 Toast 消息
                 cancelToast();
-                long uptimeMillis = SystemClock.uptimeMillis() + params.delayMillis + (params.crossPageShow ? 0 : getDefaultDelayTime());
+                long uptimeMillis = SystemClock.uptimeMillis() + params.delayMillis + generateShowDelayTime(params);
                 HANDLER.postAtTime(new ShowToastRunnable(params), mShowMessageToken, uptimeMillis);
                 break;
             }
             case SHOW_STRATEGY_TYPE_QUEUE: {
                 // 计算出这个 Toast 显示时间
-                long showToastMillis = SystemClock.uptimeMillis() + params.delayMillis + (params.crossPageShow ? 0 : getDefaultDelayTime());
+                long showToastMillis = SystemClock.uptimeMillis() + params.delayMillis + generateShowDelayTime(params);
                 // 根据吐司的长短计算出等待时间
                 long waitMillis = generateToastWaitMillis(params);
                 // 如果当前显示的时间在上一个 Toast 的显示范围之内
@@ -160,6 +164,20 @@ public void cancelToast() {
         HANDLER.postAtTime(new CancelToastRunnable(), mCancelMessageToken, uptimeMillis);
     }
 
+    /**
+     * 生成默认延迟时间
+     */
+    protected int generateShowDelayTime(ToastParams params) {
+        // 延迟一段时间之后再执行，因为在没有通知栏权限的情况下，Toast 只能显示在当前 Activity 上面（即使用 ActivityToast）
+        // 如果当前 Activity 在 showToast 之后立马进行 finish 了，那么这个时候 Toast 可能会显示不出来
+        // 因为 Toast 会显示在销毁 Activity 界面上，而不会显示在新跳转的 Activity 上面，所以会导致显示不出来的问题
+        // 另外有悬浮窗权限的情况下，使用全局的 Toast（即使用 GlobalToast），这种立刻显示也会有一些问题
+        // 我在小米 12 Android 12 的手机上面测试，从权限设置页返回的时候，发现 Toast 有几率会从左上的位置显示，然后会变回正常的位置
+        // 如果是系统的 Toast（即使用 SystemToast、SafeToast、NotificationToast 任意一个）则不会有这个问题
+        // 300 只是一个经验值，经过很多次验证得出来的值，当然你觉得这个值不是自己想要的，也可以重写此方法改成自己想要的
+        return 300;
+    }
+
     /**
      * 是否支持设置自定义 Toast 样式
      */
@@ -192,16 +210,6 @@ protected int generateToastWaitMillis(ToastParams params) {
         return 0;
     }
 
-    /**
-     * 获取默认延迟时间
-     */
-    protected int getDefaultDelayTime() {
-        // 延迟一段时间之后再执行，因为在没有通知栏权限的情况下，Toast 只能显示在当前 Activity 上面
-        // 如果当前 Activity 在 showToast 之后立马进行 finish 了，那么这个时候 Toast 可能会显示不出来
-        // 因为 Toast 会显示在销毁 Activity 界面上，而不会显示在新跳转的 Activity 上面
-        return 200;
-    }
-
     /**
      * 显示任务
      */