auto.js 入門學習（參考GitHub檔案）

GitHub開發檔案

input([i, ]text)
i {number} 表示要輸入的為第i + 1個輸入框
text {string} 要輸入的文本

App
app模塊提供一系列函式，用于使用其他應用、與其他應用互動，例如發送意圖、打開檔案、發送郵件等，

app.launchApp(appName)
appName {string} 應用名稱
通過應用名稱啟動應用，如果該名稱對應的應用不存在，則回傳false; 否則回傳true，如果該名稱對應多個應用，則只啟動其中某一個，

該函式也可以作為全域函式使用，

app.getPackageName(appName)
appName {string} 應用名稱
獲取應用名稱對應的已安裝的應用的包名，如果該找不到該應用，回傳null；如果該名稱對應多個應用，則只回傳其中某一個的包名，

該函式也可以作為全域函式使用，
app.launch(packageName)
packageName {string} 應用包名
通過應用包名啟動應用，如果該包名對應的應用不存在，則回傳false；否則回傳true，

該函式也可以作為全域函式使用

app.getAppName(packageName)
packageName {string} 應用包名
獲取應用包名對應的已安裝的應用的名稱，如果該找不到該應用，回傳null，

該函式也可以作為全域函式使用，

app.openAppSetting(packageName)
packageName {string} 應用包名
打開應用的詳情頁(設定頁)，如果找不到該應用，回傳false; 否則回傳true，

該函式也可以作為全域函式使用，
app.uninstall(packageName)
packageName {string} 應用包名
卸載應用，執行后會會彈出卸載應用的提示框，如果該包名的應用未安裝，由應用卸載程式處理，可能彈出"未找到應用"的提示，

不是全域變數不能直接使用，需要使用app.unistall(packageName)

app.openUrl(url)
url {string} 網站的Url，如果不以"http://"或"https://"開頭則默認是"http://"，
用瀏覽器打開網站url，

如果沒有安裝瀏覽器應用，則拋出ActivityNotException，

app.sendEmail(options)
options {Object} 發送郵件的引數，包括:
email {string} | {Array} 收件人的郵件地址，如果有多個收件人，則用字串陣串列示
cc {string} | {Array} 抄送收件人的郵件地址，如果有多個抄送收件人，則用字串陣串列示
bcc {string} | {Array} 密送收件人的郵件地址，如果有多個密送收件人，則用字串陣串列示
subject {string} 郵件主題(標題)
text {string} 郵件正文
attachment {string} 附件的路徑，
根據選項options呼叫郵箱應用發送郵件，這些選項均是可選的，

如果沒有安裝郵箱應用，則拋出ActivityNotException，

//發送郵件給10086@qq.com和10001@qq.com，
app.sendEmail({
    email: ["10086@qq.com", "10001@qq.com"],
    subject: "這是一個郵件標題",
    text: "這是郵件正文"
});

app.startActivity(name)
name {string} 活動名稱，可選的值為:
console 日志界面
settings 設定界面
啟動Auto.js的特定界面，該函式在Auto.js內運行則會打開Auto.js內的界面，在打包應用中運行則會打開打包應用的相應界面，

進階: 意圖Intent
Intent(意圖) 是一個訊息傳遞物件，您可以使用它從其他應用組件請求操作，盡管 Intent 可以通過多種方式促進組件之間的通信，但其基本用例主要包括以下三個：

啟動活動(Activity)： Activity 表示應用中的一個"螢屏"，例如應用主入口都是一個Activity，應用的功能通常也以Activity的形式獨立，例如微信的主界面、朋友圈、聊天視窗都是不同的Activity，通過將 Intent 傳遞給 startActivity()，您可以啟動新的 Activity 實體，Intent 描述了要啟動的 Activity，并攜帶了任何必要的資料，

啟動服務(Service)： Service 是一個不使用用戶界面而在后臺執行操作的組件，通過將 Intent 傳遞給 startService()，您可以啟動服務執行一次性操作（例如，下載檔案），Intent 描述了要啟動的服務，并攜帶了任何必要的資料，

傳遞廣播： 廣播是任何應用均可接收的訊息，系統將針對系統事件（例如：系統啟動或設備開始充電時）傳遞各種廣播，通過將 Intent 傳遞給 sendBroadcast()、sendOrderedBroadcast() 或 sendStickyBroadcast()，您可以將廣播傳遞給其他應用，

本模塊提供了構建Intent的函式(app.intent()), 啟動Activity的函式app.startActivity(), 發送廣播的函式app.sendBroadcast()，

使用這些方法可以用來方便的呼叫其他應用，例如直接打開某個QQ號的個人卡片頁，打開某個QQ號的聊天視窗等，

var qq = "2732014414";
app.startActivity({ 
    action: "android.intent.action.VIEW", 
    data:"mqq://im/chat?chat_type=wpa&version=1&src_type=web&uin=" + qq, 
    packageName: "com.tencent.mobileqq", 
});

全域變數與函式

全域變數和函式在所有模塊中均可使用， 但以下變數的作用域只在模塊內，詳見 module：

exports
module
require() 以下的物件是特定于 Auto.js 的， 有些內置物件是 JavaScript 語言本身的一部分，它們也是全域的，
一些模塊中的函式為了使用方便也可以直接全域使用，這些函式在此不再贅述，例如timers模塊的setInterval, setTimeout等函式


sleep(n)
n {number} 毫秒數
暫停運行n毫秒的時間，1秒等于1000毫秒，

currentPackage()
回傳 {string}
回傳最近一次監測到的正在運行的應用的包名，一般可以認為就是當前正在運行的應用的包名，

此函式依賴于無障礙服務，如果服務未啟動，則拋出例外并提示用戶啟動，

currentActivity()
回傳 {string}
回傳最近一次監測到的正在運行的Activity的名稱，一般可以認為就是當前正在運行的Activity的名稱，

此函式依賴于無障礙服務，如果服務未啟動，則拋出例外并提示用戶啟動，

setClip(text)
text {string} 文本
設定剪貼板內容，此剪貼板即系統剪貼板，在一般應用的輸入框中"粘貼"既可使用，

getClip()
回傳 {string}
回傳系統剪貼板的內容，

toast(message)
message {string} 要顯示的資訊
以氣泡顯示資訊message幾秒，(具體時間取決于安卓系統，一般都是2秒)

注意，資訊的顯示是"異步"執行的，并且，不會等待資訊消失程式才繼續執行，如果在回圈中執行該命令，可能出現腳本停止運行后仍然有不斷的氣泡資訊出現的情況，

toastLog(message)
message {string} 要顯示的資訊
相當于toast(message);log(message)，顯示資訊message并在控制臺中輸出，參見console.log，


Type to search
Auto.js檔案
首頁
Q&A
如何閱讀本檔案 - Documentation
應用 - App
一般全域函式 - Globals
sleep(n)
currentPackage()
currentActivity()
setClip(text)
getClip()
toast(message)
toastLog(message)
waitForActivity(activity[, period = 200])
waitForPackage(package[, period = 200])
exit()
random(min, max)
random()
requiresApi(api)
requiresAutojsVersion(version)
runtime.requestPermissions(permissions)
runtime.loadJar(path)
runtime.loadDex(path)
context
控制臺 - Console
基于坐標的操作 - CoordinatesBasedAutomation
設備 - Device
對話框 - Dialogs
腳本引擎 - Engines
事件與監聽 - Events
懸浮窗 - Floaty
檔案系統 - Files
HTTP - Http
圖片與顏色 - Images
畫布 - Canvas
按鍵模擬 - Keys
多媒體 - Media
模塊 - Modules
基于控制元件的操作 - WidgetsBaseAutomation
傳感器 - Sensor
Shell - Shell
本地儲存 - Storages
多執行緒 - Threads
定時器 - Timers
用戶界面 - UI
呼叫Java - Work with Java
全域變數與函式
全域變數和函式在所有模塊中均可使用， 但以下變數的作用域只在模塊內，詳見 module：

exports
module
require() 以下的物件是特定于 Auto.js 的， 有些內置物件是 JavaScript 語言本身的一部分，它們也是全域的，
一些模塊中的函式為了使用方便也可以直接全域使用，這些函式在此不再贅述，例如timers模塊的setInterval, setTimeout等函式，

sleep(n)
n {number} 毫秒數
暫停運行n毫秒的時間，1秒等于1000毫秒，

//暫停5毫秒
sleep(5000);
currentPackage()
回傳 {string}
回傳最近一次監測到的正在運行的應用的包名，一般可以認為就是當前正在運行的應用的包名，

此函式依賴于無障礙服務，如果服務未啟動，則拋出例外并提示用戶啟動，

currentActivity()
回傳 {string}
回傳最近一次監測到的正在運行的Activity的名稱，一般可以認為就是當前正在運行的Activity的名稱，

此函式依賴于無障礙服務，如果服務未啟動，則拋出例外并提示用戶啟動，

setClip(text)
text {string} 文本
設定剪貼板內容，此剪貼板即系統剪貼板，在一般應用的輸入框中"粘貼"既可使用，

setClip("剪貼板文本");
getClip()
回傳 {string}
回傳系統剪貼板的內容，

toast("剪貼板內容為:" + getClip());
toast(message)
message {string} 要顯示的資訊
以氣泡顯示資訊message幾秒，(具體時間取決于安卓系統，一般都是2秒)

注意，資訊的顯示是"異步"執行的，并且，不會等待資訊消失程式才繼續執行，如果在回圈中執行該命令，可能出現腳本停止運行后仍然有不斷的氣泡資訊出現的情況， 例如:

for(var i = 0; i < 100; i++){
  toast(i);
}
運行這段程式以后，會很快執行完成，且不斷彈出訊息，在任務管理中關閉所有腳本也無法停止， 要保證氣泡訊息才繼續執行可以用：

for(var i = 0; i < 100; i++){
  toast(i);
  sleep(2000);
}
或者修改toast函式：

var _toast_ = toast;
toast = function(message){
  _toast_(message);
  sleep(2000);
}
for(var i = 0; i < 100; i++){
  toast(i);
}
toastLog(message)
message {string} 要顯示的資訊
相當于toast(message);log(message)，顯示資訊message并在控制臺中輸出，參見console.log，

waitForActivity(activity[, period = 200])
activity Activity名稱
period 輪詢等待間隔（毫秒）
等待指定的Activity出現，period為檢查Activity的間隔，

waitForPackage(package[, period = 200])
package 包名
period 輪詢等待間隔（毫秒）
等待指定的應用出現，例如waitForPackage("com.tencent.mm")為等待當前界面為微信，

exit()
立即停止腳本運行，

立即停止是通過拋出ScriptInterrupttedException來實作的，因此如果用try...catch把exit()函式的例外捕捉，則腳本不會立即停止，仍會運行幾行后再停止，

random(min, max)
min {number} 亂數產生的區間下界
max {number} 亂數產生的區間上界
回傳 {number}
回傳一個在[min...max]之間的亂數，例如random(0, 2)可能產生0, 1, 2，

random()
回傳 {number}
回傳在[0, 1)的隨機浮點數，
requiresApi(api)
api Android版本號
表示此腳本需要Android API版本達到指定版本才能運行，例如requiresApi(19)表示腳本需要在Android 4.4以及以上運行，

呼叫該函式時會判斷運行腳本的設備系統的版本號，如果沒有達到要求則拋出例外，

可以參考以下Android API和版本的對照表:

平臺版本： API級別

Android 7.0： 24

Android 6.0： 23

Android 5.1： 22

Android 5.0： 21

Android 4.4W： 20

Android 4.4： 19

Android 4.3： 18

runtime.requestPermissions(permissions)
permissions {Array} 權限的字串陣列
動態申請安卓的權限，例如：

//請求GPS權限
runtime.requestPermissions(["access_fine_location"]);
盡管安卓有很多權限，但必須寫入Manifest才能動態申請，為了防止權限的濫用，目前Auto.js只能額外申請兩個權限：

access_fine_location GPS權限
record_audio 錄音權限

context
全域變數，一個android.content.Context物件，

注意該物件為ApplicationContext，因此不能用于界面、對話框等的創建，

Console

控制臺模塊提供了一個和Web瀏覽器中相似的用于除錯的控制臺，用于輸出一些除錯資訊、中間結果等， console模塊中的一些函式也可以直接作為全域函式使用，例如log, print等，

console.show()
顯示控制臺，這會顯示一個控制臺的懸浮窗(需要懸浮窗權限)，

console.hide()
隱藏控制臺懸浮窗，

console.clear()
清空控制臺，

console.log([data][, ...args])
data {any}
...args {any}
列印到控制臺，并帶上換行符， 可以傳入多個引數，第一個引數作為主要資訊，其他引數作為類似于 printf(3) 中的代替值（引數都會傳給 util.format()），

const count = 5;
console.log('count: %d', count);
// 列印: count: 5 到 stdout
console.log('count:', count);
// 列印: count: 5 到 stdout
詳見 util.format()，

該函式也可以作為全域函式使用，

console.verbose([data][, ...args])
data {any}
...args {any}
與console.log類似，但輸出結果以灰色字體顯示，輸出優先級低于log，用于輸出觀察性質的資訊，

console.info([data][, ...args])
data {any}
...args {any}
與console.log類似，但輸出結果以綠色字體顯示，輸出優先級高于log, 用于輸出重要資訊，

console.warn([data][, ...args])
data {any}
...args {any}
與console.log類似，但輸出結果以藍色字體顯示，輸出優先級高于info, 用于輸出警告資訊，

console.error([data][, ...args])
data {any}
...args {any}
與console.log類似，但輸出結果以紅色字體顯示，輸出優先級高于warn, 用于輸出錯誤資訊，

console.assert(value, message)
value {any} 要斷言的布林值
message {string} value為false時要輸出的資訊
斷言，如果value為false則輸出錯誤資訊message并停止腳本運行，

var a = 1 + 1;
console.assert(a == 2, "加法出錯啦");
console.time([label])
[v4.1.0新增]

label {String} 計時器標簽，可省略
啟動一個定時器，用以計算一個操作的持續時間， 定時器由一個唯一的 label 標識， 當呼叫 console.timeEnd() 時，可以使用相同的 label 來停止定時器，并以毫秒為單位將持續時間輸出到控制臺， 重復啟動同一個標簽的定時器會覆寫之前啟動同一標簽的定時器，

console.timeEnd(label)
[v4.1.0新增]

label {String} 計時器標簽
停止之前通過呼叫 console.time() 啟動的定時器，并列印結果到控制臺， 呼叫 console.timeEnd() 后定時器會被洗掉，如果不存在標簽指定的定時器則會列印 NaNms，

console.time('求和');
var sum = 0;
for(let i = 0; i < 100000; i++){
    sum += i;
}
console.timeEnd('求和');
// 列印 求和: xxx ms
console.trace([data][, ...args])
[v4.1.0新增]

data {any}
...args {any}
與console.log類似，同時會列印出呼叫這個函式所在的呼叫堆疊資訊（即當前運行的檔案、行數等資訊），

console.trace('Show me');
// 列印: (堆疊跟蹤會根據被呼叫的跟蹤的位置而變化)
// Show me
//  at <test>:7
console.input(data[, ...args])
data {any}
...args {any}
與console.log一樣輸出資訊，并在控制臺顯示輸入框等待輸入，按控制臺的確認按鈕后會將輸入的字串用eval計算后回傳，

部分機型可能會有控制臺不顯示輸入框的情況，屬于bug，

例如：

var n = console.input("請輸入一個數字:"); 
//輸入123之后：
toast(n + 1);
//顯示124
console.rawInput(data[, ...args])
data {any}
...args {any}
與console.log一樣輸出資訊，并在控制臺顯示輸入框等待輸入，按控制臺的確認按鈕后會將輸入的字串直接回傳，

部分機型可能會有控制臺不顯示輸入框的情況，屬于bug，

例如：

var n = console.rawInput("請輸入一個數字:"); 
//輸入123之后：
toast(n + 1);
//顯示1231
console.setSize(w, h)
w {number} 寬度
h {number} 高度
設定控制臺的大小，單位像素，

console.show();
//設定控制臺大小為螢屏的四分之一
console.setSize(device.width / 2, device.height / 2);
console.setPosition(x, y)
x {number} 橫坐標
y {number} 縱坐標
設定控制臺的位置，單位像素，

console.show();
console.setPosition(100, 100);
console.setGlobalLogConfig(config)
[v4.1.0新增]

config {Object} 日志配置，可選的項有：
file {string} 日志檔案路徑，將會把日志寫入該檔案中
maxFileSize {number} 最大檔案大小，單位位元組，默認為512 * 1024 (512KB)
rootLevel {string} 寫入的日志級別，默認為"ALL"（所有日志），可以為"OFF"(關閉), "DEBUG", "INFO", "WARN", "ERROR", "FATAL"等，
maxBackupSize {number} 日志備份檔案最大數量，默認為5
filePattern {string} 日志寫入格式，參見PatternLayout
設定日志保存的路徑和配置，例如把日志保存到"/sdcard/1.txt":

console.setGlobalLogConfig({
    "file": "/sdcard/1.txt"
});
注意該函式會影響所有腳本的日志記錄，

print(text)
text {string} | {Object} 要列印到控制臺的資訊
相當于log(text)，

基于坐標的觸摸模擬

本章節介紹了一些使用坐標進行點擊、滑動的函式，這些函式有的需要安卓7.0以上，有的需要root權限，

要獲取要點擊的位置的坐標，可以在開發者選項中開啟"指標位置"，

基于坐標的腳本通常會有解析度的問題，這時可以通過setScreenMetrics()函式來進行自動坐標放縮，這個函式會影響本章節的所有點擊、長按、滑動等函式，通過設定腳本設計時的解析度，使得腳本在其他解析度下自動放縮坐標，

控制元件和坐標也可以相互結合，一些控制元件是無法點擊的(clickable為false), 無法通過.click()函式來點擊，這時如果安卓版本在7.0以上或者有root權限，就可以通過以下方式來點擊

setScreenMetrics(width, height)
width {number} 螢屏寬度，單位像素
height {number} 螢屏高度，單位像素
設定腳本坐標點擊所適合的螢屏寬高，如果腳本運行時，螢屏寬度不一致會自動放縮坐標，

click(x, y)
x {number} 要點擊的坐標的x值
y {number} 要點擊的坐標的y值
模擬點擊坐標(x, y)，并回傳是否點擊成功，只有在點擊執行完成后腳本才繼續執行，

一般而言，只有點擊程序(大約150毫秒)中被其他事件中斷(例如用戶自行點擊)才會點擊失敗，

使用該函式模擬連續點擊時可能有點擊速度過慢的問題，這時可以用press()函式代替，

longClick(x, y)
x {number} 要長按的坐標的x值
y {number} 要長按的坐標的y值
模擬長按坐標(x, y), 并回傳是否成功，只有在長按執行完成（大約600毫秒）時腳本才會繼續執行，

一般而言，只有長按程序中被其他事件中斷(例如用戶自行點擊)才會長按失敗，

longClick(x, y)
x {number} 要長按的坐標的x值
y {number} 要長按的坐標的y值
模擬長按坐標(x, y), 并回傳是否成功，只有在長按執行完成（大約600毫秒）時腳本才會繼續執行，

一般而言，只有長按程序中被其他事件中斷(例如用戶自行點擊)才會長按失敗，

swipe(x1, y1, x2, y2, duration)
x1 {number} 滑動的起始坐標的x值
y1 {number} 滑動的起始坐標的y值
x2 {number} 滑動的結束坐標的x值
y2 {number} 滑動的結束坐標的y值
duration {number} 滑動時長，單位毫秒
模擬從坐標(x1, y1)滑動到坐標(x2, y2)，并回傳是否成功，只有滑動操作執行完成時腳本才會繼續執行，

一般而言，只有滑動程序中被其他事件中斷才會滑動失敗，

gesture(duration, [x1, y1], [x2, y2], ...)
duration {number} 手勢的時長
[x, y] ... 手勢滑動路徑的一系列坐標
模擬手勢操作，例如gesture(1000, [0, 0], [500, 500], [500, 1000])為模擬一個從(0, 0)到(500, 500)到(500, 100)的手勢操作，時長為2秒，

Tap(x, y)
x, y {number} 要點擊的坐標，
點擊位置(x, y), 您可以通過"開發者選項"開啟指標位置來確定點擊坐標，

Swipe(x1, y1, x2, y2, [duration])
x1, y1 {number} 滑動起點的坐標
x2, y2 {number} 滑動終點的坐標
duration {number} 滑動動作所用的時間
滑動，從(x1, y1)位置滑動到(x2, y2)位置，