295 lines
16 KiB
HTML
295 lines
16 KiB
HTML
<!doctype html>
|
|
<html lang="en">
|
|
<head>
|
|
<meta charset="utf-8">
|
|
<title>Shizuku | AutoJs6 文档 - 6.6.1</title>
|
|
<link rel="stylesheet" href="assets/fonts.css">
|
|
<link rel="stylesheet" href="assets/style.css">
|
|
<link rel="stylesheet" href="assets/sh.css">
|
|
<link rel="stylesheet" href="plugins/docsify-copy-code@2-styles.css">
|
|
<link rel="stylesheet" href="plugins/zoom-image-styles.css">
|
|
<link rel="canonical" href="https://nodejs.org/api/shizuku.html">
|
|
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1"/>
|
|
<meta name="viewport" content="user-scalable=no">
|
|
</head>
|
|
<body class="alt apidoc" id="api-section-shizuku">
|
|
<div id="content" class="clearfix">
|
|
<div id="column2" class="interior">
|
|
<div id="intro" class="interior">
|
|
<a href="/" title="返回首页">
|
|
AutoJs6
|
|
</a>
|
|
</div>
|
|
<ul>
|
|
<li><a class="nav-overview" href="overview.html">Overview - 综述</a></li>
|
|
<li><a class="nav-documentation" href="documentation.html">About - 关于文档</a></li>
|
|
<li><a class="nav-progress" href="progress.html">Progress - 文档部署进度</a></li>
|
|
<li><a class="nav-changelog" href="changelog.html">Changelog - 文档更新日志</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-manual" href="manual.html">Manual - AutoJs6 使用手册</a></li>
|
|
<li><a class="nav-qa" href="qa.html">Q & A - 疑难解答</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-global" href="global.html">Global - 全局对象</a></li>
|
|
<li><a class="nav-automator" href="automator.html">Automator - 自动化</a></li>
|
|
<li><a class="nav-autojs" href="autojs.html">AutoJs6 - 本体应用</a></li>
|
|
<li><a class="nav-app" href="app.html">App - 通用应用</a></li>
|
|
<li><a class="nav-color" href="color.html">Color - 颜色</a></li>
|
|
<li><a class="nav-image" href="image.html">Image - 图像</a></li>
|
|
<li><a class="nav-ocr" href="ocr.html">OCR - 光学字符识别</a></li>
|
|
<li><a class="nav-barcode" href="barcode.html">Barcode - 条码</a></li>
|
|
<li><a class="nav-qrcode" href="qrcode.html">QR Code - 二维码</a></li>
|
|
<li><a class="nav-keys" href="keys.html">Keys - 按键</a></li>
|
|
<li><a class="nav-device" href="device.html">Device - 设备</a></li>
|
|
<li><a class="nav-storages" href="storages.html">Storage - 储存</a></li>
|
|
<li><a class="nav-files" href="files.html">File - 文件</a></li>
|
|
<li><a class="nav-engines" href="engines.html">Engine - 引擎</a></li>
|
|
<li><a class="nav-tasks" href="tasks.html">Task - 任务</a></li>
|
|
<li><a class="nav-modules" href="modules.html">Module - 模块</a></li>
|
|
<li><a class="nav-plugins" href="plugins.html">Plugins - 插件</a></li>
|
|
<li><a class="nav-toast" href="toast.html">Toast - 消息浮动框</a></li>
|
|
<li><a class="nav-notice" href="notice.html">Notice - 消息通知</a></li>
|
|
<li><a class="nav-console" href="console.html">Console - 控制台</a></li>
|
|
<li><a class="nav-shell" href="shell.html">Shell</a></li>
|
|
<li><a class="nav-shizuku active" href="shizuku.html">Shizuku</a></li>
|
|
<li><a class="nav-media" href="media.html">Media - 多媒体</a></li>
|
|
<li><a class="nav-sensors" href="sensors.html">Sensor - 传感器</a></li>
|
|
<li><a class="nav-recorder" href="recorder.html">Recorder - 记录器</a></li>
|
|
<li><a class="nav-timers" href="timers.html">Timer - 定时器</a></li>
|
|
<li><a class="nav-threads" href="threads.html">Thread - 线程</a></li>
|
|
<li><a class="nav-continuation" href="continuation.html">Continuation - 协程</a></li>
|
|
<li><a class="nav-events" href="events.html">Event - 事件监听</a></li>
|
|
<li><a class="nav-dialogs" href="dialogs.html">Dialog - 对话框</a></li>
|
|
<li><a class="nav-floaty" href="floaty.html">Floaty - 悬浮窗</a></li>
|
|
<li><a class="nav-canvas" href="canvas.html">Canvas - 画布</a></li>
|
|
<li><a class="nav-ui" href="ui.html">UI - 用户界面</a></li>
|
|
<li><a class="nav-web" href="web.html">Web - 万维网</a></li>
|
|
<li><a class="nav-http" href="http.html">HTTP</a></li>
|
|
<li><a class="nav-base64" href="base64.html">Base64</a></li>
|
|
<li><a class="nav-crypto" href="crypto.html">Crypto - 密文</a></li>
|
|
<li><a class="nav-opencc" href="opencc.html">OpenCC - 中文转换</a></li>
|
|
<li><a class="nav-i18n" href="i18n.html">Internationalization - 国际化</a></li>
|
|
<li><a class="nav-s13n" href="s13n.html">Standardization - 标准化</a></li>
|
|
<li><a class="nav-e4x" href="e4x.html">E4X</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-uiSelectorType" href="uiSelectorType.html">UiSelector - 选择器</a></li>
|
|
<li><a class="nav-uiObjectType" href="uiObjectType.html">UiObject - 控件节点</a></li>
|
|
<li><a class="nav-uiObjectCollectionType" href="uiObjectCollectionType.html">UiObjectCollection - 控件集合</a></li>
|
|
<li><a class="nav-uiObjectActionsType" href="uiObjectActionsType.html">UiObjectActions - 控件节点行为</a></li>
|
|
<li><a class="nav-webSocketType" href="webSocketType.html">WebSocket</a></li>
|
|
<li><a class="nav-eventEmitterType" href="eventEmitterType.html">EventEmitter - 事件发射器</a></li>
|
|
<li><a class="nav-imageWrapperType" href="imageWrapperType.html">ImageWrapper - 包装图像类</a></li>
|
|
<li><a class="nav-appType" href="appType.html">App - 应用枚举类</a></li>
|
|
<li><a class="nav-colorType" href="colorType.html">Color - 颜色类</a></li>
|
|
<li><a class="nav-versionType" href="versionType.html">Version - 版本工具类</a></li>
|
|
<li><a class="nav-polyfill" href="polyfill.html">Polyfill - 代码填泥</a></li>
|
|
<li><a class="nav-arrayx" href="arrayx.html">Arrayx - Array 扩展</a></li>
|
|
<li><a class="nav-numberx" href="numberx.html">Numberx - Number 扩展</a></li>
|
|
<li><a class="nav-mathx" href="mathx.html">Mathx - Math 扩展</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-exceptions" href="exceptions.html">Exceptions - 异常</a></li>
|
|
<li><a class="nav-intentType" href="intentType.html">Intent - 意图</a></li>
|
|
<li><a class="nav-runtime" href="runtime.html">Runtime - 运行时</a></li>
|
|
<li><a class="nav-context" href="context.html">Context - 上下文</a></li>
|
|
<li><a class="nav-activity" href="activity.html">Activity - 活动</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-scriptingJava" href="scriptingJava.html">Scripting Java - 脚本化 Java</a></li>
|
|
<li><a class="nav-apiLevel" href="apiLevel.html">Android API Level - 安卓 API 级别</a></li>
|
|
<li><a class="nav-colorTable" href="colorTable.html">Color Table - 颜色列表</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-glossaries" href="glossaries.html">Glossaries - 术语</a></li>
|
|
<li><a class="nav-httpHeaderGlossary" href="httpHeaderGlossary.html">HttpHeader - HTTP 标头</a></li>
|
|
<li><a class="nav-httpRequestMethodsGlossary" href="httpRequestMethodsGlossary.html">HttpRequestMethods - HTTP 请求方法</a></li>
|
|
<li><a class="nav-mimeTypeGlossary" href="mimeTypeGlossary.html">MimeType - MIME 类型</a></li>
|
|
<li><a class="nav-notificationChannelGlossary" href="notificationChannelGlossary.html">NotificationChannel - 通知渠道</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-dataTypes" href="dataTypes.html">Data Types - 数据类型</a></li>
|
|
<li><a class="nav-omniTypes" href="omniTypes.html">Omnipotent Types - 全能类型</a></li>
|
|
<li><a class="nav-storageType" href="storageType.html">Storage - 存储类</a></li>
|
|
<li><a class="nav-androidBundleType" href="androidBundleType.html">AndroidBundle</a></li>
|
|
<li><a class="nav-androidRectType" href="androidRectType.html">AndroidRect</a></li>
|
|
<li><a class="nav-cryptoCipherOptionsType" href="cryptoCipherOptionsType.html">CryptoCipherOptions</a></li>
|
|
<li><a class="nav-cryptoKeyType" href="cryptoKeyType.html">CryptoKey</a></li>
|
|
<li><a class="nav-cryptoKeyPairType" href="cryptoKeyPairType.html">CryptoKeyPair</a></li>
|
|
<li><a class="nav-consoleBuildOptionsType" href="consoleBuildOptionsType.html">ConsoleBuildOptions</a></li>
|
|
<li><a class="nav-httpRequestBuilderOptionsType" href="httpRequestBuilderOptionsType.html">HttpRequestBuilderOptions</a></li>
|
|
<li><a class="nav-httpRequestHeadersType" href="httpRequestHeadersType.html">HttpRequestHeaders</a></li>
|
|
<li><a class="nav-httpResponseBodyType" href="httpResponseBodyType.html">HttpResponseBody</a></li>
|
|
<li><a class="nav-httpResponseHeadersType" href="httpResponseHeadersType.html">HttpResponseHeaders</a></li>
|
|
<li><a class="nav-httpResponseType" href="httpResponseType.html">HttpResponse</a></li>
|
|
<li><a class="nav-injectableWebClientType" href="injectableWebClientType.html">InjectableWebClient</a></li>
|
|
<li><a class="nav-injectableWebViewType" href="injectableWebViewType.html">InjectableWebView</a></li>
|
|
<li><a class="nav-noticeOptionsType" href="noticeOptionsType.html">NoticeOptions</a></li>
|
|
<li><a class="nav-noticeChannelOptionsType" href="noticeChannelOptionsType.html">NoticeChannelOptions</a></li>
|
|
<li><a class="nav-noticePresetConfigurationType" href="noticePresetConfigurationType.html">NoticePresetConfiguration</a></li>
|
|
<li><a class="nav-noticeBuilderType" href="noticeBuilderType.html">NoticeBuilder</a></li>
|
|
<li><a class="nav-okhttp3HttpUrlType" href="okhttp3HttpUrlType.html">Okhttp3HttpUrl</a></li>
|
|
<li><a class="nav-ocrOptionsType" href="ocrOptionsType.html">OcrOptions</a></li>
|
|
<li><a class="nav-okhttp3RequestType" href="okhttp3RequestType.html">Okhttp3Request</a></li>
|
|
<li><a class="nav-opencvPointType" href="opencvPointType.html">OpenCVPoint</a></li>
|
|
<li><a class="nav-opencvRectType" href="opencvRectType.html">OpenCVRect</a></li>
|
|
<li><a class="nav-opencvSizeType" href="opencvSizeType.html">OpenCVSize</a></li>
|
|
<li><a class="nav-openCCConversionType" href="openCCConversionType.html">OpenCCConversion</a></li>
|
|
</ul>
|
|
<div class="line"></div>
|
|
|
|
<ul>
|
|
<li><a class="nav-http-project-autojs6-com" href="http://project.autojs6.com">GitHub - 应用项目地址</a></li>
|
|
<li><a class="nav-http-docs-project-autojs6-com" href="http://docs-project.autojs6.com">GitHub - 文档项目地址</a></li>
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
<div id="column1" data-id="shizuku" class="interior">
|
|
<header>
|
|
<h1>AutoJs6 文档 - 6.6.1</h1>
|
|
<div id="gtoc">
|
|
<p class="index">
|
|
<a href="index.html" name="toc">索引</a> |
|
|
<a href="all.html">查看全部</a>
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
</header>
|
|
|
|
<div id="toc">
|
|
<h2>目录</h2>
|
|
<ul>
|
|
<li><span class="stability_undefined"><a href="#shizuku_shizuku">Shizuku</a></span><ul>
|
|
<li><span class="stability_undefined"><a href="#shizuku_shizuku_1">[@] shizuku</a></span><ul>
|
|
<li><span class="stability_undefined"><a href="#shizuku_shizuku_cmd">shizuku(cmd)</a></span></li>
|
|
<li><span class="stability_undefined"><a href="#shizuku_shizuku_cmdlist">shizuku(cmdList)</a></span></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
|
|
</div>
|
|
|
|
<div id="apicontent">
|
|
<h1>Shizuku<span><a class="mark" href="#shizuku_shizuku" id="shizuku_shizuku">#</a></span></h1>
|
|
<hr>
|
|
<p style="font: italic 1em sans-serif; color: #78909C">此章节待补充或完善...</p>
|
|
<p style="font: italic 1em sans-serif; color: #78909C">Marked by SuperMonster003 on Oct 30, 2023.</p>
|
|
|
|
<hr>
|
|
<p>通过 <a href="https://shizuku.rikka.app/introduction/">Shizuku</a> 可以获得 ADB 特权并使用系统 API.</p>
|
|
<p>使用 Shizuku 需满足以下全部条件</p>
|
|
<ul>
|
|
<li>设备已安装 <a href="https://github.com/RikkaApps/Shizuku/releases">Shizuku 应用</a> (版本不低于 <code>11</code>)</li>
|
|
<li>Shizuku 服务已启动 (参阅 <a href="https://shizuku.rikka.app/guide/setup/#start-shizuku">Shizuku 用户手册</a>)</li>
|
|
<li>AutoJs6 首页抽屉开启 Shizuku 权限开关</li>
|
|
</ul>
|
|
<hr>
|
|
<p style="font: bold 2em sans-serif; color: #FF7043">shizuku</p>
|
|
|
|
<hr>
|
|
<h2>[@] shizuku<span><a class="mark" href="#shizuku_shizuku_1" id="shizuku_shizuku_1">#</a></span></h2>
|
|
<p>shizuku 可作为全局对象使用:</p>
|
|
<pre><code class="lang-js">typeof shizuku; // "function"
|
|
typeof shizuku.execCommand; // "function"
|
|
</code></pre>
|
|
<h3>shizuku(cmd)<span><a class="mark" href="#shizuku_shizuku_cmd" id="shizuku_shizuku_cmd">#</a></span></h3>
|
|
<p><strong><code>6.4.0</code></strong> <strong><code>Overload 1/2</code></strong></p>
|
|
<ul>
|
|
<li><strong>cmd</strong> { <span class="type"><a href="dataTypes.html#datatypes_string">string</a></span> } - 待执行命令</li>
|
|
<li><ins><strong>returns</strong></ins> { <span class="type"><a href="shellResultType.html">ShellResult</a></span> } - Shell 结果</li>
|
|
</ul>
|
|
<p>使用 Shizuku 执行命令.</p>
|
|
<pre><code class="lang-js">/* 模拟返回键. */
|
|
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());
|
|
</code></pre>
|
|
<p>使用 shizuku 启用 AutoJs6 无障碍服务 (共计 4 步):</p>
|
|
<pre><code class="lang-js">
|
|
/* [ 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 ] 步骤即可. */
|
|
</code></pre>
|
|
<h3>shizuku(cmdList)<span><a class="mark" href="#shizuku_shizuku_cmdlist" id="shizuku_shizuku_cmdlist">#</a></span></h3>
|
|
<p><strong><code>6.4.0</code></strong> <strong><code>Overload 2/2</code></strong></p>
|
|
<ul>
|
|
<li><strong>cmdList</strong> { <span class="type"><a href="dataTypes.html#datatypes_string">string</a><a href="dataTypes.html#datatypes_array">[]</a></span> } - 待执行的多行命令</li>
|
|
<li><ins><strong>returns</strong></ins> { <span class="type"><a href="shellResultType.html">ShellResult</a></span> } - Shell 结果</li>
|
|
</ul>
|
|
<p>使用 Shizuku 一次性执行多行命令, 每行命令对应 <code>cmdList</code> 数组中的一个元素.</p>
|
|
<pre><code class="lang-js">shizuku([ 'cmd-a', 'cmd-b', 'cmd-c' ]);
|
|
shizuku('cmd-a\ncmd-b\ncmd-c'); /* 同上. */
|
|
</code></pre>
|
|
|
|
</div>
|
|
</div>
|
|
</div>
|
|
|
|
<script src="assets/sh_javascript.js"></script>
|
|
<script src="assets/sh_java.js"></script>
|
|
<script src="assets/sh_main.js"></script>
|
|
|
|
<script src="plugins/docsify-copy-code@2.js"></script>
|
|
<script src="plugins/zoom-image.js"></script>
|
|
|
|
<script>
|
|
highlight(void 0, void 0, 'pre');
|
|
highlight(void 0, void 0, 'tt');
|
|
</script>
|
|
|
|
<!-- __TRACKING__ -->
|
|
|
|
</body>
|
|
</html> |