悬浮窗 Floaty 权限与使用——脚本运行状态的可视化入口

悬浮窗能做什么

悬浮窗是 Auto.js 的「操作面板」，它让你不用切回主界面就能：

• 查看当前脚本运行状态（运行中 / 已停止）
• 暂停 / 继续 / 终止正在运行的脚本
• 录制用户操作生成脚本
• 打开布局分析器查看当前界面控件树
• 快速查看任意应用的包名和当前 Activity

一个圆形小浮球常驻屏幕边缘，可以拖动位置。脚本没运行时显示「自动悬浮窗」，运行时变成「停止」按钮。

开启步骤

侧拉菜单 → 点击「悬浮窗」→ 系统会跳转到「显示在其他应用上层」的设置页面 → 找到 Auto.js → 打开开关。

开启后回到 Auto.js，再次点「悬浮窗」确认开关亮起——屏幕边缘应该立刻出现那个小浮球。

常见问题

打开悬浮窗开关但没看到浮球

• 检查「显示在其他应用上层」权限是否真的开了（部分 ROM 不会直接从 Auto.js 跳到正确页面）
• 部分系统对悬浮窗有权限分级：比如 MIUI 10 以上，普通悬浮窗和全屏悬浮窗是两个独立开关
• 重启 Auto.js 应用

部分界面悬浮窗会消失

全屏沉浸式应用（视频播放器、游戏）可能隐藏悬浮窗，这是正常的。回到普通应用界面会自动恢复。

代码中控制悬浮窗

脚本也可以自己创建和管理悬浮窗，用于显示状态或提供快捷操作：

// 创建一个简单的悬浮窗
var w = floaty.rawWindow(
  <frame gravity="center">
    <text id="status" text="脚本运行中" textColor="#fff" bg="#333"/>
  </frame>
);
w.setPosition(500, 1000);

这个能力可以用来做：

• 实时状态显示面板（如「当前页面」「剩余任务数」）
• 自定义控制按钮（暂停、继续、快进）
• 临时日志窗口（不依赖系统 Toast）

继续阅读：悬浮窗进阶