悬浮窗 (Floaty)

6.7.0 源码校对

本页已按 AutoJs6 6.7.0 (ed3eb10e88db5a8425fd94bdddefa4176e5e1c94) 对照以下源码路径校对:

app/src/main/java/org/autojs/autojs/runtime/ScriptRuntime.kt
app/src/main/java/org/autojs/autojs/runtime/api/augment/floaty/Floaty.kt
app/src/main/java/org/autojs/autojs/runtime/api/Floaty.kt
app/src/main/java/org/autojs/autojs/core/floaty/BaseResizableFloatyWindow.kt
app/src/main/java/org/autojs/autojs/core/floaty/RawWindow.kt
app/src/main/java/org/autojs/autojs/permission/DisplayOverOtherAppsPermission.kt

运行时中 floaty / $floaty 由 augment 注入. 当前公开入口包括 window, rawWindow, hasPermission, requestPermission, ensurePermission, closeAll, getClip.

Rhino 公开入口的 window(layout) / rawWindow(layout) 只接受 XML / XML 字符串布局, 源码会从 XMLObject / XMLList 或字符串构建布局; 不接受已创建的 Android View 对象.

创建悬浮窗前会检查并等待悬浮窗权限, 最多约 60 秒; ensurePermission() 在无权限时直接抛错. getClip(maxDelayAfterWindowReady?) 会借助悬浮窗在较新 Android 系统上读取剪贴板, 默认最大等待 500ms.

window 返回可调整窗口, rawWindow 返回原始窗口. 两者共有 setPosition, setSize, requestFocus, disableFocus, close, exitOnClose 和 x, y, width, height; rawWindow 额外公开 setTouchable, window 额外公开调整开关相关属性 / setter.

floaty模块提供了悬浮窗的相关函数, 可以在屏幕上显示自定义悬浮窗, 控制悬浮窗大小、位置等.

悬浮窗在脚本停止运行时会自动关闭, 因此, 要保持悬浮窗不被关闭, 可以用一个空的setInterval来实现, 例如：

setInterval(()=>{}, 1000);

floaty.window(layout)

layout {xml} | {string} 悬浮窗界面的 XML 或 XML 字符串

指定悬浮窗的布局, 创建并显示一个悬浮窗, 返回一个FloatyWindow对象.

该悬浮窗自带关闭、调整大小、调整位置按键, 可根据需要调用setAdjustEnabled()函数来显示或隐藏.

其中 layout 参数可以是 XML 布局或 XML 字符串, 更多信息参见 ui 模块的说明.

例子：

var w = floaty.window(
    <frame gravity="center">
        <text id="text">悬浮文字</text>
    </frame>
);
setTimeout(()=>{
    w.close();
}, 2000);

这段代码运行后将会在屏幕上显示悬浮文字, 并在两秒后消失.

另外, 因为脚本运行的线程不是UI线程, 而所有对控件的修改操作需要在UI线程执行, 此时需要用ui.run, 例如:

ui.run(function(){
    w.text.setText("文本");
});

有关返回的FloatyWindow对象的说明, 参见下面的FloatyWindow章节.

floaty.rawWindow(layout)

layout {xml} | {string} 悬浮窗界面的 XML 或 XML 字符串

指定悬浮窗的布局, 创建并显示一个原始悬浮窗, 返回一个FloatyRawWindow对象.

与floaty.window()函数不同的是, 该悬浮窗不会增加任何额外设施（例如调整大小、位置按钮）, 您可以根据自己需要编写任何布局.

而且, 该悬浮窗支持完全全屏, 可以覆盖状态栏, 因此可以做护眼模式之类的应用.

var w = floaty.rawWindow(
    <frame gravity="center">
        <text id="text">悬浮文字</text>
    </frame>
);

w.setPosition(500, 500);

setTimeout(()=>{
    w.close();
}, 2000);

这段代码运行后将会在屏幕上显示悬浮文字, 并在两秒后消失.

有关返回的FloatyRawWindow对象的说明, 参见下面的FloatyRawWindow章节.

floaty.closeAll()

关闭所有本脚本的悬浮窗.

FloatyWindow

悬浮窗对象, 可通过FloatyWindow.{id}获取悬浮窗界面上的元素. 例如, 悬浮窗window上一个控件的id为aaa, 那么window.aaa即可获取到该控件, 类似于ui.

window.setAdjustEnabled(enabled)

enabled {boolean} 是否启用悬浮窗调整(大小、位置)

如果enabled为true, 则在悬浮窗左上角、右上角显示可供位置、大小调整的标示, 就像控制台一样；如果enabled为false, 则隐藏上述标示.

window.setPosition(x, y)

x {number} x
x {number} y

设置悬浮窗位置.

window.getX()

返回悬浮窗位置的X坐标.

window.getY()

返回悬浮窗位置的Y坐标.

window.setSize(width, height)

width {number} 宽度
height {number} 高度

设置悬浮窗宽高.

window.getWidth()

返回悬浮窗宽度.

window.getHeight()

返回悬浮窗高度.

window.close()

关闭悬浮窗. 如果悬浮窗已经是关闭状态, 则此函数将不执行任何操作.

被关闭后的悬浮窗不能再显示.

window.exitOnClose()

使悬浮窗被关闭时自动结束脚本运行.

FloatyRawWindow

原始悬浮窗对象, 可通过window.{id}获取悬浮窗界面上的元素. 例如, 悬浮窗window上一个控件的id为aaa, 那么window.aaa即可获取到该控件, 类似于ui.

window.setTouchable(touchable)

touchable {Boolean} 是否可触摸

设置悬浮窗是否可触摸, 如果为true, 则悬浮窗将接收到触摸、点击等事件并且无法继续传递到悬浮窗下面；如果为false, 悬浮窗上的触摸、点击等事件将被直接传递到悬浮窗下面. 处于安全考虑, 被悬浮窗接收的触摸事情无法再继续传递到下层.

可以用此特性来制作护眼模式脚本.

var w = floaty.rawWindow(
    <frame gravity="center" bg="#44ffcc00"/>
);

w.setSize(-1, -1);
w.setTouchable(false);

setTimeout(()=>{
    w.close();
}, 4000);