Gửi lệnh từ bảng điều khiển trình mô phỏng

Mỗi thiết bị ảo đang chạy có một bảng điều khiển cho phép bạn truy vấn và kiểm soát môi trường thiết bị được mô phỏng. Ví dụ: bạn có thể dùng bảng điều khiển để quản lý lệnh chuyển hướng cổng, các đặc điểm mạng và các sự kiện của điện thoại trong khi ứng dụng đang chạy trên trình mô phỏng.

Các lệnh sau đây yêu cầu bạn phải đã chạy trình mô phỏng. Để biết thêm thông tin về cách chạy trình mô phỏng, hãy xem phần Chạy ứng dụng trên Trình mô phỏng Android và Bắt đầu trình mô phỏng từ dòng lệnh.

Bắt đầu và dừng phiên điều khiển

Để truy cập vào bảng điều khiển và nhập các lệnh, từ cửa sổ dòng lệnh, hãy sử dụng telnet để kết nối với cổng bảng điều khiển và cung cấp mã thông báo xác thực của bạn. Mỗi khi bảng điều khiển hiển thị OK, nghĩa là bảng điều khiển đã sẵn sàng chấp nhận các lệnh. Thông thường, sẽ không có lời nhắc.

Cách kết nối với bảng điều khiển của một thiết bị ảo đang chạy:

  1. Mở cửa sổ dòng lệnh và nhập lệnh sau:

    telnet localhost console-port
    

    Tiêu đề cửa sổ trình mô phỏng liệt kê số cổng của bảng điều khiển khi chạy trong một cửa sổ riêng, nhưng không liệt kê thông tin này khi chạy trong cửa sổ công cụ. Ví dụ: tiêu đề cửa sổ của một trình mô phỏng sử dụng cổng bảng điều khiển 5554 có thể là Pixel8_API_34:5554. Ngoài ra, lệnh adb devices in ra danh sách các thiết bị ảo đang chạy và số cổng của bảng điều khiển tương ứng. Để biết thêm thông tin, hãy xem phần Truy vấn thiết bị.

    Lưu ý: Trình mô phỏng sẽ theo dõi các kết nối trên các cổng từ 5554 đến 5585 và chỉ chấp nhận kết nối từ máy chủ cục bộ.

  2. Sau khi bảng điều khiển hiển thị OK, hãy nhập lệnh auth auth_token.

    Bảng điều khiển của trình mô phỏng yêu cầu xác thực trước khi bạn nhập các lệnh trong bảng điều khiển. auth_token phải phù hợp với nội dung của tệp .emulator_console_auth_token trong thư mục gốc.

    Nếu tệp đó không tồn tại, lệnh telnet localhost console-port sẽ tạo tệp chứa mã thông báo xác thực được tạo ngẫu nhiên. Để tắt tính năng xác thực, hãy xoá mã thông báo khỏi tệp .emulator_console_auth_token hoặc tạo một tệp trống nếu không có tệp đó.

  3. Sau khi bạn đã kết nối với bảng điều khiển, hãy nhập các lệnh trong bảng điều khiển.

    Nhập help, help command hoặc help-verbose để xem danh sách các lệnh trong bảng điều khiển và tìm hiểu về các lệnh cụ thể.

  4. Để thoát khỏi phiên điều khiển, hãy nhập quit hoặc exit.

Dưới đây là một phiên mẫu:

$ 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.

Lệnh không cần theo dõi

Nếu bạn không cần mở phiên, hãy sử dụng lối tắt adb emu để thực thi lệnh và ngay lập tức trả lại quyền kiểm soát cho shell gọi:

adb emu command commandParameter

Lệnh gọi bằng adb emu kết nối với trình mô phỏng có sẵn. Nếu có nhiều trình mô phỏng chạy cùng lúc, bạn phải truyền số sê-ri của trình mô phỏng cụ thể mà bạn đang nhắm đến:

adb -s emulator-serial emu command commandParameter

Thông tin tham khảo về lệnh trong trình mô phỏng

Danh sách sau đây mô tả các lệnh trong bảng điều khiển của trình mô phỏng cùng với thông số và giá trị của các lệnh đó:

Lệnh chung

  • avd {stop| start| status| name} Các truy vấn, chế độ điều khiển và quản lý thiết bị ảo như sau:

    • stop: Dừng quá trình thực thi của thiết bị.
    • start: Bắt đầu quá trình thực thi của thiết bị.
    • status: Truy vấn trạng thái của thiết bị ảo, có thể là đang chạy hoặc đã dừng.
    • name: Truy vấn tên của thiết bị ảo.
  • avd snapshot {list| save name| load name| delete name} Lưu và khôi phục trạng thái của thiết bị trong bản tổng quan nhanh như sau:

    • list: Liệt kê tất cả các bản tổng quan nhanh đã lưu.
    • save name: Lưu ảnh chụp nhanh dưới dạng tên.
    • load name: Tải bản tổng quan nhanh đã đặt tên.
    • delete name: Xoá ảnh chụp nhanh đã đặt tên.

    Ví dụ sau đây lưu một bản tổng quan nhanh có tên firstactivitysnapshot:

    avd snapshot save firstactivitysnapshot
    
  • fold: Gập thiết bị lại để hiển thị cấu hình màn hình nhỏ hơn (nếu thiết bị có thể gập lại và đang mở).

  • unfold: Mở thiết bị ra để hiển thị cấu hình màn hình lớn hơn (nếu thiết bị có thể gập lại và đang gập).

  • kill: Chấm dứt thiết bị ảo.

  • ping: Kiểm tra xem thiết bị ảo có đang chạy hay không.

  • rotate: Xoay AVD ngược chiều kim đồng hồ, mỗi lần xoay thêm 45 độ.

Huỷ trình mô phỏng

  • crash: Huỷ trình mô phỏng trong quá trình thực thi ứng dụng.

  • crash-on-exit: Huỷ trình mô phỏng khi ứng dụng thoát ra.

Thẻ gỡ lỗi

  • debug tags ...: Bật hoặc tắt thông báo gỡ lỗi từ các phần cụ thể của trình mô phỏng. Tham số tags phải là một giá trị trong danh sách các thẻ gỡ lỗi xuất hiện khi bạn thực thi emulator -help-debug-tags. Để biết thêm thông tin về tuỳ chọn -help-debug-tags, hãy xem bảng các tuỳ chọn thường dùng. Ví dụ sau đây sẽ bật thẻ radio:

    debug radio
    

Chuyển hướng cổng

  • redir list: Liệt kê lệnh chuyển hướng cổng hiện tại.

  • redir add protocol:host-port:guest-port Thêm lệnh chuyển hướng cổng mới như sau:

    • protocol: Phải là tcp hoặc udp.
    • host-port: Số cổng cần mở trên máy chủ.
    • guest-port: Số cổng để định tuyến dữ liệu đến trên trình mô phỏng.
  • redir del protocol:host-port Xoá lệnh chuyển hướng cổng.

    • protocol: Phải là tcp hoặc udp.
    • host-port: Số cổng cần mở trên máy chủ.

Vị trí địa lý

Đặt vị trí địa lý được báo cáo cho các ứng dụng chạy bên trong trình mô phỏng bằng cách gửi bản sửa lỗi GPS cho trình mô phỏng.

Bạn có thể đưa ra một trong các lệnh geo sau đây ngay khi thiết bị ảo đang chạy. Trình mô phỏng sẽ đặt vị trí bạn nhập bằng cách tạo một nhà cung cấp vị trí mô phỏng. Nhà cung cấp này phản hồi trình nghe vị trí do các ứng dụng cài đặt và cung cấp vị trí cho LocationManager. Mọi ứng dụng đều có thể truy vấn trình quản lý vị trí để lấy bản sửa lỗi GPS hiện tại cho thiết bị được mô phỏng bằng cách gọi LocationManager.getLastKnownLocation("gps").

  • geo fix longitude latitude [altitude] [satellites] [velocity]: Gửi bản sửa lỗi GPS cho trình mô phỏng. Chỉ định kinh độ và vĩ độ theo độ thập phân. Sử dụng một số từ 1 đến 12 để chỉ định số vệ tinh dùng để xác định vị trí, đồng thời chỉ định độ cao tính bằng mét và vận tốc theo hải lý.

  • geo nmea sentence: Gửi một câu NMEA 0183 tới thiết bị được mô phỏng như thể câu này xuất phát từ một modem GPS được mô phỏng. Bắt đầu câu bằng "$GP". Hiện tại, chỉ có các câu "$GPGGA" và "$GPRCM" mới được hỗ trợ. Sau đây là ví dụ về một câu GPGGA (Dữ liệu khắc phục sự cố hệ thống định vị toàn cầu) có chức năng thu thập thời gian, vị trí và dữ liệu khắc phục sự cố cho bộ thu 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
    

Sự kiện phần cứng giả

Hệ thống con sự kiện phần cứng của bảng điều khiển trình mô phỏng cho phép bạn mô phỏng hầu như mọi hoạt động tương tác vật lý với thiết bị. Các phương thức này bao gồm nút vật lý, thao tác chạm/cử chỉ trên màn hình, nút xoay, cần điều khiển và nút chuyển phần cứng.

  • event types: Liệt kê tất cả các loại sự kiện giả. Đối với các sự kiện có mã, số lượng mã sẽ xuất hiện trong dấu ngoặc đơn ở bên phải. Kết quả điểm dữ liệu:

    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 ...]: Gửi một hoặc nhiều loại sự kiện giả.

  • event codes type: Liệt kê các mã sự kiện cho loại sự kiện giả đã chỉ định.

  • event send type[:code]:[value] [...]: Gửi một hoặc nhiều sự kiện giả kèm theo mã và giá trị mã không bắt buộc.

EV_KEY — Tài liệu tham khảo về mã khoá

Loại sự kiện EV_KEY được dùng để mô phỏng thao tác nhấn và nhả nút. Các bảng sau đây chia danh sách lớn các mã phím được hỗ trợ thành các danh mục logic. Đối với mỗi mã phím, việc gửi giá trị 1 sẽ mô phỏng thao tác nhấn, trong khi giá trị 0 sẽ mô phỏng thao tác nhả. Giá trị 2 đại diện cho thao tác lặp lại phím.

Bảng phụ A: Khoá hệ thống Android
Mã Mô tả
KEY_HOME Thao tác kích hoạt bằng nút màn hình chính
KEY_BACK Điều kiện kích hoạt nút quay lại
KEY_MENU Nút trình đơn (mục bổ sung)
KEY_POWER Nút nguồn (nhấn/nhấn và giữ)
KEY_VOLUMEUP Nút tăng âm lượng
KEY_VOLUMEDOWN Nút kích hoạt Giảm âm lượng
KEY_CAMERA Nút chụp ảnh vật lý
KEY_FOCUS Nút chụp tự động lấy nét của máy ảnh
KEY_SEARCH Trình kích hoạt nút tìm kiếm
KEY_SLEEP Điều kiện kích hoạt lệnh ngủ
KEY_WAKEUP Trình kích hoạt lệnh đánh thức
KEY_NOTIFICATION Mở ngăn thông báo
KEY_MUTE Tắt đầu ra âm thanh của hệ thống
KEY_MICMUTE Tắt tiếng micrô
KEY_BRIGHTNESSDOWN Giảm độ sáng màn hình
KEY_BRIGHTNESSUP Tăng độ sáng màn hình
KEY_PHONE Mở ứng dụng gọi điện mặc định
KEY_SEND Gửi hoặc bắt đầu cuộc gọi điện thoại
KEY_HEADSETHOOK Nút tai nghe (trả lời/gác máy)
KEY_SCREEN Lệnh kích hoạt trình bảo vệ màn hình
KEY_CONFIG Trình đơn hệ thống cấu hình
KEY_SWITCHVIDEOMODE Chuyển chế độ video của hệ thống
KEY_KBDILLUMTOGGLE Bật/tắt đèn nền bàn phím
Bảng phụ B: Nội dung nghe nhìn và bộ điều khiển chế độ phát
Mã Mô tả
KEY_PLAYPAUSE Bật/tắt trạng thái phát và tạm dừng
KEY_PLAY Bắt đầu phát nội dung nghe nhìn
KEY_PAUSECD Tạm dừng phát đĩa CD
KEY_STOPCD Dừng phát đĩa CD
KEY_NEXTSONG Chuyển đến bản nhạc tiếp theo
KEY_PREVIOUSSONG Chuyển về bản nhạc trước
KEY_REWIND Tua lại bản nhạc đang phát
KEY_FASTFORWARD Tua nhanh bản nhạc đang phát
KEY_RECORD Lệnh ghi điều kiện kích hoạt
KEY_SHUFFLE Bật/tắt chế độ phát ngẫu nhiên
KEY_REPEAT Bật/tắt chế độ phát lặp lại
KEY_MEDIA Điều kiện kích hoạt phím nội dung nghe nhìn
Bảng phụ C: Bàn phím điều hướng và bàn phím chung
Mã Mô tả
KEY_UP Hướng lên trên D-pad
KEY_DOWN Hướng xuống trên D-pad
KEY_LEFT Hướng sang trái trên D-pad
KEY_RIGHT Hướng sang phải trên D-pad
KEY_PAGEUP Thao tác di chuyển lên trang
KEY_PAGEDOWN Thao tác di chuyển xuống trang
KEY_INSERT Chèn điều kiện kích hoạt chính
KEY_DELETE Xoá điều kiện kích hoạt chính
KEY_ENTER Trình kích hoạt phím Enter
KEY_ESC Trình kích hoạt phím Escape
KEY_TAB Trình kích hoạt phím Tab
KEY_SPACE Trình kích hoạt phím cách
KEY_BACKSPACE Điều kiện kích hoạt phím Backspace
KEY_CLEAR Xoá vùng đệm đầu vào
KEY_CANCEL Huỷ thao tác đang thực hiện
KEY_OK Xác nhận/OK lựa chọn
KEY_SELECT Chọn điều kiện kích hoạt mục
KEY_GOTO Đi đến địa điểm được chỉ định
KEY_HELP Truy cập vào bối cảnh trợ giúp
Bảng phụ D: Ký tự chữ và số và ký hiệu trên bàn phím
  • Chữ cái tiêu chuẩn: KEY_A đến KEY_Z (26 mã).
  • Phím trên bàn phím số: KEY_1 đến KEY_0 (10 mã).
Mã Ký hiệu ký tự
KEY_COMMA ,
KEY_DOT .
KEY_SLASH /
KEY_SEMICOLON ;
KEY_APOSTROPHE '
KEY_GRAVE \`
KEY_MINUS -
KEY_EQUAL =
KEY_LEFTBRACE [
KEY_RIGHTBRACE ]
KEY_BACKSLASH \
KEY_KPASTERISK * (Bàn phím số)
KEY_KPPLUS + (Bàn phím số)
KEY_KPMINUS - (Bàn phím số)
KEY_KPDOT . (Bàn phím số)
KEY_KPSLASH / (Bàn phím số)
KEY_KPENTER Enter (Bàn phím số)
KEY_KPEQUAL = (Bàn phím số)
KEY_KPCOMMA , (Bàn phím số)
KEY_KPJPCOMMA , (bố cục tiếng Nhật)
KEY_KPLEFTPAREN ( (Bàn phím số)
KEY_KPRIGHTPAREN ) (Bàn phím số)
KEY_KPPLUSMINUS ± (Bàn phím số)
Bảng phụ E: Phím bổ trợ và phím chức năng
  • Phím chức năng tiêu chuẩn: KEY_F1 đến KEY_F24 (24 mã).
Mã Mô tả
KEY_LEFTSHIFT Phím bổ trợ Shift bên trái
KEY_RIGHTSHIFT Phím bổ trợ Shift bên phải trên bàn phím
KEY_LEFTCTRL Phím bổ trợ Control bên trái trên bàn phím
KEY_RIGHTCTRL Phím bổ trợ Control bên phải trên bàn phím
KEY_LEFTALT Phím bổ trợ Alt bên trái
KEY_RIGHTALT Phím bổ trợ Alt bên phải trên bàn phím
KEY_LEFTMETA Phím Meta/Command bên trái
KEY_RIGHTMETA Phím Meta/Command bên phải
KEY_CAPSLOCK Bật/tắt Caps Lock trên bàn phím
KEY_NUMLOCK Bật/tắt phím Num Lock
KEY_SCROLLLOCK Bật/tắt phím Scroll Lock
KEY_COMPOSE Trợ lý soạn thảo nhân vật
KEY_FN Phím FN trên bàn phím vật lý
KEY_FN_ESC Tổ hợp phím chức năng
KEY_FN_1 Phím tắt chức năng đặc biệt 1
KEY_FN_2 Phím tắt chức năng đặc biệt 2
KEY_FN_D Phím tắt chức năng đặc biệt D
KEY_FN_E Phím tắt chức năng đặc biệt E
KEY_FN_F Phím tắt chức năng đặc biệt F
KEY_FN_S Phím tắt chức năng đặc biệt S
KEY_FN_B Phím tắt chức năng đặc biệt B
Bảng phụ F: Tay điều khiển trò chơi và cần điều khiển
Mã Mô tả
BTN_A / BTN_B / BTN_C Các nút A/B/C trên bộ điều khiển
BTN_X / BTN_Y / BTN_Z Các nút X/Y/Z trên mặt bộ điều khiển
BTN_START Nút trình đơn Bắt đầu trên tay điều khiển trò chơi
BTN_SELECT Nút Chọn trên tay điều khiển trò chơi
BTN_MODE Nút chuyển Chế độ tay điều khiển
BTN_TL/BTN_TR Nút hông trái/phải
BTN_TL2/BTN_TR2 Cò analog trái/phải
BTN_THUMBL/BTN_THUMBR Nhấn cần điều khiển trái/phải
BTN_DPAD_UP Nút kích hoạt D-pad lên trên tay điều khiển trò chơi
BTN_DPAD_DOWN Nút kích hoạt xuống trên D-pad của tay điều khiển trò chơi
BTN_DPAD_LEFT Nút kích hoạt bên trái của D-pad trên tay điều khiển trò chơi
BTN_DPAD_RIGHT Nút kích hoạt bên phải trên D-pad của tay điều khiển trò chơi
BTN_THUMB Nút kích hoạt chính bằng ngón tay cái trên cần điều khiển
BTN_TOP/BTN_TOP2 Các nút trên cùng của cần điều khiển
BTN_PINKIE Nút kích hoạt ngón út trên cần điều khiển
BTN_BASE đến _BASE6 Các nút trên đế của cần điều khiển
BTN_DEAD Cờ vùng chết của tay điều khiển trò chơi không hoạt động
BTN_TRIGGER Nút kích hoạt bằng tay của cần điều khiển vật lý
BTN_JOYSTICK Mã đầu vào cần điều khiển chung
Bảng phụ G: Thao tác nhập bằng chuột, thao tác chạm và bút cảm ứng
Mã Mô tả
BTN_MOUSE Sự kiện con trỏ chuột chung
BTN_LEFT Nhấp chuột trái
BTN_RIGHT Nhấp chuột phải
BTN_MIDDLE Nhấp vào con lăn chuột giữa
BTN_SIDE Kích hoạt phím bên để điều hướng
BTN_EXTRA Trình kích hoạt nút chuột bổ sung
BTN_FORWARD Nhấp vào nút tiến trên thanh điều hướng của trình duyệt
BTN_BACK Nhấp vào nút quay lại trên trình duyệt
BTN_TASK Phím chuyển đổi tác vụ hệ thống
BTN_TOUCH Đã phát hiện thấy có tiếp xúc vật lý với màn hình
BTN_STYLUS Khoảng cách tương cận của bút cảm ứng đang hoạt động
BTN_STYLUS2 Nút phụ trên thân bút cảm ứng
BTN_TOOL_PEN Giá trị nhận dạng công cụ bút cảm ứng
BTN_TOOL_RUBBER Giá trị nhận dạng công cụ tẩy của bút cảm ứng
BTN_TOOL_BRUSH Giá trị nhận dạng công cụ bút vẽ của Painter
BTN_TOOL_PENCIL Giá trị nhận dạng công cụ bút chì phác thảo
BTN_TOOL_AIRBRUSH Giá trị nhận dạng công cụ sơn phun
BTN_TOOL_FINGER Tiếp xúc ngón tay với màn hình cảm ứng
BTN_TOOL_MOUSE Giá trị nhận dạng công cụ chuột bên ngoài
BTN_TOOL_LENS Công cụ kính lúp quang học
BTN_TOOL_DOUBLETAP Cờ tốc độ nhấn đúp bằng cử chỉ
BTN_TOOL_TRIPLETAP Cờ tốc độ nhấn 3 lần bằng cử chỉ
Bảng phụ H: Lối tắt ứng dụng
Mã Hành động mục tiêu
KEY_WWW Mở trình duyệt web mặc định
KEY_MAIL Mở ứng dụng email mặc định
KEY_BOOKMARKS Mở danh sách dấu trang của trình duyệt
KEY_CALC Mở tiện ích máy tính
KEY_FILE Mở trình khám phá tệp trên thiết bị
KEY_EDIT Điều kiện kích hoạt chỉnh sửa tài liệu
KEY_NEW Tạo điều kiện kích hoạt mới cho tài liệu
KEY_OPEN Trình kích hoạt mở tài liệu
KEY_SAVE Trình kích hoạt tác vụ lưu tệp
KEY_CLOSE Trình kích hoạt tác vụ đóng tệp
KEY_PRINT Trình kích hoạt tác vụ in tệp
KEY_COPY Thao tác sao chép bộ đệm bảng nhớ tạm
KEY_PASTE Thao tác chèn vùng đệm bảng nhớ tạm
KEY_CUT Thao tác cắt vào bộ đệm của bảng nhớ tạm
KEY_UNDO Thao tác huỷ bộ đệm bảng nhớ tạm
KEY_REDO Thao tác làm lại vùng đệm của bảng nhớ tạm
KEY_CANCEL Điều kiện kích hoạt quy trình huỷ vùng đệm
KEY_FIND Tiện ích tìm kiếm tài liệu
KEY_REFRESH Tiện ích làm mới tài liệu
KEY_EXIT Tiện ích đóng tài liệu
KEY_DOCUMENTS Mở cổng tài liệu hệ thống
KEY_HOMEPAGE Mở trang chủ của trình duyệt
KEY_FAVORITES Mở cổng thông tin mục yêu thích trên trình duyệt
KEY_CHAT Chạy trình nhắn tin nhanh
KEY_EMAIL Điều kiện kích hoạt khởi chạy email thay thế
KEY_FINANCE Mở tiện ích cổ phiếu/tài chính
KEY_SPORT Mở tiện ích theo dõi thể thao
KEY_SHOP Mở cổng mua sắm kỹ thuật số
KEY_PLAYER Mở trình phát nội dung nghe nhìn chính
KEY_MP3 Mở máy nghe nhạc MP3 chính
KEY_TEXT Mở trình chỉnh sửa văn bản mặc định
KEY_LIST Mở tiện ích danh sách kiểm tra
KEY_MEMO Mở tiện ích ghi chú/ghi nhớ
KEY_CALENDAR Mở cổng lịch/chương trình làm việc
KEY_DIRECTORY Mở danh bạ địa chỉ hệ thống
KEY_COMPUTER Mở trình khám phá thông số kỹ thuật
KEY_TV/KEY_TV2 Mở cổng thông tin truyền hình
KEY_RADIO Chạy tiện ích đài phát thanh
KEY_CD/KEY_DVD Kích hoạt trình đọc ổ đĩa quang
KEY_AUDIO/KEY_VIDEO Thông số kỹ thuật của nội dung nghe nhìn
KEY_TUNER Định cấu hình bộ thu/bộ dò sóng
KEY_SAT/KEY_SAT2 Định cấu hình nguồn cấp dữ liệu vệ tinh
KEY_TAPE Phát băng từ
KEY_VCR Phát nguồn cấp dữ liệu của trình phát VCR
KEY_VCR2 Phát nguồn cấp dữ liệu của trình phát VCR 2
KEY_AUX Đầu vào cổng nội dung nghe nhìn phụ trợ
KEY_SETUP Trình đơn thiết lập cấu hình
KEY_PROG1 đến _PROG4 Khoá chương trình do người dùng xác định
KEY_ZOOM Bật/tắt chế độ thu phóng khung nhìn
KEY_MODE Chọn chế độ khung nhìn
KEY_KEYBOARD Hiện/ẩn bàn phím ảo
KEY_LANGUAGE Chuyển đổi ngôn ngữ của bản âm thanh
KEY_TITLE Mở các lựa chọn về tiêu đề nội dung nghe nhìn
KEY_SUBTITLE Bật/tắt giao diện phụ đề
KEY_ANGLE Thay đổi góc camera của video
KEY_EPG Mở hướng dẫn chương trình điện tử
KEY_PVR Mở trình ghi video cá nhân
KEY_MHP Nền tảng đa phương tiện mở cho gia đình
KEY_CHANNEL Mở các kênh của bộ dò TV
KEY_CHANNELUP Chuyển kênh truyền hình lên
KEY_CHANNELDOWN Chuyển kênh truyền hình xuống
KEY_RED Nút tương tác màu đỏ
KEY_GREEN Nút tương tác màu xanh lục
KEY_YELLOW Nút tương tác màu vàng
KEY_BLUE Nút tương tác màu xanh dương
KEY_FIRST Chọn lựa chọn đầu tiên cho mục
KEY_LAST Chọn mục cuối cùng
KEY_NEXT Chọn lựa chọn bản nhạc tiếp theo
KEY_PREVIOUS Chọn lựa chọn bản nhạc trước
KEY_RESTART Khởi động lại vòng lặp bản nhạc đa phương tiện
KEY_SLOW Lựa chọn phát chậm
KEY_AB Vòng lặp trình tự lặp lại A-B
KEY_PLAYCD Lệnh phát của đầu đĩa CD
KEY_PAUSECD Lệnh tạm dừng đầu đĩa CD
KEY_STOPCD Lệnh dừng đầu đĩa CD
KEY_DIGITS Lệnh nhập bằng bàn phím số
KEY_TEEN Lựa chọn giá trị thanh thiếu niên trên bàn phím
KEY_TWEN Lựa chọn giá trị twen của bàn phím
KEY_DEL_EOL Xoá đến cuối vùng đệm dòng
KEY_DEL_EOS Xoá đến cuối vùng đệm màn hình
KEY_INS_LINE Chèn vùng đệm dòng mới
KEY_BRL_DOT1 đến _DOT8 Nhập bằng nút trên màn hình chữ nổi
KEY_VOICECOMMAND Chạy ứng dụng trợ lý thoại
KEY_SELECTIVE_SCREEN Kích hoạt tính năng chụp ảnh màn hình theo khu vực
KEY_BATTERY Truy vấn thông báo về pin
KEY_STAR/KEY_SHARP Ký hiệu bàn phím điện thoại
KEY_PLUS Biểu tượng dấu cộng trên bàn phím điện thoại
KEY_INFO Hiện lớp phủ bảng thông tin
KEY_TIME Hiện giờ hiện tại trên đồng hồ
KEY_VENDOR Truy vấn thông số kỹ thuật của nhà cung cấp
KEY_ARCHIVE Mở tiện ích lưu trữ cục bộ
KEY_PROGRAM Định cấu hình các tham số của chương trình
KEY_POWER2 Kích hoạt nguồn điện dự phòng thay thế

EV_ABS — Sự kiện chuyển động tuyệt đối

Loại sự kiện EV_ABS rất quan trọng để mô phỏng chính xác các thao tác chạm, cử chỉ kéo và thả, thao tác chụm nhiều điểm chạm và điều chỉnh cần điều khiển. Toạ độ tuyệt đối bên dưới liên kết trực tiếp đến độ phân giải màn hình thực tế cơ bản.

Mã Phạm vi toạ độ Mô tả
ABS_MT_TRACKING_ID -1 hoặc ≥0 Mã theo dõi; -1 kết thúc thao tác chạm
ABS_MT_POSITION_X 0 đến 1767 Toạ độ X (Pixel Fold)
ABS_MT_POSITION_Y 0 đến 2207 Toạ độ Y (Pixel Fold)
ABS_MT_TOUCH_MAJOR pixel Chiều rộng trục chính của vùng chạm
ABS_MT_TOUCH_MINOR pixel Chiều rộng trục nhỏ của vùng chạm
ABS_MT_WIDTH_MAJOR pixel Chiều rộng trục chính của công cụ
ABS_MT_WIDTH_MINOR pixel Chiều rộng trục phụ của công cụ
ABS_MT_ORIENTATION 0 đến 255 Góc hướng tiếp xúc
ABS_MT_PRESSURE 0 đến 255 Độ lớn của lực tiếp xúc
ABS_MT_DISTANCE mm Khoảng cách di chuột từ màn hình
ABS_MT_TOOL_TYPE 0 đến 2 0=ngón tay, 1=bút, 2=bút chì
ABS_MT_BLOB_ID số nguyên Giá trị nhận dạng blob của người liên hệ
ABS_MT_TOOL_X pixel Toạ độ vị trí X của công cụ
ABS_MT_TOOL_Y pixel Toạ độ vị trí Y của công cụ
ABS_MT_SLOT 0 đến N Vị trí đang hoạt động (Giao thức B)
ABS_X / _Y / _Z tương tự Trục toạ độ của cần điều khiển
ABS_RX / _RY / _RZ tương tự Trục xoay của cần điều khiển
ABS_THROTTLE/_BRAKE tương tự Bàn đạp và bộ điều khiển lái
ABS_HAT0X/_HAT0Y -1 / 0 / 1 Nút điều hướng và nút chuyển góc nhìn
ABS_PRESSURE 0 đến 255 Mức lực của bút cảm ứng/con trỏ
ABS_DISTANCE mm Khoảng cách di chuột (bút cảm ứng)
ABS_TILT_X/_TILT_Y độ Góc nghiêng của bút cảm ứng
ABS_VOLUME tương tự Mức âm lượng của tay điều khiển

Hoạt động tương tác bằng cách chạm trên Android được điều khiển bằng Giao thức cảm ứng đa điểm (MT). Trình mô phỏng hiện đại triển khai cả Giao thức A (không có trạng thái, gửi các gói tiếp xúc được phân tách bằng dấu đồng bộ hoá) và Giao thức B (có trạng thái, chỉ định các điểm tiếp xúc cho các vùng theo dõi chuyên dụng). Giao thức B cho phép theo dõi hiệu quả nhiều thao tác chạm đồng thời cho các cử chỉ như chụm để thu phóng.

EV_REL và EV_SW — Công tắc chuyển động và phần cứng

Danh mục sự kiện EV_REL quản lý các thay đổi về toạ độ hoặc con trỏ tương đối, chủ yếu được dùng để mô phỏng chuyển động của chuột ngoài hoặc con lăn chuột. Danh mục sự kiện EV_SW quản lý các nút chuyển thiết bị thực, chẳng hạn như liệu điện thoại lật hoặc máy tính bảng có được gập lại hay không, hoặc liệu phần cứng âm thanh bên ngoài có được lắp vào hay không.

Mã Giá trị Mô tả
REL_X Delta Di chuyển con trỏ theo chiều ngang
REL_Y Delta Di chuyển con trỏ theo chiều dọc
SW_LID 0/1 Trạng thái nắp máy tính xách tay (0=Mở, 1=Đóng)
SW_TABLET_MODE 0/1 Trạng thái chế độ máy tính bảng (0=Tắt, 1=Đang hoạt động)
SW_HEADPHONE_INSERT 0/1 Trạng thái giắc tai nghe (0=Đã rút, 1=Đã cắm)
SW_MICROPHONE_INSERT 0/1 Trạng thái giắc cắm micrô (0=Rút ra, 1=Cắm vào)
Cú pháp điều phối lệnh

Để gửi các mã này, hãy định dạng lệnh trong bảng điều khiển bằng các loại, mã và giá trị được phân tách bằng dấu hai chấm. Bạn có thể đưa nhiều thay đổi về toạ độ vào hàng đợi trong một chuỗi duy nhất. Điều quan trọng là luôn thêm dấu đồng bộ hoá cuối cùng (EV_SYN:0:0) để cho biết rằng khung trình mô phỏng phải gói và xử lý các dữ liệu đầu vào này cùng nhau.

Ví dụ về tập lệnh sự kiện và cử chỉ

Vì Telnet cho phép gửi các tham số gồm nhiều phần, nên bạn có thể mô phỏng các trình tự cử chỉ thực tế. Dưới đây là cấu trúc tập lệnh sự kiện thô để tự động hoá cử chỉ từ bảng điều khiển của máy chủ.

Mô phỏng thao tác nhấn vào màn hình

Để thực hiện thao tác nhấn rõ ràng trên màn hình tại toạ độ mục tiêu, hãy chỉ định mã theo dõi, chỉ định toạ độ X và Y trên màn hình, mô phỏng thao tác chạm, đồng bộ hoá rồi thả ra.

# 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
Mô phỏng thao tác cuộn dọc (vuốt)

Để thực hiện cử chỉ vuốt cuộn, hãy giữ điểm tiếp xúc tại toạ độ bắt đầu, gửi khung toạ độ chuyển động trung gian và thả ra ở cuối.

# 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
Mô phỏng cử chỉ chụm hai ngón tay để thu phóng

Để kích hoạt tính năng thu phóng bằng hai ngón tay, hãy sử dụng các khe MT đang hoạt động (0 và 1) để theo dõi và điều phối hai toạ độ chạm đồng thời di chuyển ra xa nhau.

# 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
Mô phỏng công tắc kết nối tai nghe

Mô phỏng việc cắm hoặc rút giắc tai nghe để kiểm tra các nút chuyển định tuyến âm thanh. Giá trị 1 biểu thị việc cắm giắc cắm và 0 là việc tháo tai nghe.

# 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
Tìm mã sự kiện trên bảng điều khiển từ một thiết bị thực

Để khám phá trình tự cú pháp sự kiện chính xác cho bất kỳ thao tác tuỳ chỉnh hoặc cử chỉ nút nào, hãy kết nối bằng adb shell và chạy tiện ích chẩn đoán getevent. Khi bạn tương tác với GUI của trình mô phỏng, bảng điều khiển sẽ in chính xác mã, loại và vị trí sự kiện.

# 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: Gửi một chuỗi ký tự mô phỏng thao tác nhấn phím. Thông điệp phải là một chuỗi UTF-8. Các bài đăng sử dụng mã Unicode sẽ được ánh xạ ngược theo bàn phím hiện tại của thiết bị, còn các ký tự không được hỗ trợ sẽ tự động bị huỷ.

Điều khiển trạng thái nguồn

  • power display: Cho biết trạng thái bộ sạc và pin.

  • power ac {on| off}: Đặt trạng thái sạc AC thành bật hoặc tắt.

  • power status {unknown| charging| discharging| not-charging| full}: Thay đổi trạng thái pin như chỉ định.

  • power present {true| false}: Đặt trạng thái có/không có pin.

  • power health {unknown| good| overheat| dead| overvoltage| failure}: Đặt tình trạng pin.

  • power capacity percent: Đặt trạng thái của dung lượng pin còn lại ở dạng tỷ lệ phần trăm từ 0 đến 100.

Trạng thái kết nối mạng (chỉ Ethernet và mạng di động)

  • network status: Kiểm tra trạng thái mạng cùng các đặc tính về độ trễ và tốc độ hiện tại.

  • network delay latency Thay đổi độ trễ mạng được mô phỏng.

    Trình mô phỏng cho phép bạn mô phỏng nhiều mức độ trễ mạng để có thể kiểm thử ứng dụng của mình trong môi trường có điều kiện chạy thực tế điển hình hơn. Bạn có thể đặt độ trễ hoặc phạm vi độ trễ khi khởi động trình mô phỏng. Bạn cũng có thể sử dụng bảng điều khiển để thay đổi độ trễ khi ứng dụng đang chạy trong trình mô phỏng.

    Sau đây là các định dạng độ trễ mạng (số có đơn vị là mili giây):

    Định dạng độ trễ mạng:

  • gprs: GPRS, sử dụng phạm vi độ trễ từ 150 đến 550.

  • edge: EDGE/EGPRS, sử dụng phạm vi độ trễ từ 80 đến 400.

  • umts: UMTS/3G, sử dụng phạm vi độ trễ từ 35 đến 200.

  • none: Không có độ trễ.

  • num: Mô phỏng độ trễ đã chỉ định bằng mili giây.

  • min:max: Mô phỏng phạm vi độ trễ đã chỉ định.

    Để đặt độ trễ khi khởi động trình mô phỏng, hãy sử dụng tuỳ chọn trình mô phỏng -netdelay với giá trị độ trễ được hỗ trợ. Ví dụ:

    emulator -netdelay gprs
    emulator -netdelay 40,100
    

    Để thay đổi độ trễ mạng trong khi trình mô phỏng đang chạy, hãy kết nối với bảng điều khiển và sử dụng lệnh network delay:

    network delay gprs
    network delay 40 100
    
  • network speed speed Trình mô phỏng cho phép bạn mô phỏng nhiều tốc độ truyền qua mạng. Bạn có thể đặt phạm vi hoặc tốc độ truyền khi khởi động trình mô phỏng. Ngoài ra, bạn cũng có thể dùng bảng điều khiển để thay đổi tốc độ khi ứng dụng đang chạy trong trình mô phỏng.

    Sau đây là các định dạng tốc độ mạng (số có đơn vị là kilobit/giây):

    Định dạng tốc độ mạng:

  • gsm: GSM/CSD, sử dụng tốc độ tải lên là 14,4 và tải xuống là 14,4.

  • hscsd: HSCSD, sử dụng tốc độ tải lên là 14,4 và tải xuống là 43,2.

  • gprs: GPRS, sử dụng tốc độ tải lên là 40 và tải xuống là 80.

  • edge: EDGE/EGPRS, sử dụng tốc độ tải lên là 118,4 và tải xuống là 236,8.

  • umts: UMTS/3G, sử dụng tốc độ tải lên là 128 và tải xuống là 1920.

  • hsdpa: HSDPA, sử dụng tốc độ tải lên là 348 và tải xuống là 14400.

  • lte: LTE, sử dụng tốc độ tải lên là 58.000 và tải xuống là 173.000.

  • evdo: EVDO, sử dụng tốc độ tải lên là 75.000 và tải xuống là 280.000.

  • full: Tốc độ không giới hạn, nhưng phụ thuộc vào tốc độ kết nối của máy tính bạn sử dụng.

  • num: Đặt tốc độ chính xác theo kilobit/giây dùng cho cả hoạt động tải lên và tải xuống.

  • up:down: Đặt các tốc độ chính xác tính theo kilobit/giây để dùng riêng biệt cho hoạt động tải lên và tải xuống.

    Để đặt tốc độ mạng khi khởi động trình mô phỏng, hãy dùng tuỳ chọn trình mô phỏng -netspeed. Ví dụ:

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

    Để thay đổi tốc độ mạng trong khi trình mô phỏng đang chạy, hãy kết nối với bảng điều khiển và dùng lệnh network speed:

    network speed 14.4 80
    
  • network capture {start| stop} file Gửi các gói cho tệp. Danh sách sau đây mô tả các thông số và giá trị thông số:

    Lưu ý: Kể từ Trình mô phỏng Android 36.5 trở lên, lưu lượng truy cập kết nối Wi-Fi được netsim xử lý theo mặc định. Lệnh bảng điều khiển ghi lại mạng chỉ ghi lại lưu lượng truy cập mạng di động/WAN cũ được định tuyến thông qua ngăn xếp slirp QEMU. Để thu thập các gói Wi-Fi, Bluetooth hoặc gói mạng nâng cao trong các phiên bản trình mô phỏng hiện đại, hãy xem phần Thu thập lưu lượng truy cập mạng trong hướng dẫn về Mạng trình mô phỏng nâng cao.

  • start file: Bắt đầu ghi lại các gói mạng. Để đảm bảo bảo mật, tệp phải là tên tệp thuần tuý (không có dấu phân tách đường dẫn như / và không có ..). Tệp thu thập gói sẽ được lưu trong thư mục nội dung của AVD trong thư mục console_out/ (ví dụ: ~/.android/avd/avd_name.avd/console_out/file).

  • stop file: Ngừng gửi các gói cho tệp đã chỉ định.

Mô phỏng điện thoại

Trình mô phỏng Android bao gồm các modem GSM và CDMA riêng được mô phỏng, cho phép bạn mô phỏng các chức năng điện thoại trong trình mô phỏng. Ví dụ: Với GSM, bạn có thể mô phỏng cuộc gọi điện thoại đến, cũng như thiết lập và ngắt kết nối dữ liệu. Với CDMA, bạn cung cấp nguồn đăng ký và danh sách chuyển vùng ưu tiên. Hệ thống Android xử lý các cuộc gọi được mô phỏng giống hệt như các cuộc gọi thực tế. Trình mô phỏng không hỗ trợ âm thanh cuộc gọi.

  • gsm {call| accept| cancel| busy} phonenumber Các thông số gsm như sau:

    • call: Mô phỏng cuộc gọi điện thoại đến từ phonenumber.
    • accept: Chấp nhận cuộc gọi đến từ số điện thoại và thay đổi trạng thái cuộc gọi thành đang hoạt động. Bạn chỉ có thể thay đổi trạng thái cuộc gọi thành đang hoạt động khi cuộc gọi đang ở trạng thái chờ hoặc bị giữ.
    • cancel: Chấm dứt cuộc gọi đến từ hoặc cuộc gọi đi đến phonenumber.
    • busy: Chấm dứt cuộc gọi đi đến số điện thoại và thay đổi trạng thái cuộc gọi thành bận. Bạn chỉ có thể thay đổi trạng thái cuộc gọi thành bận khi cuộc gọi đang ở trạng thái chờ.
  • gsm {data| voice} state Lệnh trạng thái dữ liệu thay đổi trạng thái kết nối dữ liệu GPRS, còn lệnh trạng thái giọng nói thay đổi trạng thái kết nối giọng nói GPRS như sau:

    • unregistered: Không có mạng.
    • home: Đang dùng mạng cục bộ, không chuyển vùng.
    • roaming: Đang dùng mạng chuyển vùng.
    • searching: Đang tìm kiếm mạng.
    • denied: Chỉ cuộc gọi khẩn cấp.
    • off: Tương tự như trạng thái chưa đăng ký.
    • on: Tương tự như home.
  • gsm hold: Thay đổi trạng thái cuộc gọi thành giữ máy. Bạn chỉ có thể thay đổi trạng thái cuộc gọi thành giữ máy khi cuộc gọi đang ở trạng thái hoạt động hoặc đang chờ.

  • gsm list: Liệt kê mọi cuộc gọi đến và cuộc gọi đi cùng với trạng thái của chúng.

  • gsm status: Báo cáo trạng thái dữ liệu và giọng nói GSM hiện tại. Giá trị là những giá trị được mô tả cho lệnh thoại và dữ liệu.

  • gsm signal {rssi| ber} Thay đổi cường độ tín hiệu đã báo cáo (rssi) và tỷ lệ lỗi bit (ber) trong 15 giây cập nhật tiếp theo. Danh sách sau đây mô tả các thông số và giá trị của các thông số đó:

    • rssi: phạm vi là từ 0 đến 31 và là 99 nếu không xác định.
    • ber: phạm vi là từ 0 đến 7 và là 99 nếu không xác định.
  • gsm signal-profile num: Đặt cấu hình cường độ tín hiệu. num là một số từ 0 đến 4.

  • cdma ssource source Đặt nguồn đăng ký CDMA hiện tại, trong đó nguồn là danh sách cho phép dựa trên mạng chứa những người đăng ký của nhà mạng CDMA và giá trị của họ, như sau:

    • nv: Đọc thông tin đăng ký từ RAM bất biến.
    • ruim: Đọc thông tin đăng ký từ Mô-đun nhận dạng người dùng có thể tháo rời (RUIM).
  • cdma prl_version version: Huỷ phiên bản danh sách chuyển vùng ưu tiên (PRL) hiện tại. Số phiên bản dành cho cơ sở dữ liệu PRL chứa thông tin dùng trong quy trình lựa chọn và thu nạp hệ thống.

Quản lý các cảm biến trên trình mô phỏng

Những lệnh này liên quan đến loại cảm biến có sẵn trong AVD. Bên cạnh việc sử dụng lệnh cảm biến, bạn có thể xem và điều chỉnh các chế độ cài đặt của trình mô phỏng ở màn hình Cảm biến ảo trong các thẻ Gia tốc kế và Cảm biến bổ sung.

  • sensor status: Liệt kê tất cả các cảm biến và trạng thái của chúng.

  • sensor get sensor-name: Xem chế độ cài đặt cho sensor-name. Ví dụ sau đây sẽ lấy giá trị cho cảm biến gia tốc:

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

    Các giá trị gia tốc được phân tách bằng dấu hai chấm (:) là các toạ độ x, y và z của các cảm biến ảo.

  • sensor set sensor-name value-x:value-y:value-z: Đặt giá trị cho sensor-name. Ví dụ sau đây đặt cảm biến gia tốc cho các giá trị x, y và z được phân tách bằng dấu hai chấm.

    sensor set acceleration 2.23517e-07:9.77631:0.812348
    

Mô phỏng tin nhắn SMS

  • sms send sender-phone-number textmessage Tạo một tin nhắn SMS đến được mô phỏng. Danh sách sau đây mô tả các tham số và giá trị của các tham số đó:

    • sender-phone-number: Chứa một chuỗi số tuỳ ý.
    • textmessage: Tin nhắn SMS.

    Ví dụ sau đây gửi tin nhắn "hi there" (chào bạn) đến số điện thoại 4085555555:

    sms send 4085555555 hi there
    

Bảng điều khiển sẽ chuyển tiếp tin nhắn SMS đến khung Android. Từ đây, khung Android sẽ chuyển tin nhắn đó đến một ứng dụng trên trình mô phỏng có thể xử lý tin nhắn SMS, chẳng hạn như ứng dụng Tin nhắn. Nếu bạn chuyển 10 số, ứng dụng sẽ định dạng đó là số điện thoại. Các chuỗi số dài hơn hoặc ngắn hơn sẽ hiển thị theo cách bạn gửi các chuỗi này.

Mô phỏng vân tay

  • finger touch fingerprint-id: Mô phỏng một ngón tay đang chạm vào cảm biến.

  • finger remove: Mô phỏng thao tác nhấc ngón tay.

Để biết hướng dẫn về cách sử dụng các lệnh này, hãy xem phần sau đây về mô phỏng và xác thực vân tay.

Ghi màn hình

Lệnh ghi màn hình cho phép quay các tệp video chất lượng cao về màn hình thực của trình mô phỏng ngay từ hệ thống lưu trữ. Điều này rất hữu ích cho quy trình tích hợp liên tục và báo cáo lỗi tự động.

  • screenrecord {start| stop} file Bắt đầu hoặc dừng quá trình ghi màn hình.
    • start file: Bắt đầu quay video. Tệp đầu ra phải kết thúc bằng đuôi .webm bắt buộc. Video đã quay được lưu trực tiếp trong thư mục đầu ra của bảng điều khiển AVD: ~/.android/avd/avd_name.avd/console_out/file.
    • stop file: Dừng quá trình ghi màn hình đang hoạt động.

Tự động hoá và macro

Hệ thống con tự động hoá cho phép nhà phát triển ghi lại các chuyển đổi trạng thái macro trên thiết bị ảo đang chạy và phát lại các chuyển đổi đó để thực thi quy trình kiểm thử tự động.

  • automation {record| stop-record| play| stop-play} Quản lý bản ghi macro tự động.
    • record: Bắt đầu ghi lại các thay đổi và dữ liệu đầu vào về trạng thái thiết bị.
    • stop-record: Dừng phiên ghi macro hiện tại.
    • play: Bắt đầu phát lại trình tự macro đã ghi.
    • stop-play: Dừng trình tự phát macro đang hoạt động.

Vật lý (6DoF)

Các lệnh vật lý quản lý việc ghi nhật ký tư thế không gian thực tế cho các mô hình chuyển động vật lý sáu bậc tự do (6DoF), được dùng để mô phỏng tính năng theo dõi chuyển động nâng cao.

  • physics {record-gt| stop} Quản lý bản ghi mô hình tư thế vật lý.
    • record-gt: Bắt đầu ghi dữ liệu chuyển động 6DoF thực tế.
    • stop: Tạm dừng quy trình ghi lại thông tin thực tế hiện tại.

Chế độ điều khiển thiết bị nâng cao

Phần này tổng hợp các điểm cuối lệnh của bảng điều khiển chuyên biệt cao cho các cấu hình mô phỏng nâng cao, bao gồm proxy mạng, cấu hình nhiều màn hình, ghi đè kết xuất và gỡ lỗi trực tiếp trình điều khiển ảo hoá.

  • multidisplay {add| del} Thêm hoặc xoá màn hình ảo phụ để kiểm thử cấu hình nhiều màn hình. Lưu ý: Màn hình phụ không được hỗ trợ trên các hồ sơ gập như Pixel Fold hoặc Trình mô phỏng có thể đổi kích thước.

  • proxy {set| clear} Định cấu hình chuyển tiếp proxy mạng theo phương thức lập trình từ bảng điều khiển.

    • set host port: Định cấu hình chế độ cài đặt proxy mục tiêu.
    • clear: Đặt lại cấu hình proxy về mặc định. Lưu ý: Các thao tác đặt proxy sẽ không thành công trong môi trường thực thi không có giao diện người dùng.
  • virtualscene-image {wall| table} image_path Tuỳ chỉnh tường nền hoặc bảng ngang hiển thị trên nguồn cấp dữ liệu từ camera cảnh ảo bằng tệp hình ảnh tuỳ chỉnh của người dùng.

  • resize-display scale Tự động điều chỉnh độ phân giải màn hình giữa các tỷ lệ đặt trước. Lưu ý: Tính năng điều chỉnh độ phân giải không được hỗ trợ trong cấu hình không có giao diện người dùng.

  • nodraw {on| off} Tắt tính năng kết xuất GUI vật lý trên màn hình máy chủ để giảm mức sử dụng bộ nhớ hệ thống và tải GPU trong quá trình chạy tự động không có giao diện người dùng ở chế độ nền với khối lượng lớn.

  • grpc port Định cấu hình chế độ kiểm soát thiết bị có lập trình nâng cao đối với các điểm cuối cổng gRPC tuỳ chỉnh.

  • qemu monitor Cung cấp quyền truy cập trực tiếp vào thiết bị đầu cuối tương tác cho bảng điều khiển của trình ảo hoá cơ bản. Bạn chỉ có thể nhập lệnh này trong các phiên bảng điều khiển Telnet đang hoạt động.

  • icebox track pid Bật ảnh chụp nhanh hệ thống tự động khi quy trình ứng dụng được chỉ định gặp phải một ngoại lệ hoặc sự cố chưa được xử lý.

  • phonenumber number Đặt số điện thoại ảo tại địa phương của thiết bị mục tiêu.

Giao diện lập trình gRPC

Các phiên bản trình mô phỏng hiện đại hỗ trợ giao diện lập trình gRPC mạnh mẽ cùng với bảng điều khiển Telnet cũ. Mặc dù bảng điều khiển Telnet rất phù hợp cho các phiên tương tác nhanh hoặc tập lệnh cơ bản, nhưng giao diện gRPC được thiết kế để điều khiển tự động hiệu suất cao, an toàn và mạnh mẽ trong môi trường tích hợp liên tục (CI) và không có giao diện người dùng. Bằng cách cung cấp các điểm cuối dịch vụ trực tiếp, gRPC giúp loại bỏ nhu cầu phân tích cú pháp luồng văn bản, quản lý các hoạt động bắt tay trong phiên hoạt động của thiết bị đầu cuối hoặc hiển thị các cổng máy chủ cục bộ không được mã hoá.

Để chọn giữa bảng điều khiển Telnet cũ và giao diện lập trình gRPC hiện đại, hãy xem bảng so sánh sau đây về hiệu suất, tính bảo mật và các tính năng:

Tính năng Bảng điều khiển Telnet Giao diện gRPC
Phù hợp nhất với Gỡ lỗi thủ công, phiên tương tác. CI/CD không có giao diện người dùng, các giàn thử nghiệm tự động nặng.
Speed Chậm hơn; hao tổn văn bản, độ trễ kết nối. HTTP/2 được tối ưu hoá, ghép kênh, proto nhanh.
Bảo mật Không mã hoá; cổng cục bộ (5554–5585). Có thể được bảo mật bằng TLS, hoạt động qua mạng.
Sự kiện phát trực tiếp Không được hỗ trợ; chỉ yêu cầu-phản hồi. Luồng cho logcat, thu âm thanh của khách.
Nội dung đa phương tiện Ghi tệp đầu ra vào ổ đĩa máy chủ/máy khách. Bộ đệm nhị phân trực tiếp qua dây.
Hệ điều hành khách Bị hạn chế đối với các lệnh cố định của trình mô phỏng. Chạy các lệnh shell bash gốc của khách.

Chạy và gọi gRPC

Để sử dụng các điểm cuối gRPC, hãy chạy Trình mô phỏng Android qua dòng lệnh và thêm cờ -grpc, chỉ định cổng lặp lại mục tiêu.

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

Sau khi trình mô phỏng chạy và bật dịch vụ gRPC, bạn có thể thực hiện các lệnh gọi RPC có lập trình. Để kiểm thử dòng lệnh, hãy sử dụng tiện ích grpcurl để giao tiếp với các dịch vụ của trình mô phỏng. Tất cả yêu cầu đều được định dạng bằng JSON và gửi qua văn bản thuần tuý.

# 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

Ánh xạ bảng điều khiển Telnet với dịch vụ gRPC

Bảng tham chiếu sau đây liên kết các lệnh cũ của bảng điều khiển Telnet với các dịch vụ và phương thức gRPC tương ứng, cho biết cách tự động hoá các hoạt động tương tác phổ biến với thiết bị ảo theo phương thức lập trình:

Danh mục Lệnh Telnet cũ Dịch vụ/Phương thức gRPC
Trạng thái ping EmulatorController/getStatus
Trạng thái avd name incubating.AvdService/getAvdInfo
Trạng thái kill EmulatorController/setVmState
Trạng thái restart EmulatorController/setVmState
Power power display EmulatorController/getBattery
Power power capacity EmulatorController/setBattery
Khu vực địa lý geo fix EmulatorController/setGps
Cảm biến sensor set incubating.SensorService/setSensor
Sinh trắc học finger touch EmulatorController/sendFingerprint
Tư thế posture EmulatorController/setPosture
Tư thế physics/fold EmulatorController/setPhysicalModel
SMS sms send EmulatorController/sendSms
Cuộc gọi GSM gsm call EmulatorController/sendPhone
Cuộc gọi GSM phonenumber EmulatorController/setPhoneNumber
Chuyển hướng redir add Waterfall/ForwardPort
Thiết bị đầu vào event send EV_KEY EmulatorController/sendKey
Thiết bị đầu vào event send EV_ABS EmulatorController/sendTouch
Nội dung đa phương tiện screenrecord incubating.ScreenRecording
Kết xuất nodraw EmulatorController/setDisplayMode
Ảnh chụp nhanh avd snapshot list SnapshotService/ListSnapshots
Ảnh chụp nhanh avd snapshot load/save SnapshotService/LoadSnapshot

Các lệnh có lập trình dành riêng cho gRPC

Giao diện gRPC cung cấp một số tính năng tiên tiến mà về mặt vật lý không thể thực thi qua các kết nối bảng điều khiển Telnet cũ. Các tính năng này bao gồm truyền trực tuyến logcat trực tiếp, thu nạp hoặc chèn âm thanh hai chiều, sửa đổi GUI của máy chủ và truy cập trực tiếp vào shell.

Dịch vụ/Phương thức gRPC Tham số Chức năng
streamLogcat {"maxLines": 100} Truyền trực tuyến kết quả logcat của hệ thống khách
streamAudio {} Truyền âm thanh của loa qua dây
injectAudio {"audio": "..."} Chèn luồng âm thanh từ micrô
UiController {"theme": "DARK"} Sửa đổi giao diện cửa sổ của cửa sổ lưu trữ
Waterfall/Exec {"cmd": "ls"} Chạy các lệnh shell gốc của hệ điều hành khách

Mô phỏng và xác thực vân tay

Hình 1. Màn hình xác thực vân tay.

Sử dụng lệnh finger để mô phỏng và xác thực vân tay cho ứng dụng của bạn. Bạn cần có Bộ công cụ SDK 24.3 trở lên và Android 6.0 (cấp độ API 23) trở lên.

Để mô phỏng và xác thực vân tay, hãy làm theo các bước sau:

  1. Nếu bạn chưa có mã nhận dạng vân tay, hãy đăng ký vân tay mới trong trình mô phỏng bằng cách chọn Settings > Security > Fingerprint (Cài đặt > Bảo mật > Vân tay) và làm theo hướng dẫn đăng ký.

  2. Thiết lập sao cho ứng dụng của bạn chấp nhận xác thực vân tay. Sau khi bạn thiết lập như vậy, thiết bị của bạn sẽ hiển thị màn hình xác thực vân tay.

  3. Trong khi ứng dụng hiển thị màn hình xác thực vân tay, hãy chuyển đến bảng điều khiển rồi nhập lệnh finger touch và mã nhận dạng vân tay bạn đã tạo. Lệnh này sẽ mô phỏng thao tác nhấn ngón tay.

  4. Sau đó, nhập lệnh finger remove để mô phỏng thao tác nhấc ngón tay ra. Ứng dụng của bạn phải phản hồi như thể người dùng đã chạm rồi nhấc ngón tay ra khỏi cảm biến vân tay.