AutoJs6

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

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

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

- UiSelector - 选择器
- UiObject - 控件节点
- UiObjectCollection - 控件集合
- UiObjectActions - 控件节点行为
- 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

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

# AutoJs6 本体应用#

autojs 全局对象主要包含与 AutoJs6 应用本身相关的属性及方法, 如获取 AutoJs6 的 [ Root 状态 / 语言标签 / 权限状态 ] 等.

autojs

## [m] getLanguage#

### getLanguage()#

`6.2.0`

- returns { java.util.Locale }

获取 AutoJs6 `语言` 设置选项.

此方法返回一个 java.util.Locale 对象, 如需返回其标签名, 如 `en-US`, `zh-CN` 等, 可使用 `autojs.getLanguage().toLanguageTag()` 或直接使用 autojs.getLanguageTag() 方法.

    console.log(autojs.getLanguage().getDisplayName()); /* e.g. 日本語 */

## [m] getLanguageTag#

### getLanguageTag()#

`6.2.0`

- returns { string }

获取 AutoJs6 语言设置选项.

此方法返回 IETF 语言标签, 相当于 `autojs.getLanguage().toLanguageTag()`:

    console.log(autojs.getLanguageTag()); /* e.g. en-US */

此方法可用于设定 i18n 对象的区域:

    i18n.setLocale(autojs.getLanguageTag());

## [m] isRootAvailable#

### isRootAvailable()#

`6.2.0`

- returns { boolean }

获取 AutoJs6 的 Root 权限有效性.

    console.log(autojs.isRootAvailable()); // e.g. true

注意上述示例的检测结果取决于 AutoJs6 的 `强制 Root 权限检查` 设置.
此设置可通过 AutoJs6 应用设置修改, 或 setRootMode 方法携带 `isWriteIntoPreference` 参数实现修改.

## [m] getRootMode#

### getRootMode()#

`6.2.0`

- returns { RootMode }

获取 AutoJs6 的 Root 权限状态.

     /* 是否为 '自动检测 Root 权限' 状态. */
    console.log(autojs.getRootMode() === RootMode.AUTO_DETECT);
    /* 是否为 '强制 Root 模式' 状态. */
    console.log(autojs.getRootMode() === RootMode.FORCE_ROOT);
    /* 是否为 '强制非 Root 模式' 状态. */
    console.log(autojs.getRootMode() === RootMode.FORCE_NON_ROOT);

## [m] setRootMode#

### setRootMode(rootMode, isWriteIntoPreference?)#

`6.2.0` `Overload [1-2]/2`

- rootMode { RootMode | number | boolean | 'auto' | 'root' | 'non-root' } - Root 模式参数
- [ isWriteIntoPreference = `false` ] { boolean } - 是否写入应用设置
- returns { void }

设置 AutoJs6 的 Root 模式.

默认情况下, AutoJs6 将根据 `su` 二进制名称特征来判断是否具有 Root 权限. 但有时设备可能使用了非常规 Root 方式或 Root 权限检测结果出现异常, 此时可设置 `强制 Root 模式` 或 `强制非 Root 模式` 来改变 AutoJs6 对 Root 权限的检测结果.

以设置 '强制 Root 模式' 为例:

    autojs.setRootMode(RootMode.FORCE_ROOT);
    autojs.setRootMode('root'); /* 同上. */
    autojs.setRootMode(1); /* 同上. */
    autojs.setRootMode(true); /* 同上. */

上述示例设置的 Root 模式, 将影响 isRootAvailable 的结果, 使其固定返回 `true`.
如果设置为 `RootMode.FORCE_NON_ROOT`, isRootAvailable 将固定返回 `false`.
如果设置为 `RootMode.AUTO_DETECT`, isRootAvailable 将根据 AutoJs6 是否具有 `su` 二进制名称特征决定其返回结果.

在没有特殊需求的情况下, 建议始终保持 Root 模式为 '自动' 模式.

需额外留意, Root 模式修改仅对当前 `运行时 (Runtime)` 有效, 当脚本结束时, 已设置的 Root 模式将自动还原为 '自动' 模式, 即 `RootMode.AUTO_DETECT`.

如需将保留修改的 Root 模式, 可使用 `isWriteIntoPreference` 参数, 修改将立即写入应用设置中:

    autojs.setRootMode(RootMode.FORCE_ROOT, true);

上述示例代码的效果, 等效于在 AutoJs6 应用中进行如下设置:

    [ AutoJs6 设置 ] - [ 强制 Root 权限检查 ] - [ 强制 Root 模式 ] # [ 选择 ]

## [m] canModifySystemSettings#

### canModifySystemSettings()#

`6.2.0`

- returns { boolean }

获取 AutoJs6 的 `修改系统设置` 权限状态.

    console.log(autojs.canModifySystemSettings()); // e.g. true

拥有 `修改系统设置` 后, AutoJs6 可以通过脚本修改部分系统设置, 如修改屏幕超时参数, 修改媒体音量值等.

## [m] canWriteSecureSettings#

### canWriteSecureSettings()#

`6.2.0`

- returns { boolean }

获取 AutoJs6 的 `修改安全设置` 权限状态.

    console.log(autojs.canWriteSecureSettings()); // e.g. true

拥有 `修改安全设置` 后, AutoJs6 可以通过脚本修改部分安全设置, 如修改屏幕常亮类别参数, 修改无障碍服务列表内容等.

## [m] canDisplayOverOtherApps#

### canDisplayOverOtherApps()#

`6.2.0`

- returns { boolean }

获取 AutoJs6 的 `显示在其他应用上层` 权限状态.

    console.log(autojs.canDisplayOverOtherApps()); // e.g. true

拥有 `显示在其他应用上层` 后, AutoJs6 可以使用悬浮窗工具, 并可通过脚本显示对话框或自定义浮动组件等.

## [p] versionName#

`6.2.0`

- { string }

获取版本名称.

    console.log(autojs.versionName); // e.g. 6.2.0-alpha9
    console.log(autojs.version.name); /* 同上. */

## [p] versionCode#

`6.2.0`

- { number }

获取版本号.

    console.log(autojs.versionCode); // e.g. 1545
    console.log(autojs.version.code); /* 同上. */

## [p] versionDate#

`6.2.0`

- { string }

获取版本日期.

    console.log(autojs.versionDate); // e.g. Dec 18, 2022
    console.log(autojs.version.date); /* 同上. */

## [p] themeColor#

### themeColor#

`6.3.0` `Getter`

- { ThemeColor }

获取 AutoJs6 的主题颜色实例.

    autojs.themeColor.getColorPrimary(); /* 获取 AutoJs6 主题色的主色色值. */

## [p+] version#

### [p] name#

`6.2.0`

- { string }

获取版本名称.

    console.log(autojs.version.name); // e.g. 6.2.0-alpha9
    console.log(autojs.versionName); /* 同上. */

### [p] code#

`6.2.0`

- { number }

获取版本号.

    console.log(autojs.version.code); // e.g. 1545
    console.log(autojs.versionCode); /* 同上. */

### [p] date#

`6.2.0`

- { string }

获取版本日期.

    console.log(autojs.version.date); // e.g. Dec 18, 2022
    console.log(autojs.versionDate); /* 同上. */

### [m] isEqual#

#### isEqual(otherVersion)#

`6.2.0`

- otherVersion { string | Version } - 待比较版本参数
- returns { boolean }

返回 AutoJs6 版本是否与参数对应的版本号等同.

    console.log(autojs.version.isEqual('6.2.0')); // e.g. true

### [m] isHigherThan#

#### isHigherThan(otherVersion)#

`6.2.0`

- otherVersion { string | Version } - 待比较版本参数
- returns { boolean }

返回 AutoJs6 版本是否高于待比较版本.

    console.log(autojs.version.isHigherThan('6.1.3')); // e.g. true

### [m] isLowerThan#

#### isLowerThan(otherVersion)#

`6.2.0`

- otherVersion { string | Version } - 待比较版本参数
- returns { boolean }

返回 AutoJs6 版本是否低于待比较版本.

    console.log(autojs.version.isLowerThan('6.2.0')); // e.g. true

### [m] isAtLeast#

#### isAtLeast(otherVersion)#

`6.2.0` `Overload 1/2`

- otherVersion { string | Version } - 待比较版本参数
- returns { boolean }

返回 AutoJs6 版本是否不低于 (即大于等于) 参数对应的版本号.

    console.log(autojs.version.isAtLeast('6.1.3')); // e.g. true

#### isAtLeast(otherVersion, ignoreSuffix)#

`6.2.0` `Overload 2/2`

- otherVersion { string | Version } - 待比较版本参数
- [ ignoreSuffix = `false` ] { boolean } - 是否忽略版本后缀
- returns { boolean }

返回 AutoJs6 版本是否不低于 (即大于等于) 参数对应的版本号且根据 `ignoreSuffix` 参数决定是否忽略版本后缀.

    console.log(autojs.version.name); // e.g. 6.2.0-alpha9
    console.log(autojs.version.isAtLeast('6.2.0')); // e.g. false
    console.log(autojs.version.isAtLeast('6.2.0', true)); // e.g. true

## [p+] R#

使用 R 类的子类中的静态整数可访问相应的应用资源, 如 `R.string` 访问字符串资源, `R.drawable` 访问可绘制资源等.

global.R 的别名属性, 参阅 全局对象 (Global) 章节.