pressKey
Nhấn phím cứng như home, back, enter hoặc nút âm lượng.
Hỗ trợ một phần trong Astra Scout
Chỉ các phím trong bảng bên dưới là dùng được, và danh sách khác nhau theo nền tảng. Các phím remote của Android TV (Remote Dpad Up, TV Input và tương tự) không được hỗ trợ. lock chỉ dùng được trên iOS. Tên phím không phân biệt hoa thường và nhận cả cách viết của Maestro: volume_up, volume up và Volume-Up là cùng một phím, và chữ Remote ở đầu được bỏ qua (Remote Dpad Up là dpad_up). Phím media (Remote Media …), TV Input và các phím remote TV khác không dùng được trên nền tảng nào.
Command pressKey giả lập việc nhấn một phím vật lý hoặc ảo trên device.
Cú pháp
Để dùng pressKey, bạn cần chỉ định phím cần nhấn:
- pressKey: "keyToPress"Các phím được hỗ trợ
Chỉ dùng một phím mỗi lần. Tên phím không phân biệt hoa thường.
| Key | Android | iOS | Mô tả |
|---|---|---|---|
home | Có | Có | Nhấn nút home. |
enter | Có | Có | Nhấn phím enter (return). |
backspace (hoặc delete) | Có | Có | Xoá ký tự phía trước. |
tab | Có | Có | Nhấn phím tab. |
space | Có | Có | Nhấn phím cách. |
volume_up | Có | Có | Tăng âm lượng device. |
volume_down | Có | Có | Giảm âm lượng device. |
lock | Không | Có | Nhấn nút sườn (khoá hoặc đánh thức device). |
siri | Không | Có | Giữ nút sườn để gọi Siri (iPhone thật iOS 27, qua devicehid). |
appSwitcher | Không | Có | Mở App Switcher (nhấn Home hai lần; iPhone thật iOS 27, simulator). |
actionButton | Không | Có | Nhấn Action button (iPhone thật iOS 27, simulator). |
screenshot | Không | Có | Chụp màn hình vào Photos (iPhone thật iOS 27). |
back | Có | Không | Nhấn nút back của hệ thống. |
power | Có | Không | Nhấn nút nguồn. |
menu | Có | Không | Nhấn phím menu. |
search | Có | Không | Nhấn phím tìm kiếm. |
camera | Có | Không | Nhấn phím camera. |
dpad_up, dpad_down, dpad_left, dpad_right, dpad_center | Có | Không | Các phím điều hướng (directional pad). |
Phím phần cứng iOS
lock chạy được khi chưa mở mirror (qua WebDriverAgent của flow đang chạy; trên simulator, nếu fail thì mở simulator trong Astra Scout). siri, appSwitcher, actionButton và screenshot cần mở device trong Astra Scout (mirror); nếu không, step sẽ fail và báo rõ.