click

Nhấn rồi thả tại từng điểm đích. Mặc định, chờ nhấn xong rồi mới chạy tiếp. Có thể truyền tham số theo vị trí hoặc theo tên theo thứ tự trong chữ ký.

Cú pháp

click(target, hold_ms=0, offset=(0, 0), random=0, delay_before=0, delay_after=0, parallel=False)

Tham số

TênMô tả
targetPoint | tuple[Number, Number] | Match | MatchList
Point, tọa độ pixel cố định (x, y), hoặc kết quả tìm kiếm. Dùng Point khi cần co giãn hoặc neo tọa độ. Nhấn mọi điểm tìm được; không nhấn nếu không tìm được điểm nào.
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ữ tính bằng mili giây
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
offsettuple[Number, Number]
Độ lệch ngang và dọc, tính bằng pixel, cộng vào tọa độ đích cuối cùng.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: (0, 0)
randomNumber | tuple[Number, Number]
Độ lệch pixel ngẫu nhiên tối đa về mỗi phía của điểm đích. Một số áp dụng cho cả hai trục; (x, y) đặt riêng từng trục. Giá trị âm được đổi thành 0.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
delay_beforeNumber
Thời gian chờ trước khi nhấn, tính bằng mili giây.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
delay_afterNumber
Thời gian chờ sau khi nhấn, tính bằng mili giây.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
parallelBoolean
True: đưa thao tác chạm vào hàng đợi và trả về mã số mà không chờ hoàn tất. Sau Touch.collect(), chờ Touch.send(); các thao tác đã gom có thể diễn ra đồng thời với delay_before khác nhau. Dùng Touch.cancel(id) để hủy một thao tác hoặc Touch.cancel() để hủy tất cả.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False

Giá trị trả về

Number | list[Number] | None — Khi parallel=True: mã thao tác chạm nếu có một điểm, hoặc danh sách mã nếu có nhiều điểm. Trường hợp khác, hoặc không tìm được điểm: None.

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()