工具窗口

JS

const core = require('cheese-js');

Lua

local core = require('cheese-lua')

悬浮控制台:floatingConsole(): IToolWindowClient ✅

用法示例:

JS

const core = require('cheese-js'); //导入核心模块
const toolwindow = core.toolwindow;
toolwindow.floatingConsole().show() //显示悬浮控制台
toolwindow.floatingConsole().hide() //隐藏悬浮控制台
toolwindow.floatingConsole().cancel() //销毁悬浮控制台

Lua

local core = require('cheese-lua')
local toolwindow = core.toolwindow
local console = toolwindow.floatingConsole()
console:show()
console:hide()
console:cancel()

悬浮日志:floatingLogcat(): IConsoleClient ✅

用法示例:

JS

const core = require('cheese-js'); //导入核心模块
const toolwindow = core.toolwindow;
toolwindow.floatingLogcat().show() //显示悬浮日志窗
toolwindow.floatingLogcat().hide() //隐藏悬浮日志窗
toolwindow.floatingLogcat().clear() //清楚悬浮日志窗日志内容
toolwindow.floatingLogcat().destroy() //销毁悬浮日志窗
toolwindow.floatingLogcat().setTouch(true) //设置悬浮窗是否可触摸
toolwindow.floatingLogcat().setTextSize(1) //设置悬浮窗日志文字大小

Lua

local core = require('cheese-lua')
local toolwindow = core.toolwindow
local logcat = toolwindow.floatingLogcat()
logcat:show()
logcat:hide()
logcat:clear()
logcat:destroy()
logcat:setTouch(true)
logcat:setTextSize(1)

创建浮动内容层句柄:createFloatingContentOverlay(): number ✅

说明:

• 成功时返回浮动内容层 id

参数:

• 无

用法示例:

JS

const core = require('cheese-js');
const toolwindow = core.toolwindow;
const overlayId = toolwindow.createFloatingContentOverlay();
console.log("overlayId", overlayId);

Lua

local core = require('cheese-lua')
local toolwindow = core.toolwindow
local overlayId = toolwindow.createFloatingContentOverlay()
print("overlayId", overlayId)

动态更新浮动内容层:updateFloatingContentOverlay(id: number, text: string, size: number, color: string, bg: string, pos: number, x: number, y: number, width: number, height: number, leftPadding?: number, topPadding?: number, rightPadding?: number, bottomPadding?: number, alignText?: number): boolean ✅

说明:

• 可在创建后重复调用，实现同一个句柄的实时更新（文本、颜色、背景图、位置、尺寸等）

参数:

• ⭐number (id): 浮动内容层 id
• ⭐string (text): 要显示的文本内容
• ⭐number (size): 字号（例如 16）
• ⭐string (color): 文本颜色，支持 #AARRGGBB / #RRGGBB / 0xAARRGGBB
• ⭐string (bg): 背景，支持颜色字符串或图片路径
• ⭐number (pos): 浮层锚点位置
• ⭐number (x): 相对 pos 锚点的 X 偏移（像素）
• ⭐number (y): 相对 pos 锚点的 Y 偏移（像素）
• ⭐number (width): 浮层宽度，<=0 表示内容自适应
• ⭐number (height): 浮层高度，<=0 表示内容自适应
• number (leftPadding): 左内边距，默认 3
• number (topPadding): 上内边距，默认 3
• number (rightPadding): 右内边距，默认 3
• number (bottomPadding): 下内边距，默认 3
• number (alignText): 文本对齐方式，默认 1

pos 取值说明:

• 0: 左上
• 1: 居中
• 2: 上中
• 3: 左中
• 其他值: 按 0（左上）处理

alignText 取值说明:

• 0: 左上
• 1: 居中（默认）
• 2: 上中
• 3: 左中
• 4: 左下
• 5: 右上
• 6: 右中
• 7: 右下
• 8: 下中

bg 参数说明:

• 传颜色：如 "#66000000"、"#FF00FF00"、"0xCC111111"
• 传图片：可用绝对路径，或 assets / main/lua 下的文件名（例如 "status_bg.png"）

返回值:

• 🟢boolean: true
• 🔴boolean: false

用法示例:

JS

const core = require('cheese-js');
const toolwindow = core.toolwindow;
const overlayId = toolwindow.createFloatingContentOverlay();
toolwindow.updateFloatingContentOverlay(
    overlayId,
    "运行中（可实时刷新）",
    16,
    "#00FF00",
    "status_bg.png",
    0,
    100,
    220,
    320,
    90
);

Lua

local core = require('cheese-lua')
local toolwindow = core.toolwindow
local overlayId = toolwindow.createFloatingContentOverlay()
toolwindow.updateFloatingContentOverlay(
    overlayId,
    "运行中（可实时刷新）",
    16,
    "#00FF00",
    "status_bg.png",
    0,
    100,
    220,
    320,
    90
)

隐藏浮动内容层:hideFloatingContentOverlay(id: number): boolean ✅

参数:

• ⭐number (id): 浮动内容层id

返回值:

• 🟢boolean: true
• 🔴boolean: false

用法示例:

JS

const core = require('cheese-js');
const toolwindow = core.toolwindow;
const overlayId = toolwindow.createFloatingContentOverlay();
toolwindow.updateFloatingContentOverlay(overlayId, "test", 16, "#FFFFFF", "#66000000", 0, 100, 200, 300, 80);
console.log(toolwindow.hideFloatingContentOverlay(overlayId));

Lua

local core = require('cheese-lua')
local toolwindow = core.toolwindow
local overlayId = toolwindow.createFloatingContentOverlay()
toolwindow.updateFloatingContentOverlay(overlayId, "test", 16, "#FFFFFF", "#66000000", 0, 100, 200, 300, 80)
print(toolwindow.hideFloatingContentOverlay(overlayId))