傳送模擬器主控台指令

每部執行中的虛擬裝置都提供主控台，可讓您查詢及控管模擬裝置環境。舉例來說，您可以在應用程式透過模擬器執行時，使用主控台管理通訊埠重新導向、網路特性和電話通訊事件。

如要執行下列指令，您必須有執行中的模擬器。如要進一步瞭解如何執行模擬器，請參閱「在 Android Emulator 上執行應用程式」及「透過指令列啟動模擬器」。

啟動及停止主控台工作階段

如要存取主控台並輸入指令，請在終端機視窗中使用 telnet 連線至主控台通訊埠，並提供您的驗證權杖。只要主控台顯示「OK」，就表示可以接受指令。主控台並不會提供一般的提示。

如何連線至執行中虛擬裝置的主控台：

1. 開啟終端機視窗，然後輸入以下指令：

   telnet localhost console-port
   

   在獨立視窗中執行時，模擬器視窗標題會列出主控台通訊埠號碼，但在工具視窗中執行時不會。舉例來說，如果是使用主控台通訊埠 5554 的模擬器，則視窗標題可能是 Pixel8_API_34:5554。此外，adb devices 指令會顯示執行中的虛擬裝置及其主控台通訊埠號碼清單。詳情請參閱「查詢裝置」相關說明。

   注意：模擬器會監聽通訊埠 5554 至 5585 的連線，且僅接受來自 localhost 的連線。

2. 主控台顯示「OK」 後，輸入 auth auth_token 指令。

   模擬器主控台會要求進行驗證，通過驗證後，您才能輸入主控台指令。auth_token 必須與主目錄中的 .emulator_console_auth_token 檔案內容相符。

   如果該檔案不存在，telnet localhost console-port 指令會建立該檔案，其中包含隨機產生的驗證權杖。如要停用驗證功能，請將權杖從 .emulator_console_auth_token 檔案中刪除，或是建立空白檔案 (如果檔案不存在)。

3. 連線至主控台後，輸入主控台指令。

   輸入 help、help command 或 help-verbose 可查看主控台指令清單，並瞭解特定指令。

4. 如要結束主控台工作階段，請輸入 quit 或 exit。

工作階段範例如下：

$ telnet localhost 5554
Trying ::1...
telnet: connect to address ::1: Connection refused
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.
Android Console: Authentication required
Android Console: type 'auth <auth_token>' to authenticate
Android Console: you can find your <auth_token> in
'/Users/me/.emulator_console_auth_token'
OK
auth 123456789ABCdefZ
Android Console: type 'help' for a list of commands
OK
help-verbose
Android console command help:
    help|h|?         Prints a list of commands
    help-verbose     Prints a list of commands with descriptions
    ping             Checks if the emulator is alive
    automation       Manages emulator automation
    event            Simulates hardware events
    geo              Geo-location commands
    gsm              GSM related commands
    cdma             CDMA related commands
    crash            Crashes the emulator instance
    crash-on-exit    Simulates crash on exit for the emulator instance
    kill             Terminates the emulator instance
    restart          Restarts the emulator instance
    network          Manages network settings  (ethernet and cellular only)
    power            Power related commands
    quit|exit        Quits control session
    redir            Manages port redirections
    sms              SMS related commands
    avd              Controls virtual device execution
    qemu             QEMU-specific commands
    sensor           Manages emulator sensors
    physics          Manages physical model
    finger           Manages emulator finger print
    debug            Controls the emulator debug output tags
    rotate           Rotates the screen clockwise by 90 degrees
    screenrecord     Records the emulator's display
    fold             Folds the device
    unfold           Unfolds the device
    multidisplay     Configures the multi-display
    nodraw           turn on/off NoDraw mode. (experimental)
    resize-display   resize the display resolution to the preset size
    virtualscene-image  customize virtualscene image for virtulscene camera
    proxy            manage network proxy server settings
    phonenumber      set phone number for the device

try 'help <command>' for command-specific help
OK
exit
Connection closed by foreign host.

啟動後便不須控制的指令

如果不需要開啟工作階段，請使用 adb emu 快速鍵，執行指令並立即將控制權傳回叫用殼層：

adb emu command commandParameter

使用 adb emu 叫用時，系統會連線至可用的模擬器。如果同時執行多個模擬器，您必須傳入目標模擬器的序號：

adb -s emulator-serial emu command commandParameter

模擬器指令參考資料

以下清單說明模擬器主控台指令，以及指令的參數和值：

一般指令

• avd {stop| start| status| name} 查詢、控制及管理虛擬裝置，相關參數如下：

  • 停止：停止執行裝置。
  • start：開始執行裝置。
  • 狀態：查詢虛擬裝置狀態 (可能是執行中或已停止)。
  • name：查詢虛擬裝置名稱。

• avd snapshot {list| save name| load name| delete name} 利用快照儲存或還原裝置狀態，相關參數如下：

  • list：列出所有已儲存的快照。
  • save name：將快照儲存為名稱。
  • 載入名稱：載入指定快照。
  • delete name：刪除指定快照。

  以下範例會使用 firstactivitysnapshot 名稱儲存快照：

  avd snapshot save firstactivitysnapshot
  

• fold：摺疊裝置以顯示較小的螢幕設定 (如果是摺疊式裝置且目前未處於展開狀態)。

• unfold：展開裝置以顯示較大的螢幕設定 (如果是折疊式裝置且目前處於折疊狀態)。

• kill：終止虛擬裝置。

• ping：檢查虛擬裝置是否正在執行。

• 旋轉：將 AVD 逆時針旋轉 45 度。

讓模擬器停止運作

• crash：在應用程式執行期間讓模擬器停止運作。

• crash-on-exit：在應用程式結束時讓模擬器停止運作。

偵錯標記

• debug tags ...：啟用或停用模擬器特定部分的偵錯訊息。tags 參數必須是執行 emulator -help-debug-tags 時顯示的偵錯標記清單所含的值。如要進一步瞭解 -help-debug-tags 選項，請參閱常用選項的表格。以下範例會啟用 radio 標記：

  debug radio
  

通訊埠重新導向

• redir list：列出目前的通訊埠重新導向。

• redir add protocol:host-port:guest-port 新增通訊埠重新導向，相關參數如下：

  • 通訊協定：必須是 tcp 或 udp。
  • host-port：要在主機上開啟的通訊埠號碼。
  • guest-port：要在模擬器上將資料轉送過去的通訊埠號碼。

• redir del protocol:host-port 刪除通訊埠重新導向。

  • 通訊協定：必須是 tcp 或 udp。
  • host-port：要在主機上開啟的通訊埠號碼。

地理位置

將 GPS 定位傳送至模擬器，設定向模擬器中執行的應用程式回報的地理位置。

虛擬裝置開始執行後，您隨即可發出下列任一地理位置指令。模擬器會建立模擬位置提供者，藉此設定您輸入的位置。這個提供者會回應由應用程式設定的位置事件監聽器，同時也會向 LocationManager 提供位置資訊。所有應用程式都可呼叫 LocationManager.getLastKnownLocation("gps") 查詢位置管理員，取得模擬裝置目前的 GPS 定位。

• geo fix longitude latitude [altitude] [satellites] [velocity]：將簡易 GPS 定位傳送至模擬器。以十進制度數指定經緯度。請使用介於 1 到 12 之間的數字，指定要用於判斷位置的衛星數量，並指定海拔高度 (以公尺為單位) 和速度 (以節為單位)。

• geo nmea 句子：將 NMEA 0183 句子傳送至模擬裝置，就像從模擬 GPS 數據機傳送一樣。句子開頭必須是「$GP」。目前僅支援「$GPGGA」和「$GPRCM」句子。以下範例是 GPGGA (全球定位系統定位資料) 句子，可取得 GPS 接收器的時間、位置和定位資料：

  geo nmea $GPGGA,hhmmss.ss,llll.ll,a,yyyyy.yy,a,x,xx,x.x,x.x,M,x.x,M,x.x,xxxx
  

假硬體事件

模擬器控制台的硬體事件子系統可讓您模擬與裝置的任何實體互動。包括實體按鈕、螢幕觸控/手勢、旋轉撥號、搖桿輸入和硬體切換開關。

• 事件類型：列出所有假事件類型。如果事件包含代碼，右側的括號中會列出代碼數量。輸出內容範例：

  event types
  event <type> can be an integer or one of the following aliases:
      EV_SYN
      EV_KEY    (405 code aliases)
      EV_REL    (2 code aliases)
      EV_ABS    (27 code aliases)
      EV_MSC
      EV_SW     (4 code aliases)
      EV_LED
      EV_SND
      EV_REP
      EV_FF
      EV_PWR
      EV_FF_STATUS
      EV_MAX
  OK
  

• event send types [types ...]：傳送一或多個假事件類型。

• 事件代碼類型：列出指定假事件類型的事件代碼。

• event send type[:code]:[value] [...]：傳送一或多個包含選用代碼和代碼值的假事件。

EV_KEY - 金鑰代碼參照

EV_KEY 事件類型用於模擬按鈕按下和放開的動作。下表將支援的按鍵代碼清單分成邏輯類別。針對每個鍵碼，傳送 1 值會模擬按下按鍵，而傳送 0 值則會模擬放開按鍵。2 值代表按鍵重複。

子表格 A：Android 系統按鍵

子表 B：媒體和播放控制項

子資料表 C：導覽和一般鍵盤

子表 D：英數字元和鍵盤符號

• 標準字母： KEY_A 到 KEY_Z (26 個代碼)。
• 數字鍵盤按鍵： KEY_1 到 KEY_0 (10 個代碼)。

子表 E：輔助鍵和功能鍵

• 標準功能鍵： KEY_F1 到 KEY_F24 (24 個代碼)。

子表格 F：遊戲手把和搖桿

子表 G：滑鼠、觸控和觸控筆輸入

子表 H：應用程式捷徑

EV_ABS - 絕對動作事件

EV_ABS 事件類型對於模擬精確觸控、拖曳手勢、多點觸控縮放動作和搖桿調整至關重要。地圖下方的絕對座標會直接對應至基礎實體螢幕解析度。

Android 觸控互動是由多點觸控 (MT) 通訊協定驅動。新式模擬器會實作通訊協定 A (無狀態，傳送以同步標記分隔的聯絡人封包) 和通訊協定 B (有狀態，將聯絡人指派給專用追蹤位置)。通訊協定 B 可有效追蹤多個並行觸控手勢，例如雙指撥動縮放。

EV_REL 和 EV_SW - 動態和硬體切換鈕

EV_REL 事件類別會管理相對指標或座標變更，主要用於模擬外部滑鼠移動或捲動滾輪。EV_SW 事件類別會管理實體裝置切換，例如摺疊式手機或平板電腦是否摺疊，或是是否插入外部音訊硬體。

指令調度語法

如要傳送這些代碼，請以半形冒號分隔型別、代碼和值，格式化控制台指令。您可以在單一字串中將多項座標變更排入佇列。請務必一律附加最終同步標記 (EV_SYN:0:0)，指出模擬器架構應將這些輸入內容一併打包及處理。

事件指令碼和手勢範例

由於 Telnet 允許傳送多部分參數，因此您可以模擬實際的手勢序列。以下是原始事件指令碼結構，可自動執行主控台的手勢。

模擬輕觸螢幕

如要在目標座標執行乾淨的螢幕輕觸操作，請指派追蹤 ID、在畫面上指定 X 和 Y 座標、模擬觸控、同步處理，然後放開。

# Press down at coordinate (400, 800) and sync
event send EV_ABS:ABS_MT_TRACKING_ID:1
OK
event send EV_ABS:ABS_MT_POSITION_X:400
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Lift finger up and sync
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

模擬垂直捲動 (滑動)

如要執行捲動滑動手勢，請按住起始座標的聯絡人， 傳送中間移動座標影格，然後在結尾放開。

# Finger touch down at start coordinate (500, 1600)
event send EV_ABS:ABS_MT_TRACKING_ID:2
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1600
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Move coordinates upward dynamically
event send EV_ABS:ABS_MT_POSITION_Y:1200
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:800
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_POSITION_Y:400
OK
event send EV_SYN:0:0
OK
# Finger release at coordinate (500, 400)
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

模擬雙指撥動縮放手勢

如要觸發雙指縮放，請使用有效的 MT 時段 (0 和 1) 追蹤並協調兩個同時觸控的座標，使其彼此遠離。

# Finger 1 down at (500, 1000) using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:10
OK
event send EV_ABS:ABS_MT_POSITION_X:500
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_KEY:BTN_TOUCH:1
OK
event send EV_SYN:0:0
OK
# Finger 2 down at (600, 1000) using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:11
OK
event send EV_ABS:ABS_MT_POSITION_X:600
OK
event send EV_ABS:ABS_MT_POSITION_Y:1000
OK
event send EV_SYN:0:0
OK
# Fingers slide apart from each other
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_POSITION_X:300
OK
event send EV_SYN:0:0
OK
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_POSITION_X:800
OK
event send EV_SYN:0:0
OK
# Lift Finger 1 using slot 0
event send EV_ABS:ABS_MT_SLOT:0
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_SYN:0:0
OK
# Lift Finger 2 using slot 1
event send EV_ABS:ABS_MT_SLOT:1
OK
event send EV_ABS:ABS_MT_TRACKING_ID:-1
OK
event send EV_KEY:BTN_TOUCH:0
OK
event send EV_SYN:0:0
OK

模擬耳機連線切換

模擬插入或拔除耳機插孔，測試音訊路徑切換。1 值代表插入耳機插孔，0 則代表取下耳機。

# Simulate headphones plugged in
event send EV_SW:SW_HEADPHONE_INSERT:1 EV_SYN:0:0
OK
# Simulate headphones unplugged
event send EV_SW:SW_HEADPHONE_INSERT:0 EV_SYN:0:0
OK

從實體裝置探索控制台事件代碼

如要找出任何自訂動作或按鈕手勢的確切事件語法序列，請透過 adb shell 連線，然後執行 getevent 診斷公用程式。與模擬器 GUI 互動時，控制台會列印確切的事件代碼、類型和位置。

# Run getevent to monitor input events dynamically
adb shell getevent -lt
/dev/input/event12: EV_KEY       KEY_POWER            DOWN
/dev/input/event12: EV_SYN       SYN_REPORT           00000000
/dev/input/event12: EV_KEY       KEY_POWER            UP
/dev/input/event12: EV_SYN       SYN_REPORT           00000000

• event text message：傳送用於模擬按鍵操作的字元字串。 訊息必須是 UTF-8 字串。系統會根據目前的裝置鍵盤將萬國碼 (Unicode) 訊息進行反向對應，並自動捨棄不支援的字元。

電源狀態控制項

• 電源顯示：顯示電池和充電器狀態。

• power ac {on| off}：將 AC 充電狀態設為開啟或關閉。

• 電源狀態 {unknown| charging| discharging| not-charging| full}：將電池狀態變更為指定狀態。

• power present {true| false}：設定電池有無狀態。

• power health {unknown| good| overheat| dead| overvoltage| failure}：設定電池健康狀態。

• 電量百分比：將剩餘電池容量狀態設為 0 到 100 之間的百分比。

網路連線狀態 (僅限乙太網路和行動網路)

• 網路狀態：檢查網路狀態，以及目前的延遲時間和速度特性。

• network delay latency 變更模擬的網路延遲時間。

  模擬器可讓您模擬各種網路延遲程度，在較貼近實際運作狀況的環境中測試應用程式。您可以在模擬器啟動時設定延遲程度或範圍，也可以在應用程式透過模擬器執行時，使用主控台變更延遲時間。

  網路延遲必須採用下列其中一種格式 (數字的單位為毫秒)：

  網路延遲時間格式：

• gprs：GPRS，使用介於 150 至 550 之間的延遲時間範圍。

• edge：EDGE/EGPRS，使用介於 80 至 400 之間的延遲時間範圍。

• umts：UMTS/3G，使用介於 35 至 200 之間的延遲時間範圍。

• none：沒有延遲。

• num：模擬指定的延遲時間 (以毫秒為單位)。

• min:max：模擬指定的延遲時間範圍。

  如要在模擬器啟動時設定延遲時間，請使用 -netdelay 模擬器選項，並提供支援的延遲時間值。範例：

  emulator -netdelay gprs
  emulator -netdelay 40,100
  

  如要在模擬器執行期間變更網路延遲時間，請連線至主控台，然後使用 network delay 指令：

  network delay gprs
  network delay 40 100
  

• network speed speed 模擬器可讓您模擬各種網路傳輸速率。您可以在模擬器啟動時設定傳輸速率或範圍，也可以在應用程式透過模擬器執行時，使用主控台變更速率。

  網路速度必須採用下列其中一種格式 (數字的單位為千位元/秒)：

  網路速度格式：

• gsm：GSM/CSD，所用的上傳速度為 14.4，下載速度為 14.4。

• hscsd：HSCSD，所用的上傳速度為 14.4，下載速度為 43.2。

• gprs：GPRS，所用的上傳速度為 40.0，下載速度為 80.0。

• edge：EDGE/EGPRS，所用的上傳速度為 118.4，下載速度為 236.8。

• umts：UMTS/3G，所用的上傳速度為 128.0，下載速度為 1920。

• hsdpa：HSDPA，所用的上傳速度為 348.0，下載速度為 14,400.0。

• lte：LTE，所用的上傳速度為 58,000，下載速度為 173,000。

• evdo：EVDO，所用的上傳速度為 75,000，下載速度為 280,000。

• 完整：無速度限制，但實際速度會因電腦連線速度而異。

• num：以千位元/秒為單位，統一設定確切的上傳和下載速率。

• up:down：以千位元/秒為單位，分別設定確切的上傳和下載速率。

  如要在模擬器啟動時設定網路速度，請使用 -netspeed 模擬器選項。範例：

  emulator -netspeed gsm @Pixel_API_26
  emulator -netspeed 14.4,80 @Pixel_API_26
  

  如要在模擬器執行期間變更網路速度，請連線至主控台，然後使用 network speed 指令：

  network speed 14.4 80
  

• network capture {start| stop} file 將封包傳送至檔案。以下清單說明相關參數和參數值：

  注意：從 Android 模擬器 36.5 以上版本開始，Wi-Fi 連線流量預設會由 netsim 處理。網路擷取控制台指令只會擷取透過 QEMU slirp 堆疊路由傳送的舊版行動網路/WAN 流量。如要在新版模擬器中擷取 Wi-Fi、藍牙或進階網路封包，請參閱「進階模擬器網路」指南中的「擷取網路流量」。

• start file：開始擷取網路封包。為確保安全，檔案必須是裸露的檔案名稱 (沒有路徑分隔符號，例如 /，也沒有 ..)。封包擷取檔案會儲存在 AVD 的內容目錄下 console_out/ 資料夾中 (例如 ~/.android/avd/avd_name.avd/console_out/file)。

• stop file：停止將封包傳送至指定檔案。

電話通訊模擬

Android Emulator 提供專屬的 GSM 和 CDMA 模擬數據機，可讓您在模擬器中模擬電話通訊功能。舉例來說，您可以使用 GSM 模擬來電，以及建立和終止數據連線。CDMA 則可用來提供訂閱來源和偏好的漫遊清單。Android 系統會完全以處理實際通話的方式處理模擬通話。模擬器不支援通話音訊。

• gsm {call| accept| cancel| busy} phonenumber gsm 參數如下：

  • call：模擬來自電話號碼的來電。
  • accept：接聽來自電話號碼的來電，並將通話狀態變更為有效。只有在通話目前處於等待或保留狀態時，您才能將通話狀態變更為有效。
  • cancel：終止來自或撥給電話號碼的來電/外撥通話。
  • busy：結束打給電話號碼的外撥通話，並將通話狀態變更為忙線。只有在通話目前處於等待狀態時，您才能將通話狀態變更為忙線。

• gsm {data| voice} state 數據狀態指令會變更 GPRS 數據連線的狀態，語音狀態指令則會變更 GPRS 語音連線的狀態，如下所示：

  • 未註冊：無法連上網路。
  • home：使用區域網路，非漫遊。
  • 漫遊：使用漫遊網路。
  • searching：正在搜尋網路。
  • 已拒絕：僅可撥打緊急電話。
  • off：與未註冊相同。
  • on：與 home 相同。

• gsm hold：將通話狀態變更為暫停。只有在通話目前處於有效或等待狀態時，您才能將通話狀態變更為保留。

• gsm list：列出所有來電和外撥通話及其狀態。

• gsm status：回報目前的 GSM 語音/數據狀態，會是語音和資料指令說明中所列的值。

• gsm signal {rssi| ber} 變更下一個 15 秒更新期回報的訊號強度 (rssi) 和位元錯誤率 (ber)。以下清單說明相關參數和參數值：

  • rssi：範圍介於 0 到 31 之間，99 表示不明。
  • ber：範圍介於 0 到 7 之間，99 表示不明。

• gsm signal-profile num：設定訊號強度設定檔。num 是介於 0 到 4 之間的數字。

• cdma ssource source 設定目前的 CDMA 訂閱來源，其中來源是包含 CDMA 電信業者訂閱者及其值的網路許可清單，相關說明如下：

  • nv：從非揮發性 RAM 讀取訂閱項目。
  • ruim：從可移除的使用者身分識別模組 (RUIM) 讀取訂閱項目。

• cdma prl_version version：轉儲目前的偏好漫遊清單 (PRL) 版本。版本號碼會用於 PRL 資料庫，該資料庫包含系統選取和獲取程序中使用的資訊。

管理模擬器中的感應器

這些指令與 AVD 中可用的感應器相關。除了使用感應器指令以外，您也可以在模擬器的「Virtual sensors」畫面中，透過「Accelerometer」和「Additional sensors」分頁查看及調整相關設定。

• 感應器狀態：列出所有感應器及其狀態。

• sensor get sensor-name：取得 sensor-name 的設定。以下範例會取得加速感應器的值：

  sensor get acceleration
  acceleration = 2.23517e-07:9.77631:0.812348
  

  以冒號(:) 分隔的加速度值指的是虛擬感應器的 x、y 和 z 座標。

• sensor set sensor-name value-x:value-y:value-z：為 sensor-name 設定值。以下範例會將加速感應器設為 x、y 和 z 值 (以冒號分隔)。

  sensor set acceleration 2.23517e-07:9.77631:0.812348
  

簡訊模擬

• sms send sender-phone-number textmessage 產生模擬的傳入簡訊。以下清單說明相關參數和參數值：

  • sender-phone-number：包含任意數字字串。
  • textmessage：簡訊內容。

  以下範例會將「hi there」訊息傳送至 4085555555 這支電話號碼：

  sms send 4085555555 hi there
  

主控台會將簡訊轉寄至 Android 架構，再由該架構將其傳送至模擬器中負責處理簡訊的應用程式 (例如「訊息」應用程式)。如果傳送 10 個數字，應用程式會將其格式化為電話號碼。長短數字字串會依您傳送的方式顯示。

指紋模擬

• finger touch fingerprint-id：模擬手指觸碰感應器的情形。

• finger remove：模擬手指移開的情形。

想瞭解如何使用這些指令，請參閱以下的「指紋模擬和驗證」一節。

螢幕畫面錄製

螢幕錄影指令可直接從主機系統擷取模擬器實體螢幕的高畫質影片檔案。這項功能對於持續整合管道和自動錯誤報告非常實用。

• screenrecord {start| stop} file 開始或停止螢幕錄製程序。
  • 開始檔案：開始錄製影片。輸出檔案的結尾必須是強制性的 .webm 副檔名。擷取的影片會直接儲存在 AVD 的控制台輸出目錄下：~/.android/avd/avd_name.avd/console_out/file。
  • stop file：停止執行中的螢幕錄製程序。

自動化與巨集

開發人員可透過自動化子系統，在執行中的虛擬裝置上錄製巨集狀態轉換，並播放這些轉換來執行自動化測試流程。

• automation {record| stop-record| play| stop-play} 管理自動巨集錄製。
  • 記錄：開始記錄裝置狀態變化和輸入內容。
  • stop-record：停止目前巨集錄製工作階段。
  • play：開始播放錄製的巨集序列。
  • stop-play：停止播放目前啟用的巨集序列。

物理 (6DoF)

物理指令會管理六自由度 (6DoF) 實體動作模型的真值空間姿勢記錄，用於模擬進階動作追蹤。

• physics {record-gt| stop} 管理實體姿勢模型錄製內容。
  • record-gt：開始記錄實際的 6DoF 動作資料。
  • 停止：停止目前的實況錄製程序。

進階裝置控制

本節彙整了高度專業的控制台指令端點，適用於進階模擬設定，包括網路 Proxy、多螢幕設定、算繪覆寫和 Hypervisor 直接偵錯。

• multidisplay {add| del} 新增或刪除次要虛擬螢幕，測試多螢幕設定。注意：Pixel Fold 或可調整大小的模擬器等摺疊設定檔不支援次要螢幕。

• proxy {set| clear} 從控制台以程式輔助方式設定網路 Proxy 轉送。

  • 設定主機通訊埠：設定目標 Proxy 設定。
  • clear：將 Proxy 設定還原為預設值。 注意：在無頭執行環境中，Proxy 設定作業會失敗。

• virtualscene-image {wall| table} image_path使用自訂使用者圖片檔案，自訂虛擬場景攝影機畫面中顯示的背景牆或水平桌。

• resize-display scale 在預設比例之間動態調整螢幕解析度。注意： 無螢幕設定不支援解析度調整。

• nodraw {on| off} 在主機螢幕上停用實體 GUI 轉譯，以減少大量背景無頭自動化執行期間的系統記憶體和 GPU 負載。

• grpc port 透過自訂 gRPC 連接埠端點，設定進階程式輔助裝置控制項。

• qemu monitor 提供基礎管理程序的直接互動式終端機存取權。這項指令只能透過有效的 Telnet 控制台工作階段輸入。

• icebox track pid 在指定應用程式程序發生未處理的例外狀況或當機時，啟用自動系統快照。

• phonenumber number 設定目標裝置的虛擬本地電話號碼。

gRPC 程式輔助介面

新版模擬器除了支援舊版 Telnet 控制台，也提供強大的 gRPC 程式設計介面。雖然 Telnet 控制台很適合用於快速互動式工作階段或簡單的指令碼，但 gRPC 介面專為持續整合 (CI) 和無周邊環境中的高效能、安全且穩固的自動化控制而設計。gRPC 提供直接服務端點，因此不必剖析文字串流、管理終端工作階段交握，或公開未加密的本機主機通訊埠。

如要選擇舊版 Telnet 控制台或新版 gRPC 程式輔助介面，請參閱下列效能、安全性及功能比較：

啟動及呼叫 gRPC

如要使用 gRPC 端點，請從指令列啟動 Android 模擬器，並加入 -grpc 標記，指定目標迴路介面埠。

# Start the emulator with the gRPC service enabled on port 8556
emulator -grpc localhost:8556 @Pixel_Fold

啟用 gRPC 服務並執行模擬器後，您就可以發出程式輔助 RPC 呼叫。如要進行指令列測試，請使用 grpcurl 公用程式與模擬器的服務通訊。所有要求都會以 JSON 格式傳送，並透過純文字傳送。

# Query the status of the virtual device using grpcurl
grpcurl -plaintext -d '{}' localhost:8556 \
  android.emulation.control.EmulatorController/getStatus

# Simulate an incoming phone call
grpcurl -plaintext -d '{"operation": "InitCall", "number": "1234567890"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendPhone

# Simulate typing text into the guest OS
grpcurl -plaintext -d '{"text": "Hello"}' localhost:8556 \
  android.emulation.control.EmulatorController/sendKey

Telnet 控制台到 gRPC 服務的對應

下表列出舊版 Telnet 控制台指令對應的 gRPC 服務和方法，說明如何以程式輔助方式自動執行常見的虛擬裝置互動：

gRPC 專屬的程式輔助指令

gRPC 介面提供多項尖端功能，這些功能在舊版 Telnet 控制台連線中無法執行。包括直接串流 logcat、雙向音訊擷取或插入、主機 GUI 修改，以及直接存取殼層。

指紋模擬和驗證

使用 finger 指令模擬及進行應用程式指紋驗證程序。您必須使用 24.3 以上版本的 SDK 工具和 Android 6.0 (API 級別 23) 以上版本。

如要模擬及進行指紋驗證程序，請按照下列步驟操作：

1. 如果您還沒有指紋 ID，請在模擬器中註冊新指紋，方法是依序選取「Settings」>「Security」 >「Fingerprint」，然後按照註冊指示操作。

2. 將應用程式設為接受指紋驗證。完成這項設定後，裝置會顯示指紋驗證畫面。

3. 應用程式顯示指紋驗證畫面時，前往主控台並輸入 finger touch 指令和您建立的指紋 ID。系統會模擬手指觸碰的情形。

4. 接著輸入 finger remove 指令，模擬手指移開的情形。應用程式應該會有所回應，就好像使用者觸碰指紋感應器並移開手指一樣。