AutoJs6

AutoJs6 文档 - 6.6.4

索引 | 查看全部

消息浮动框 (Toast)#

toast 模块用于消息浮动框的 [ 显示 / 消除 / 定制 ] 等.

部分操作系统的 toast 消息可能无法按队列依次显示, 新的 toast 消息直接覆盖之前的 toast 消息.

可能出现上述异常的操作系统:

API 级别 28 (安卓 9) [P]
鸿蒙 (HarmonyOS) 2

部分机型需授予 "后台弹出页面" 权限才能正常显示 toast 消息.

可能依赖上述权限的设备及操作系统:

小米 (Xiaomi / Redmi / BlackShark) - MIUI / HyperOS
维沃 (VIVO / IQOO) - Funtouch OS / OriginOS
欧珀 (OPPO / Realme) - ColorOS

部分机型的 toast 消息正常显示依赖通知权限, 当未授予通知权限或通知被 阻止 (block) 时, toast 可能无法正常显示, 参阅 notice.isEnabled 小节.

toast

[@] toast#

toast 可作为全局对象使用:

typeof toast; // "function"
typeof toast.dismissAll; // "function"

toast(text)#

Global Overload 1/4 Async

text { string } - 消息内容
returns { void }

显示一个消息浮动框.

消息框的显示默认是依次进行的:

/* 显示消息框 2 秒钟. */
toast("hello");
/* 显示消息框 2 秒钟, 且在前一个消息框消失后才显示. */
toast("world");
/* 显示消息框 2 秒钟, 且在前一个消息框消失后才显示. */
toast("hello world");

toast(text, isLong)#

Global Overload 2/4 Async

text { string } - 消息内容
isLong = false { 'long' | 'l' | 'short' | 's' | boolean } - 是否以较长时间显示
returns { void }

控制单个消息框显示时长:

toast("hello", 'long'); /* 显示消息框 3.5 秒钟. */
toast("hello", true); /* 同上. */

注: 仅有 [ 长 / 短 ] 两种时长, 此时长由安卓系统决定.
通常, 短时为 2 秒, 长时为 3.5 秒.

toast(text, isLong, isForcible)#

Global Overload 3/4 Async

text { string } - 消息内容
isLong = false { 'long' | 'l' | 'short' | 's' | boolean } - 是否以较长时间显示
isForcible = false { 'forcible' | 'f' | boolean } - 是否强制覆盖显示
returns { void }

使用 "强制覆盖显示" 参数可立即显示消息框:

toast("hello");
/* 显示消息框 2 秒钟, 且立即显示, 前一个消息框 "hello" 被 "覆盖". */
toast("world", "short", "forcible");

注: 强制覆盖仅对当前脚本有效, 对其他脚本及应用程序无效.

toast(text, isForcible)#

Global Overload 4/4 Async

text { string } - 消息内容
isForcible { 'forcible' | 'f' } - 强制覆盖显示 (字符标识)
returns { void }

此方法相当于忽略 isLong 参数:

toast("hello");
/* 显示消息框 2 秒钟, 且立即显示, 前一个消息框 "hello" 被 "覆盖". */
toast("world", "forcible");

注: 此方法的 isForcible 参数只能为具有明确意义的字符标识, 不能为 boolean 类型或其他类型, 否则 isForcible 将被视为 isLong.

[m] dismissAll#

dismissAll()#

Global - returns { void }

强制消除所有由 AutoJs6 产生的消息框, 包括正在显示的及等待显示的.

使用方式:

toast.dismissAll(); /* 立即消除所有消息框. */

示例:

toast("hello");
toast("world");
toast("of");
toast("JavaScript");

sleep(1e3);

/* "hello" 显示 1 秒后消失, "world" 及其他消息框均不再显示. */
/* 若无 sleep 语句, 由于 toast 是异步的, 上述消息框均不会显示. */
toast.dismissAll();

/* dismissAll 仅对已在队列中的消息框有效, 因此下述消息框正常显示. */
toast("forcibly dismissed");

注: 强制取消显示仅对当前脚本有效, 对其他脚本及应用程序无效.

目录