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 - 文档项目地址

# Shizuku#

此章节待补充或完善...

Marked by SuperMonster003 on Oct 30, 2023.

通过 Shizuku 可以获得 ADB 特权并使用系统 API.

使用 Shizuku 需满足以下全部条件

- 设备已安装 Shizuku 应用 (版本不低于 `11`)
- Shizuku 服务已启动 (参阅 Shizuku 用户手册)
- AutoJs6 首页抽屉开启 Shizuku 权限开关

shizuku

## [@] shizuku#

shizuku 可作为全局对象使用:

    typeof shizuku; // "function"
    typeof shizuku.execCommand; // "function"

### shizuku(cmd)#

`6.4.0` `Overload 1/2`

- cmd { string } - 待执行命令
- returns { ShellResult } - Shell 结果

使用 Shizuku 执行命令.

    /* 模拟返回键. */
    shizuku('input keyevent 4');
    shizuku(`input keyevent ${KeyEvent.KEYCODE_BACK}`); /* 同上. */

    /* 模拟电源键. */
    shizuku('input keyevent 26');
    shizuku(`input keyevent ${KeyEvent.KEYCODE_POWER}`); /* 同上. */

    /* 点击屏幕坐标 (100, 120). */
    shizuku('input tap 100 120');

    /* 授予 AutoJs6 "修改安全设置" 权限. */
    shizuku('pm grant org.autojs.autojs6 android.permission.WRITE_SECURE_SETTINGS');

    /* 授予 AutoJs6 "投影媒体" 权限. */
    shizuku('appops set org.autojs.autojs6 PROJECT_MEDIA allow');

    /* 获取当前时间. */
    console.log(shizuku('date').result.trim());

使用 shizuku 启用 AutoJs6 无障碍服务 (共计 4 步):

    /* [ 1. 获取无障碍服务列表, 列表是一个字符串, 不同无障碍服务之间以 ":" 分隔. ] */
    let services = shizuku('settings get secure enabled_accessibility_services').result.trim(); /* 结尾 "\n" 可通过 trim() 方法去除. */

    /* [ 2. 确保无障碍服务列表中不存在 AutoJs6. ] */
    let servicesWithoutAutoJs6 = services
        .split(':') /* 通过 ":" 分割, 获取无障碍服务数组. */
        .filter(it => !it.startsWith(`${autojs.packageName}/`)) /* 过滤可能的 AutoJs6 无障碍服务, 避免重复. */
        .join(':'); /* 重新组合过滤后的无障碍服务, 生成列表. */

    /* [ 3. 无障碍服务列表中加入 AutoJs6. ] */
    let servicesWithAutoJs6 = (() => {
        /* 无障碍服务格式: "包名/服务类名" */
        let serviceAutoJs6 = `${autojs.packageName}/${org.autojs.autojs.core.accessibility.AccessibilityServiceUsher.class.getName()}`;
        return servicesWithoutAutoJs6.length > 0 ? `${servicesWithoutAutoJs6}:${serviceAutoJs6}` : serviceAutoJs6;
    })();

    /* [ 4. 通过覆盖系统的无障碍物服列表, 使 AutoJs6 无障碍服务生效. ] */
    shizuku(`settings put secure enabled_accessibility_services ${servicesWithAutoJs6}`);

    /* 需特别留意, 如果只执行 shizuku(`settings put secure enabled_accessibility_services ${AutoJs6 包名}/${AutoJs6 服务类名}`), 系统将只启用 AutoJs6 无障碍服务, 其他应用的无障碍服务将全部关闭. */

    /* 另, 禁用 AutoJs6 无障碍服务, 只需执行上述示例的 [ 1, 2, 4 ] 步骤即可. */

### shizuku(cmdList)#

`6.4.0` `Overload 2/2`

- cmdList { string[] } - 待执行的多行命令
- returns { ShellResult } - Shell 结果

使用 Shizuku 一次性执行多行命令, 每行命令对应 `cmdList` 数组中的一个元素.

    shizuku([ 'cmd-a', 'cmd-b', 'cmd-c' ]);
    shizuku('cmd-a\ncmd-b\ncmd-c'); /* 同上. */