click

กดแล้วปล่อยที่จุดเป้าหมายแต่ละจุด โดยปกติจะรอให้การกดเสร็จก่อนทำงานต่อ ระบุอาร์กิวเมนต์ตามตำแหน่งหรือตามชื่อได้ตามลำดับที่ระบุไว้

รูปแบบคำสั่ง

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

พารามิเตอร์

ชื่อคำอธิบาย
targetPoint | tuple[Number, Number] | Match | MatchList
Point, พิกัดพิกเซลคงที่ (x, y) หรือผลการค้นหา ใช้ Point เมื่อต้องการปรับสเกลหรือยึดตำแหน่ง กดทุกจุดที่พบ และไม่ทำอะไรหากไม่พบจุด
จำเป็น · ระบุตามตำแหน่งหรือชื่อ
ไม่มีค่าเริ่มต้น
hold_msInt
ระยะเวลากดค้าง หน่วยมิลลิวินาที
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
offsettuple[Number, Number]
ระยะเยื้องแนวนอนและแนวตั้งเป็นพิกเซล ที่บวกกับพิกัดเป้าหมายสุดท้าย
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: (0, 0)
randomNumber | tuple[Number, Number]
ระยะเยื้องสุ่มสูงสุดเป็นพิกเซลในแต่ละทิศทางจากเป้าหมาย ตัวเลขเดียวใช้กับทั้งสองแกน ส่วน (x, y) กำหนดแต่ละแกนแยกกัน ค่าลบจะถูกเปลี่ยนเป็น 0
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
delay_beforeNumber
เวลารอก่อนกด หน่วยมิลลิวินาที
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
delay_afterNumber
เวลารอหลังกด หน่วยมิลลิวินาที
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: 0
parallelBoolean
True: นำการแตะเข้าคิวและคืนรหัสตัวเลขโดยไม่รอให้เสร็จ หลัง Touch.collect() จะรอ Touch.send(); การแตะที่รวบรวมไว้สามารถทำงานซ้อนกันด้วยค่า delay_before ต่างกันได้ ยกเลิกด้วย Touch.cancel(id) หรือยกเลิกทั้งหมดด้วย Touch.cancel()
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: False

ค่าที่ส่งกลับ

Number | list[Number] | None — เมื่อ parallel=True: คืนรหัสการแตะหนึ่งรหัสสำหรับหนึ่งจุด หรือรายการรหัสสำหรับหลายจุด กรณีอื่นหรือไม่พบจุดใด: None

ตัวอย่าง

# แตะพิกัดหน้าจอด้วย Point หรือ 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)

# รวมการแตะพร้อมกันสองรายการ ส่งพร้อมกัน แล้วรอคิว
Touch.collect()
a = click(Point(300, 900), parallel=True)
b = click(Point(780, 900), parallel=True)
Touch.send()
Touch.wait()

# กด p1 ค้างไว้ แล้วแตะ p2 หลัง 1 วินาทีโดยไม่ปล่อย 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()