docs: update docs and indics to latest

2018-04-02 15:49:35 +08:00
parent 0656a64468
commit ebf086af90
7 changed files with 206 additions and 22 deletions
--- a/app/src/main/assets/docs/app.html
+++ b/app/src/main/assets/docs/app.html
@@ -75,6 +75,10 @@
        <h2>目录</h2>
        <ul>
 <li><span class="stability_undefined"><a href="#app_app">App</a></span><ul>
+<li><span class="stability_undefined"><a href="#app_app_versioncode">app.versionCode</a></span></li>
+<li><span class="stability_undefined"><a href="#app_app_versionname">app.versionName</a></span></li>
+<li><span class="stability_undefined"><a href="#app_app_autojs_versioncode">app.autojs.versionCode</a></span></li>
+<li><span class="stability_undefined"><a href="#app_app_autojs_versionname">app.autojs.versionName</a></span></li>
 <li><span class="stability_undefined"><a href="#app_app_launchapp_appname">app.launchApp(appName)</a></span></li>
 <li><span class="stability_undefined"><a href="#app_app_launch_packagename">app.launch(packageName)</a></span></li>
 <li><span class="stability_undefined"><a href="#app_app_launchpackage_packagename">app.launchPackage(packageName)</a></span></li>
@@ -103,6 +107,30 @@
        <h1>App<span><a class="mark" href="#app_app" id="app_app">#</a></span></h1>
 <p>app模块提供一系列函数，用于使用其他应用、与其他应用交互。例如发送意图、打开文件、发送邮件等。</p>
 <p>同时提供了方便的进阶函数startActivity和sendBroadcast，用他们可完成app模块没有内置的和其他应用的交互。</p>
+<h2>app.versionCode<span><a class="mark" href="#app_app_versioncode" id="app_app_versioncode">#</a></span></h2>
+<div class="signature"><ul>
+<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>
+</ul>
+</div><p>当前软件版本号，整数值。例如160, 256等。</p>
+<p>如果在Auto.js中运行则为Auto.js的版本号；在打包的软件中则为打包软件的版本号。</p>
+<pre><code>toastLog(app.versionCode);
+</code></pre><h2>app.versionName<span><a class="mark" href="#app_app_versionname" id="app_app_versionname">#</a></span></h2>
+<div class="signature"><ul>
+<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>
+</ul>
+</div><p>当前软件的版本名称，例如&quot;3.0.0 Beta&quot;。</p>
+<p>如果在Auto.js中运行则为Auto.js的版本名称；在打包的软件中则为打包软件的版本名称。</p>
+<pre><code>toastLog(app.verionName);
+</code></pre><h2>app.autojs.versionCode<span><a class="mark" href="#app_app_autojs_versioncode" id="app_app_autojs_versioncode">#</a></span></h2>
+<div class="signature"><ul>
+<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>
+</ul>
+</div><p>Auto.js版本号，整数值。例如160, 256等。</p>
+<h2>app.autojs.versionName<span><a class="mark" href="#app_app_autojs_versionname" id="app_app_autojs_versionname">#</a></span></h2>
+<div class="signature"><ul>
+<li><a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>
+</ul>
+</div><p>Auto.js版本名称，例如&quot;3.0.0 Beta&quot;。</p>
 <h2>app.launchApp(appName)<span><a class="mark" href="#app_app_launchapp_appname" id="app_app_launchapp_appname">#</a></span></h2>
 <div class="signature"><ul>
 <li><code>appName</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 应用名称</li>
--- a/app/src/main/assets/docs/canvas.html
+++ b/app/src/main/assets/docs/canvas.html
@@ -6,9 +6,9 @@
  <link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Lato:400,700,400italic">
  <link rel="stylesheet" href="assets/style.css">
  <link rel="stylesheet" href="assets/sh.css">
-  <link rel="canonical" href="https://nodejs.org/api/update.html">
+  <link rel="canonical" href="https://nodejs.org/api/canvas.html">
 </head>
-<body class="alt apidoc" id="api-section-update">
+<body class="alt apidoc" id="api-section-canvas">
  <div id="content" class="clearfix">
    <div id="column2" class="interior">
      <div id="intro" class="interior">
@@ -42,6 +42,7 @@
 <li><a class="nav-media" href="media.html">Media - 多媒体</a></li>
 <li><a class="nav-modules" href="modules.html">Modules - 模块</a></li>
 <li><a class="nav-widgets-based-automation" href="widgets-based-automation.html">WidgetsBasedAutomation - 基于控件的操作</a></li>
+<li><a class="nav-sensors" href="sensors.html">Sensors - 传感器</a></li>
 <li><a class="nav-shell" href="shell.html">Shell - Shell命令</a></li>
 <li><a class="nav-storages" href="storages.html">Storages - 本地存储</a></li>
 <li><a class="nav-threads" href="threads.html">Threads - 多线程</a></li>
@@ -58,7 +59,7 @@

    </div>

-    <div id="column1" data-id="update" class="interior">
+    <div id="column1" data-id="canvas" class="interior">
      <header>
        <h1>Auto.js 3.0.0 文档</h1>
        <div id="gtoc">
@@ -76,18 +77,7 @@
      </div>

      <div id="apicontent">
-        <ul>
-<li>全新的界面，更方便地浏览和管理</li>
-<li>全新的编辑器，支持自动补全，长按函数弹出帮助，插入函数，侧拉菜单帮助等</li>
-<li>全新的文档</li>
-<li>加入脚本交流社区，可以在社区直接提问、发布脚本、下载脚本</li>
-<li>支持定时任务</li>
-<li>简单的代码生成功能，对于简单情况的控件可以直接生成代码</li>
-<li>代码打包功能，可以把代码打包成apk，支持和图片等静态资源一起打包</li>
-<li>支持编写</li>
-<li>更丰富的函数和模块，包括找图找色、悬浮窗、多线程、本地存储、设备设置和信息等功能</li>
-</ul>
-
+        
      </div>
    </div>
  </div>
--- a/app/src/main/assets/docs/engines.html
+++ b/app/src/main/assets/docs/engines.html
@@ -81,6 +81,7 @@
 <li><span class="stability_undefined"><a href="#engines_engines_stopall">engines.stopAll()</a></span></li>
 <li><span class="stability_undefined"><a href="#engines_engines_stopallandtoast">engines.stopAllAndToast()</a></span></li>
 <li><span class="stability_undefined"><a href="#engines_engines_myengine">engines.myEngine()</a></span></li>
+<li><span class="stability_undefined"><a href="#engines_engines_all">engines.all()</a></span></li>
 </ul>
 </li>
 <li><span class="stability_undefined"><a href="#engines_scriptexecution">ScriptExecution</a></span><ul>
@@ -91,6 +92,8 @@
 <li><span class="stability_undefined"><a href="#engines_scriptengine">ScriptEngine</a></span><ul>
 <li><span class="stability_undefined"><a href="#engines_scriptengine_forcestop">ScriptEngine.forceStop()</a></span></li>
 <li><span class="stability_undefined"><a href="#engines_scriptengine_cwd">ScriptEngine.cwd()</a></span></li>
+<li><span class="stability_undefined"><a href="#engines_scriptengine_getsource">ScriptEngine.getSource()</a></span></li>
+<li><span class="stability_undefined"><a href="#engines_scriptengine_emit_eventname_args">ScriptEngine.emit(eventName[, ...args])</a></span></li>
 </ul>
 </li>
 <li><span class="stability_undefined"><a href="#engines_scriptconfig">ScriptConfig</a></span><ul>
@@ -182,7 +185,13 @@ exec(add, {a: 1, b:2});
 <p>停止所有正在运行的脚本并显示停止的脚本数量。包括当前脚本自身。</p>
 <h2>engines.myEngine()<span><a class="mark" href="#engines_engines_myengine" id="engines_engines_myengine">#</a></span></h2>
 <p>返回当前脚本的脚本引擎对象(<a href="#engines_scriptengine">ScriptEngine</a>)</p>
-<h1>ScriptExecution<span><a class="mark" href="#engines_scriptexecution" id="engines_scriptexecution">#</a></span></h1>
+<h2>engines.all()<span><a class="mark" href="#engines_engines_all" id="engines_engines_all">#</a></span></h2>
+<div class="signature"><ul>
+<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array" class="type">&lt;Array&gt;</a></li>
+</ul>
+</div><p>返回当前所有正在运行的脚本的脚本引擎<a href="#engines_scriptengine">ScriptEngine</a>的数组。</p>
+<pre><code>log(engines.all());
+</code></pre><h1>ScriptExecution<span><a class="mark" href="#engines_scriptexecution" id="engines_scriptexecution">#</a></span></h1>
 <p>执行脚本时返回的对象，可以通过他获取执行的引擎、配置等，也可以停止这个执行。</p>
 <p>要停止这个脚本的执行，使用<code>exectuion.getEngine().forceStop()</code>.</p>
 <h2>ScriptExecution.getEngine()<span><a class="mark" href="#engines_scriptexecution_getengine" id="engines_scriptexecution_getengine">#</a></span></h2>
@@ -198,7 +207,33 @@ exec(add, {a: 1, b:2});
 <li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>
 </ul>
 </div><p>返回脚本执行的路径。对于一个脚本文件而言为这个脚本所在的文件夹；对于其他脚本，例如字符串脚本，则为<code>null</code>或者执行时的设置值。</p>
-<h1>ScriptConfig<span><a class="mark" href="#engines_scriptconfig" id="engines_scriptconfig">#</a></span></h1>
+<h2>ScriptEngine.getSource()<span><a class="mark" href="#engines_scriptengine_getsource" id="engines_scriptengine_getsource">#</a></span></h2>
+<div class="signature"><ul>
+<li>返回 <a href="#engines_scriptsource">ScriptSource</a></li>
+</ul>
+</div><p>返回当前脚本引擎正在执行的脚本对象。</p>
+<pre><code>log(engines.myEngine().getSource());
+</code></pre><h2>ScriptEngine.emit(eventName[, ...args])<span><a class="mark" href="#engines_scriptengine_emit_eventname_args" id="engines_scriptengine_emit_eventname_args">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>eventName</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 事件名称</li>
+<li><code>...args</code> <span class="type">&lt;any&gt;</span> 事件参数</li>
+</ul>
+</div><p>向该脚本引擎发送一个事件，该事件可以在该脚本引擎对应的脚本的events模块监听到并在脚本主线程执行事件处理。</p>
+<p>例如脚本receiver.js的内容如下：</p>
+<pre><code>//监听say事件
+events.on(&quot;say&quot;, function(words){
+    toastLog(words);
+});
+//保持脚本运行
+setInterval(()=&gt;{}, 1000);
+</code></pre><p>同一目录另一脚本可以启动他并发送该事件：</p>
+<pre><code>//运行脚本
+var e = engines.execScriptFile(&quot;./receiver.js&quot;);
+//等待脚本启动
+sleep(2000);
+//向该脚本发送事件
+e.getEngine().emit(&quot;say&quot;, &quot;你好&quot;);
+</code></pre><h1>ScriptConfig<span><a class="mark" href="#engines_scriptconfig" id="engines_scriptconfig">#</a></span></h1>
 <p>脚本执行时的配置。</p>
 <h2>delay<span><a class="mark" href="#engines_delay" id="engines_delay">#</a></span></h2>
 <div class="signature"><ul>
--- a/app/src/main/assets/docs/events.html
+++ b/app/src/main/assets/docs/events.html
@@ -135,6 +135,7 @@
 <li><span class="stability_undefined"><a href="#events_eventemitter_setmaxlisteners_n">EventEmitter.setMaxListeners(n)</a></span></li>
 </ul>
 </li>
+<li><span class="stability_undefined"><a href="#events_events_broadcast">events.broadcast: 脚本间广播</a></span></li>
 </ul>

      </div>
@@ -589,7 +590,18 @@ myEmitter.emit(&#39;event&#39;);
 </ul>
 </div><p>默认情况下，如果为特定事件添加了超过 10 个监听器，则 EventEmitter 会打印一个警告。 此限制有助于寻找内存泄露。 但是，并不是所有的事件都要被限为 10 个。 emitter.setMaxListeners() 方法允许修改指定的 EventEmitter 实例的限制。 值设为 Infinity（或 0）表明不限制监听器的数量。</p>
 <p>返回一个 EventEmitter 引用，可以链式调用。</p>
-
+<h1>events.broadcast: 脚本间广播<span><a class="mark" href="#events_events_broadcast" id="events_events_broadcast">#</a></span></h1>
+<p>脚本间通信除了使用engines模块提供的<code>ScriptEngine.emit()</code>方法以外，也可以使用events模块提供的broadcast广播。</p>
+<p>events.broadcast本身是一个EventEmitter，但它的事件是在脚本间共享的，所有脚本都能发送和监听这些事件；事件处理会在脚本主线程执行（后续可能加入函数<code>onThisThread(eventName, ...args)</code>来提供在其他线程执行的能力）。</p>
+<p>例如在一个脚本发送一个广播hello:</p>
+<pre><code>events.broadcast.emit(&quot;hello&quot;, &quot;小明&quot;);
+</code></pre><p>在其他脚本中监听并处理：</p>
+<pre><code>events.broadcast.on(&quot;hello&quot;, function(name){
+    toast(&quot;你好, &quot; + name);
+});
+//保持脚本运行
+setInterval(()=&gt;{}, 1000);
+</code></pre>
      </div>
    </div>
  </div>
--- a/app/src/main/assets/docs/globals.html
+++ b/app/src/main/assets/docs/globals.html
@@ -87,6 +87,8 @@
 <li><span class="stability_undefined"><a href="#globals_exit">exit()</a></span></li>
 <li><span class="stability_undefined"><a href="#globals_random_min_max">random(min, max)</a></span></li>
 <li><span class="stability_undefined"><a href="#globals_random">random()</a></span></li>
+<li><span class="stability_undefined"><a href="#globals_requiresapi_api">requiresApi(api)</a></span></li>
+<li><span class="stability_undefined"><a href="#globals_requiresautojsversion_version">requiresAutojsVersion(version)</a></span></li>
 <li><span class="stability_undefined"><a href="#globals_context">context</a></span></li>
 </ul>
 </li>
@@ -192,6 +194,29 @@ for(var i = 0; i &lt; 100; i++){
 <li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a></li>
 </ul>
 </div><p>返回在[0, 1)的随机浮点数。</p>
+<h2>requiresApi(api)<span><a class="mark" href="#globals_requiresapi_api" id="globals_requiresapi_api">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>api</code> Android版本号</li>
+</ul>
+</div><p>表示此脚本需要Android API版本达到指定版本才能运行。例如<code>requiresApi(19)</code>表示脚本需要在Android 4.4以及以上运行。</p>
+<p>调用该函数时会判断运行脚本的设备系统的版本号，如果没有达到要求则抛出异常。</p>
+<p>可以参考以下Android API和版本的对照表:</p>
+<p> 平台版本：     API级别</p>
+<p> Android 7.0：  24</p>
+<p> Android 6.0：  23</p>
+<p> Android 5.1：  22</p>
+<p> Android 5.0：  21</p>
+<p> Android 4.4W：  20</p>
+<p> Android 4.4：  19</p>
+<p> Android 4.3：  18</p>
+<h2>requiresAutojsVersion(version)<span><a class="mark" href="#globals_requiresautojsversion_version" id="globals_requiresautojsversion_version">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>version</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> | <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> Auto.js的版本或版本号</li>
+</ul>
+</div><p>表示此脚本需要Auto.js版本达到指定版本才能运行。例如<code>requiresAutojsVersion(&quot;3.0.0 Beta&quot;)</code>表示脚本需要在Auto.js 3.0.0 Beta以及以上运行。</p>
+<p>调用该函数时会判断运行脚本的Auto.js的版本号，如果没有达到要求则抛出异常。</p>
+<p>version参数可以是整数表示版本号，例如<code>requiresAutojsVersion(250)</code>；也可以是字符串格式表示的版本，例如&quot;3.0.0 Beta&quot;, &quot;3.1.0 Alpha4&quot;, &quot;3.2.0&quot;等。</p>
+<p>可以通过<code>app.autojs.versionCode</code>和<code>app.autojs.versionName</code>获取当前的Auto.js版本号和版本。</p>
 <h2>context<span><a class="mark" href="#globals_context" id="globals_context">#</a></span></h2>
 <p>全局变量。一个android.content.Context对象。</p>
 <p>注意该对象为ApplicationContext，因此不能用于界面、对话框等的创建。</p>
--- a/app/src/main/assets/docs/images.html
+++ b/app/src/main/assets/docs/images.html
@@ -92,9 +92,13 @@
 <li><span class="stability_undefined"><a href="#images_images_capturescreen">images.captureScreen()</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_capturescreen_path">images.captureScreen(path)</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_pixel_image_x_y">images.pixel(image, x, y)</a></span></li>
-<li><span class="stability_undefined"><a href="#images_images_save_image_path">images.save(image, path)</a></span></li>
+<li><span class="stability_undefined"><a href="#images_images_save_image_path_format_png_quality_100">images.save(image, path[, format = &quot;png&quot;, quality = 100])</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_read_path">images.read(path)</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_load_url">images.load(url)</a></span></li>
+<li><span class="stability_undefined"><a href="#images_images_frombase64_base64">images.fromBase64(base64)</a></span></li>
+<li><span class="stability_undefined"><a href="#images_images_tobase64_img_format_png_quality_100">images.toBase64(img[, format = &quot;png&quot;, quality = 100])</a></span></li>
+<li><span class="stability_undefined"><a href="#images_images_frombytes_bytes">images.fromBytes(bytes)</a></span></li>
+<li><span class="stability_undefined"><a href="#images_images_tobytes_img_format_png_quality_100">images.toBytes(img[, format = &quot;png&quot;, quality = 100])</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_clip_img_x_y_w_h">images.clip(img, x, y, w, h)</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_findcolor_image_color_options">images.findColor(image, color, options)</a></span></li>
 <li><span class="stability_undefined"><a href="#images_images_findcolorinregion_img_color_x_y_width_height_threshold">images.findColorInRegion(img, color, x, y[, width, height, threshold])</a></span></li>
@@ -259,13 +263,24 @@ toast(colors.toString(color));
 </div><p>返回图片image在点(x, y)处的像素的ARGB值。  </p>
 <p>该值的格式为0xAARRGGBB，是一个&quot;32位整数&quot;(虽然JavaScript中并不区分整数类型和其他数值类型)。</p>
 <p>坐标系以图片左上角为原点。以图片左侧边为y轴，上侧边为x轴。</p>
-<h2>images.save(image, path)<span><a class="mark" href="#images_images_save_image_path" id="images_images_save_image_path">#</a></span></h2>
+<h2>images.save(image, path[, format = &quot;png&quot;, quality = 100])<span><a class="mark" href="#images_images_save_image_path_format_png_quality_100" id="images_images_save_image_path_format_png_quality_100">#</a></span></h2>
 <div class="signature"><ul>
 <li><code>image</code> <span class="type">&lt;image&gt;</span> 图片</li>
-<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 路劲</li>
+<li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 路径</li>
+<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片格式，可选的值为:<ul>
+<li><code>png</code></li>
+<li><code>jpeg</code>/<code>jpg</code></li>
+<li><code>webp</code></li>
+</ul>
+</li>
+<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> 图片质量，为0~100的整数值</li>
 </ul>
 </div><p>把图片image以PNG格式保存到path中。如果文件不存在会被创建；文件存在会被覆盖。</p>
-<h2>images.read(path)<span><a class="mark" href="#images_images_read_path" id="images_images_read_path">#</a></span></h2>
+<pre><code>//把图片压缩为原来的一半质量并保存
+var img = images.read(&quot;/sdcard/1.png&quot;);
+images.save(img, &quot;/sdcard/1.jpg&quot;, &quot;jpg&quot;, 50);
+app.viewFile(&quot;/sdcard/1.jpg&quot;);
+</code></pre><h2>images.read(path)<span><a class="mark" href="#images_images_read_path" id="images_images_read_path">#</a></span></h2>
 <div class="signature"><ul>
 <li><code>path</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片路径</li>
 </ul>
@@ -275,6 +290,43 @@ toast(colors.toString(color));
 <li><code>url</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片URL地址</li>
 </ul>
 </div><p>加载在地址URL的网络图片并返回一个Image对象。如果地址不存在或者图片无法解码则返回null。</p>
+<h2>images.fromBase64(base64)<span><a class="mark" href="#images_images_frombase64_base64" id="images_images_frombase64_base64">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>base64</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片的Base64数据</li>
+<li>返回 <span class="type">&lt;Image&gt;</span></li>
+</ul>
+</div><p>解码Base64数据并返回解码后的图片Image对象。如果base64无法解码则返回<code>null</code>。</p>
+<h2>images.toBase64(img[, format = &quot;png&quot;, quality = 100])<span><a class="mark" href="#images_images_tobase64_img_format_png_quality_100" id="images_images_tobase64_img_format_png_quality_100">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>image</code> <span class="type">&lt;image&gt;</span> 图片</li>
+<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片格式，可选的值为:<ul>
+<li><code>png</code></li>
+<li><code>jpeg</code>/<code>jpg</code></li>
+<li><code>webp</code></li>
+</ul>
+</li>
+<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> 图片质量，为0~100的整数值</li>
+<li>返回 <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a></li>
+</ul>
+</div><p>把图片编码为base64数据并返回。</p>
+<h2>images.fromBytes(bytes)<span><a class="mark" href="#images_images_frombytes_bytes" id="images_images_frombytes_bytes">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>bytes</code> <span class="type">&lt;byte[]&gt;</span> 字节数组</li>
+</ul>
+</div><p>解码字节数组bytes并返回解码后的图片Image对象。如果bytes无法解码则返回<code>null</code>。</p>
+<h2>images.toBytes(img[, format = &quot;png&quot;, quality = 100])<span><a class="mark" href="#images_images_tobytes_img_format_png_quality_100" id="images_images_tobytes_img_format_png_quality_100">#</a></span></h2>
+<div class="signature"><ul>
+<li><code>image</code> <span class="type">&lt;image&gt;</span> 图片</li>
+<li><code>format</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type" class="type">&lt;string&gt;</a> 图片格式，可选的值为:<ul>
+<li><code>png</code></li>
+<li><code>jpeg</code>/<code>jpg</code></li>
+<li><code>webp</code></li>
+</ul>
+</li>
+<li><code>quality</code> <a href="https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type" class="type">&lt;number&gt;</a> 图片质量，为0~100的整数值</li>
+<li>返回 <span class="type">&lt;byte[]&gt;</span></li>
+</ul>
+</div><p>把图片编码为字节数组并返回。</p>
 <h2>images.clip(img, x, y, w, h)<span><a class="mark" href="#images_images_clip_img_x_y_w_h" id="images_images_clip_img_x_y_w_h">#</a></span></h2>
 <div class="signature"><ul>
 <li><code>img</code> <span class="type">&lt;Image&gt;</span> 图片</li>
--- a/app/src/main/assets/indices/all.json
+++ b/app/src/main/assets/indices/all.json
@@ -1811,5 +1811,47 @@
    ],
    "url": "sensors.html",
    "summary": "传感器"
+  },
+  {
+    "name": "engines",
+    "properties": [
+      {
+        "key": "execScript",
+        "summary": "执行脚本",
+        "url": "engines.html#engines_engines_execscript_name_script_config"
+      },
+      {
+        "key": "execScriptFile",
+        "summary": "执行脚本文件",
+        "url": "engines.html#engines_engines_execscriptfile_path_config"
+      },
+      {
+        "key": "execAutoFile",
+        "summary": "执行录制文件",
+        "url": "engines.html#engines_engines_execautofile_path_config"
+      },
+      {
+        "key": "stopAll",
+        "summary": "停止全部",
+        "url": "engines.html#engines_engines_stopall"
+      },
+      {
+        "key": "stopAllAndToast",
+        "summary": "停止并提示",
+        "url": "engines.html#engines_engines_stopallandtoast"
+      },
+      {
+        "key": "myEngine",
+        "summary": "当前引擎",
+        "url": "engines.html#engines_engines_myengine"
+      },
+      {
+        "key": "all",
+        "summary": "所有引擎",
+        "url": "engines.html#engines_engines_all"
+      }
+    ],
+    "url": "engines.html",
+    "summary": "脚本引擎"
  }
 ]