Nhấn vào Point, tuple (x, y), Match hoặc MatchList.
Cú pháp
click(target, hold_ms=0, offset=(0, 0), random=0, delay_before=0, delay_after=0, parallel=False)Tham số
| Tên | Mô tả |
|---|---|
targetPoint | tuple[Number, Number] | Match | MatchList | Point, tuple tọa độ, Match hoặc MatchList đích. Match/MatchList có nhiều point sẽ nhấn từng point tìm thấy. Bắt buộc · Theo vị trí hoặc tên Không có giá trị mặc định |
hold_msInt | Thời gian giữ (milliseconds) Tùy chọn · Theo vị trí hoặc tên Mặc định: 0 |
offsettuple[Number, Number] | Cộng khoảng lệch pixel sau khi đã resolve điểm đích. Tùy chọn · Theo vị trí hoặc tên Mặc định: (0, 0) |
randomNumber | tuple[Number, Number] | Cộng độ lệch pixel ngẫu nhiên sau khi đã resolve điểm đích. Tùy chọn · Theo vị trí hoặc tên Mặc định: 0 |
delay_beforeNumber | Độ trễ trước khi nhấn (milliseconds). Tùy chọn · Theo vị trí hoặc tên Mặc định: 0 |
delay_afterNumber | Độ trễ sau khi nhấn (milliseconds). Tùy chọn · Theo vị trí hoặc tên Mặc định: 0 |
parallelBoolean | Khi True, trả về id touch dạng số. Trong chế độ gom, touch chờ Touch.send(); các touch đã gom và còn overlap có thể bắt đầu ở các delay_before khác nhau mà không hủy nhau. Tùy chọn · Theo vị trí hoặc tên Mặc định: False |
Giá trị trả về
Number | list[Number] | None — Trả về một id dạng số cho một lần nhấn song song được queue, list[Number] khi Match hoặc MatchList nhiều point queue nhiều lần nhấn song song, còn lại trả về None.Hành vi / tác động
Nhấn vào Point, tuple (x, y), Match hoặc MatchList. Mọi tham số đều hỗ trợ truyền theo vị trí hoặc theo tên theo đúng thứ tự trong chữ ký. Dùng Point(x, y) khi cần thông tin scale/anchor; dùng (x, y) cho tọa độ pixel cố định. Dùng parallel=True để đưa touch vào hàng đợi và nhận id dạng số; gọi Touch.cancel(id) hoặc Touch.cancel() để hủy touch đang queue/active.
Thực thi
- Chờ hoàn tất: Tùy điều kiện
- An toàn khi chạy đồng thời: Có giới hạn
- Chạy song song: Tùy điều kiện
Cử chỉ Android dùng chung thiết bị. parallel=True xếp hàng id chạm nhưng delay_before và delay_after vẫn chặn luồng gọi ngoài collect. Trong collect, các lần chạm được gom để Touch.send(); Touch.wait() chờ chúng hoàn tất.
Ví dụ
# Nhấn tọa độ màn hình bằng Point hoặc tuple
click(Point(500, 900))
click((500, 900))
click((500, 900), hold_ms=200)
click(Point(500, 900), 0, (0, 0), 10, 0, 500)
match = Region(100, 200, 300, 400).find("start", 3000)
if match.found:
click(match, offset=(0, 6))
hits = Region(100, 200, 300, 400).find_any(["a", "b"], 3000)
if hits:
click(hits, random=0)
# Gom hai thao tác chạm song song, gửi cùng lúc rồi chờ hàng đợi
Touch.collect()
a = click(Point(300, 900), parallel=True)
b = click(Point(780, 900), parallel=True)
Touch.send()
Touch.wait()
# Giữ p1, rồi nhấn p2 sau 1 giây mà không nhả p1
Touch.collect()
p1 = click(Point(300, 900), hold_ms=5000, parallel=True)
p2 = click(Point(780, 900), hold_ms=1000, delay_before=1000, parallel=True)
Touch.send()
Touch.cancel(p1)
Touch.wait()Lỗi / giới hạn
Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.