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:
Mở cửa sổ dòng lệnh và nhập lệnh sau:
telnet localhost console-portTiê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 devicesin 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ộ.
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_tokenphải phù hợp với nội dung của tệp.emulator_console_auth_tokentrong thư mục gốc.Nếu tệp đó không tồn tại, lệnh
telnet localhost console-portsẽ 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_tokenhoặc tạo một tệp trống nếu không có tệp đó.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 commandhoặchelp-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ể.Để thoát khỏi phiên điều khiển, hãy nhập
quithoặcexit.
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 firstactivitysnapshotfold: 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-portThê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-portXoá 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 OKevent 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đếnKEY_Z(26 mã). - Phím trên bàn phím số:
KEY_1đếnKEY_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đếnKEY_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 latencyThay đổ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
-netdelayvớ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 100network speed speedTrì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 80network capture {start| stop} fileGử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ụcconsole_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} phonenumberCá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} stateLệ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.812348Cá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 textmessageTạ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} fileBắ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
.webmbắ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.
- start file: Bắt đầu quay video. Tệp đầu ra phải kết thúc bằng
đuôi
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_pathTuỳ 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 scaleTự độ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 monitorCung 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 pidBậ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
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:
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ý.
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.
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 touchvà 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.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.