AutoJs6

- Overview - 综述
- About - 关于文档
- Progress - 文档部署进度
- Changelog - 文档更新日志

- Manual - AutoJs6 使用手册
- Q & A - 疑难解答

- Global - 全局对象
- Automator - 自动化
- AutoJs6 - 本体应用
- App - 通用应用
- Color - 颜色
- Image - 图像
- OCR - 光学字符识别
- Barcode - 条码
- QR Code - 二维码
- Keys - 按键
- Device - 设备
- Storage - 储存
- File - 文件
- Engine - 引擎
- Task - 任务
- Module - 模块
- Plugins - 插件
- Toast - 消息浮动框
- Notice - 消息通知
- Console - 控制台
- Shell
- Shizuku
- Media - 多媒体
- Sensor - 传感器
- Recorder - 记录器
- Timer - 定时器
- Thread - 线程
- Continuation - 协程
- Event - 事件监听
- Dialog - 对话框
- Floaty - 悬浮窗
- Canvas - 画布
- UI - 用户界面
- Web - 万维网
- HTTP
- Base64
- Crypto - 密文
- OpenCC - 中文转换
- Internationalization - 国际化
- Standardization - 标准化
- E4X

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- WebSocket
- EventEmitter - 事件发射器
- ImageWrapper - 包装图像类
- App - 应用枚举类
- Color - 颜色类
- Version - 版本工具类
- Polyfill - 代码填泥
- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

- Exceptions - 异常
- Intent - 意图
- Runtime - 运行时
- Context - 上下文
- Activity - 活动

- Scripting Java - 脚本化 Java
- Android API Level - 安卓 API 级别
- Color Table - 颜色列表

- Glossaries - 术语
- HttpHeader - HTTP 标头
- HttpRequestMethods - HTTP 请求方法
- MimeType - MIME 类型
- NotificationChannel - 通知渠道

- Data Types - 数据类型
- Omnipotent Types - 全能类型
- Storage - 存储类
- AndroidBundle
- AndroidRect
- CryptoCipherOptions
- CryptoKey
- CryptoKeyPair
- ConsoleBuildOptions
- HttpRequestBuilderOptions
- HttpRequestHeaders
- HttpResponseBody
- HttpResponseHeaders
- HttpResponse
- InjectableWebClient
- InjectableWebView
- NoticeOptions
- NoticeChannelOptions
- NoticePresetConfiguration
- NoticeBuilder
- Okhttp3HttpUrl
- OcrOptions
- Okhttp3Request
- OpenCVPoint
- OpenCVRect
- OpenCVSize
- OpenCCConversion

- GitHub - 应用项目地址
- GitHub - 文档项目地址

# ConsoleBuildOptions#

ConsoleBuildOptions 是一个显示控制台浮动窗口时用于设置窗口选项的接口.
这些选项将影响控制台浮动窗口的 [ 日志内容样式 / 标题样式 / 窗口尺寸 / 窗口位置 ] 等.

常见相关方法或属性:

- console.build(options)

ConsoleBuildOptions

## [p?] size#

- { [ width: number, height: number ] } - 浮动窗口尺寸

设置控制台浮动窗口的尺寸.

    /* 宽 500 像素, 高 800 像素. */
    console.build({ size: [ 500, 800 ] }).show();

    /* 宽 60% 屏幕宽度, 高 70% 屏幕高度. */
    console.build({ size: [ 0.6, 0.7 ] }).show();

## [p?] position#

- { [ x: number, y: number ] } - 浮动窗口位置

设置控制台浮动窗口的位置.

    /* X 坐标 150 像素, Y 坐标 100 像素. */
    console.build({ position: [ 150, 100 ] }).show();

    /* X 坐标 20% 屏幕宽度, Y 坐标 10% 屏幕高度. */
    console.build({ position: [ 0.2, 0.1 ] }).show();

## [p?] exitOnClose#

- [ `false` ] { number | boolean } - 浮动窗口自动关闭的超时时间或启用状态

设置控制台浮动窗口在脚本结束时自动关闭的超时时间或启用状态.

    /* 脚本结束时 6 秒后自动关闭浮动窗口. */
    console.build({ exitOnClose: 6e3 }).show();

    /* 脚本结束时立即自动关闭浮动窗口. */
    console.build({ exitOnClose: 0 }).show();

    /* 禁用浮动窗口自动关闭. */
    console.build({ exitOnClose: false }).show();

`exitOnClose` 设置为 `true` 时, 相当于 `exitOnClose(5e3)`, 即脚本结束时浮动窗口在 `5` 秒钟后自动关闭.

## [p?] touchable#

- [ `true` ] { boolean } - 是否响应点击事件

设置控制台浮动窗口是否响应点击事件, 默认为 `true`.

如需穿透点击, 可设置为 `false`.

    /* 点击事件将穿透控制台浮动窗口. */
    console.build({ touchable: false }).show();

当设置 `touchable` 为 `false` 时, 浮动窗口顶部的关闭按钮将无法通过点击触发, 此时可借助 hide 或 setExitOnClose 等代码方式实现浮动窗口关闭. 详见 console.setTouchable 小节.

## [p?] title#

- { string } - 浮动窗口标题文本

设置控制台浮动窗口的标题文本.

    console.build({ title: '空调温度监测' }).show();

## [p?] titleTextSize#

- { number } - 浮动窗口标题文本字体大小

设置控制台浮动窗口的标题文本字体大小, 单位 `sp`.

    /* 设置标题字体大小为 20sp. */
    console.build({ titleTextSize: 20 }).show();

## [p?] titleTextColor#

- { OmniColor } - 浮动窗口标题文本字体颜色

设置控制台浮动窗口的标题文本字体颜色.

    /* 设置标题字体颜色为深橙色. */
    console.build({ titleTextColor: 'dark-orange' }).show();

## [p?] titleBackgroundColor#

- { OmniColor } - 浮动窗口标题显示区域背景颜色

设置控制台浮动窗口的标题显示区域背景颜色.

    /* 设置标题显示区域背景颜色为深蓝色. */
    console.build({ titleBackgroundColor: 'dark-blue' }).show();

    /* 设置标题显示区域背景颜色为半透明深蓝色. */
    console.build({ titleBackgroundColor: Color('dark-blue').setAlpha(0.5) }).show();
    console.build({ titleBackgroundColor: '#8000008B' }).show(); /* 效果同上. */

    /* 透明度也可使用 titleBackgroundAlpha 单独设置. */
    console.build({
        titleBackgroundColor: 'dark-blue',
        titleBackgroundAlpha: 0.5,
    }).show();

## [p?] titleBackgroundAlpha#

- { number } - 浮动窗口标题显示区域背景颜色透明度

设置控制台浮动窗口的标题显示区域背景颜色透明度.

    /* 设置标题显示区域背景颜色为半透明. */
    console.build({ titleBackgroundAlpha: 0.5 }).show();

    /* 设置标题显示区域背景颜色为半透明深蓝色. */
    console.build({
        titleBackgroundColor: 'dark-blue',
        titleBackgroundAlpha: 0.5,
    }).show();

使用 `-1` 可重置标题区域的透明度 (为 `0.8`):

    console.build({ titleBackgroundAlpha: -1 }).show();

## [p?] titleIconsTint#

- { OmniColor } - 浮动窗口操作按钮着色

设置控制台浮动窗口的操作按钮着色.

    /* 设置操作按钮着色为绿色. */
    console.build({ titleIconsTint: 'green' }).show();

## [p?] contentTextSize#

- { number } - 浮动窗口日志文本字体大小

设置控制台浮动窗口的日志文本字体大小, 单位 `sp`.

    /* 设置日志文本字体大小为 18sp. */
    console.build({ contentTextSize: 18 }).show();

## [p?] contentTextColor#

`Overload 1/2`

- {{
  - verbose?: OmniColor;
  - log?: OmniColor;
  - info?: OmniColor;
  - warn?: OmniColor;
  - error?: OmniColor;
  - assert?: OmniColor;
- }} - 浮动窗口日志文本字体颜色

设置控制台浮动窗口的日志文本字体颜色, 按日志等级设置一个或多个不同的字体颜色.

    /* 设置 LOG 等级日志字体颜色为深橙色. */
    console.build({ contentTextColor: { log: 'dark-orange' } }).show();
    console.log('content text color test for console.log');

    /* 设置 ERROR 等级日志字体颜色为深红色. */
    console.build({ contentTextColor: { error: 'dark-red' } }).show();
    console.error('content text color test for console.error');

    /* 设置多个不同等级日志的字体颜色. */
    console.build({
        contentTextColor: {
            verbose: 'gray',
            log: 'white',
            info: 'light-green',
            warn: 'light-blue',
            error: 'red',
        }
    }).show();
    [ 'verbose', 'log', 'info', 'warn', 'error' ].forEach((fName) => {
        console[fName].call(console, `content text color test for console.${fName}`);
    });

`Overload 2/2`

- { OmniColor } - 浮动窗口日志文本统一字体颜色

使用 `{ contentTextColor: OmniColor }` 时, 不区分日志等级, 统一设置所有日志的文本颜色:

    /* 所有日志本文的颜色统一设置为深绿色. */
    console.build({
        contentTextColor: 'dark-green',
    }).show();
    [ 'verbose', 'log', 'info', 'warn', 'error' ].forEach((fName) => {
        console[fName].call(console, `content text color test for console.${fName}`);
    });

## [p?] contentBackgroundColor#

- { OmniColor } - 浮动窗口日志显示区域背景颜色

设置控制台浮动窗口的日志显示区域背景颜色.

    /* 设置日志显示区域背景颜色为深蓝色. */
    console.build({ contentBackgroundColor: 'dark-blue' }).show();

    /* 设置日志显示区域背景颜色为半透明深蓝色. */
    console.build({ contentBackgroundColor: Color('dark-blue').setAlpha(0.5) }).show();
    console.build({ contentBackgroundColor: '#8000008B' }).show(); /* 效果同上. */

    /* 透明度也可使用 contentBackgroundAlpha 单独设置. */
    console.build({
        contentBackgroundColor: 'dark-blue',
        contentBackgroundAlpha: 0.5,
    }).show();

## [p?] contentBackgroundAlpha#

- { number } - 浮动窗口日志显示区域背景颜色透明度

设置控制台浮动窗口的日志显示区域背景颜色透明度.

    /* 设置日志显示区域背景颜色为半透明. */
    console.build({ contentBackgroundAlpha: 0.5 }).show();

    /* 设置日志显示区域背景颜色为半透明深蓝色. */
    console.build({
        contentBackgroundColor: 'dark-blue',
        contentBackgroundAlpha: 0.5,
    }).show();

使用 `-1` 可重置日志区域的透明度 (为 `0.6`):

    console.build({ contentBackgroundAlpha: -1 }).show();

## [p?] textSize#

- { number } - 浮动窗口标题及日志文本字体大小

设置控制台浮动窗口的标题及日志文本字体大小, 单位 `sp`.

相当于 titleTextSize 和 contentTextSize 的集成.

    /* 设置标题及日志文本字体大小为 18sp. */
    console.build({ textSize: 18 }).show();

## [p?] textColor#

- OmniColor } - 浮动窗口标题及日志文本字体颜色

设置控制台浮动窗口的标题及日志文本字体颜色.

对于日志文本, 不区分等级, 统一设置字体颜色.

相当于 titleTextColor 和 contentTextColor 的集成.

    /* 所有标题及日志本文的颜色统一设置为浅蓝色. */
    console.build({
        textColor: 'light-blue',
    }).show();
    [ 'verbose', 'log', 'info', 'warn', 'error' ].forEach((fName) => {
        console[fName].call(console, ` text color test for console.${fName}`);
    });

## [p?] backgroundColor#

- { OmniColor } - 浮动窗口标题及日志显示区域背景颜色

设置控制台浮动窗口的标题及日志显示区域背景颜色.

相当于 titleBackgroundColor 和 contentBackgroundColor 的集成.

    /* 设置标题及日志显示区域背景颜色为浅黄色. */
    console.build({ backgroundColor: 'light-yellow' }).show();

    /* 设置标题及日志显示区域背景颜色为半透明浅黄色. */
    console.build({ backgroundColor: Color('light-yellow').setAlpha(0.5) }).show();
    console.build({ backgroundColor: '#80FFFFE0' }).show(); /* 效果同上. */

    /* 透明度也可使用 backgroundAlpha 单独设置. */
    console.build({
        backgroundColor: 'light-yellow',
        backgroundAlpha: 0.5,
    }).show();

## [p?] backgroundAlpha#

- { number } - 浮动窗口标题及日志显示区域背景颜色透明度

设置控制台浮动窗口的标题及日志显示区域背景颜色透明度.

相当于 titleBackgroundAlpha 和 contentBackgroundAlpha 的集成.

    /* 设置标题及日志显示区域背景颜色为半透明. */
    console.build({ backgroundAlpha: 0.5 }).show();

    /* 设置标题及日志显示区域背景颜色为半透明浅黄色. */
    console.build({
        backgroundColor: 'light-yellow',
        backgroundAlpha: 0.5,
    }).show();

使用 `-1` 可同时重置标题区域的透明度 (为 `0.8`), 以及日志区域的透明度 (为 `0.6`):

    console.build({ backgroundAlpha: -1 }).show();