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 - 密文
- 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

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

# 插件 (Plugins)#

在 AutoJs6 中, 插件分为 [ 应用插件 / 项目插件 / 内置扩展插件 ].

plugins 模块主要用于插件及扩展模块的加载并使其功能生效.

## 应用插件#

应用插件通常是一个由开发者编写的可安装的 APK 文件, 安装插件后可由 AutoJs6 通过 plugins.load 方法加载并使用插件.

应用插件的使用步骤:

- 按需寻找或自行开发插件 (APK 格式)
- 安装到指定设备
- 脚本中将插件包名以字符串形式传入 plugins.load 方法并赋值给一个变量
- 这个变量即指向插件的导出对象 (module.exports)

加载及使用方式:

    let { exp } = plugins.load('org.autojs.autojs.plugin.demo');
    exp.test('hello');

## 项目插件#

项目插件是依附于项目的一组 JavaScript 模块, 它们位于项目根目录的 `plugins` 文件夹中, 由 AutoJs6 通过 plugins.load 方法加载并使用.

例如项目结构 (部分) 如下:

    ┌ modules ┬ moduleA.js
    │         └ moduleB.js
    │         ┌ pluginA.js
    ├ plugins ┼ pluginB.js
    │         └ pluginC.js
    └ main.js

对于此项目, `pluginA.js`, `pluginB.js` 及 `pluginC.js` 均称为项目插件, 加载方式如下:

    plugins.load('pluginA');
    plugins.load('pluginA.js'); /* 同上. */

## 内置扩展插件#

内置扩展插件相当于内置的项目插件, 它们是内置于 AutoJs6 软件中的, 可通过调用 plugins.extend 等方法选择性地启用部分或全部内置扩展插件, 也称作内置扩展模块.

加载方式:

    /* 启用 Array 内置扩展插件. */
    plugins.extend('Arrayx');

    /* 启用全部内置扩展插件. */
    plugins.extendAll();

截至 2023 年 2 月, AutoJs6 内置了以下扩展插件:

- Arrayx - Array 扩展
- Numberx - Number 扩展
- Mathx - Math 扩展

plugins

## [m] load#

### load(appPluginPackageName)#

`[6.2.0]` `Overload 1/2`

- packageName { string } - 应用插件的包名
- returns { any }

加载 应用插件.

    /* 一个可能的样例. */
    plugins.load('org.autojs.autojs.plugin.demo');

### load(projectPluginName)#

`6.2.0` `Overload 2/2`

- packageName { string } - 项目插件名称
- returns { any }

加载 项目插件.

## [m] extend#

### extend(...moduleNames)#

`6.2.0`

- moduleNames { ...ExtendModulesNames[] } - 内置扩展插件名称
- returns { void }

加载指定的 内置扩展插件.

    /* 启用 Array 内置扩展插件. */
    plugins.extend('Arrayx');

    /* 启用 Array 和 Number 内置扩展插件. */
    plugins.extend('Arrayx', 'Numberx');

## [m] extendAll#

### extendAll()#

`6.2.0`

- returns { void }

加载所有的 内置扩展插件.

    plugins.extendAll();

如需在所有脚本均自动加载所有内置扩展插件, 而无需每次使用 `plugins.extendAll()`, 可对 AutoJs6 进行如下设置:

    AutoJs6 应用设置 - 扩展性 - JavaScript 内置对象扩展 - [ 启用 ]

## [m] extendAllBut#

### extendAllBut(...moduleNames)#

`6.2.0`

- moduleNames { ...ExtendModulesNames[] } - 内置扩展插件名称
- returns { void }

加载所有的 内置扩展插件, 但排除指定的插件.

    plugins.extendAllBut('Mathx'); /* 加载除 Math 外的全部内置扩展插件. */