click

Function

Click on a Point, (x, y) tuple, Match, or MatchList.

Sintaks

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

Parameter

Nama	Deskripsi
`targetPoint \| tuple[Number, Number] \| Match \| MatchList`	Target Point, coordinate tuple, found Match, or MatchList. Match/MatchList values with multiple points click each found point. Wajib · Posisi atau nama Tanpa nilai bawaan
`hold_msInt`	Hold duration in milliseconds Opsional · Posisi atau nama Default: `0`
`offsettuple[Number, Number]`	Add a pixel offset after resolving the target point. Opsional · Posisi atau nama Default: `(0, 0)`
`randomNumber \| tuple[Number, Number]`	Add random pixel offset after resolving the target point. Opsional · Posisi atau nama Default: `0`
`delay_beforeNumber`	Delay before the click in milliseconds. Opsional · Posisi atau nama Default: `0`
`delay_afterNumber`	Delay after the click in milliseconds. Opsional · Posisi atau nama Default: `0`
`parallelBoolean`	When True, returns a numeric touch id. In collect mode the touch waits for Touch.send(); collected overlapping touches may start at different delay_before offsets without cancelling each other. Opsional · Posisi atau nama Default: `False`

Nilai yang dikembalikan

Number | list[Number] | None — Mengembalikan satu id numerik untuk satu klik paralel yang diantri, sebuah daftar[Nomor] ketika Match multi-titik atau MatchList mengantri beberapa klik paralel, jika tidak, Tidak Ada.

Perilaku / efek samping

Click on a Point, (x, y) tuple, Match, or MatchList. Every parameter supports positional or named form in the documented order. Use Point(x, y) for coordinate metadata such as scale/anchor; use (x, y) for fixed pixel coordinates. Use parallel=True to queue this touch and receive its numeric id; call Touch.cancel(id) or Touch.cancel() to cancel queued/active touches.

Eksekusi

Menunggu selesai: Bersyarat
Keamanan akses bersamaan: Terbatas
Eksekusi paralel: Bersyarat

Gestur Android berbagi perangkat. parallel=True mengantrekan id sentuhan, tetapi delay_before dan delay_after masih memblokir di luar mode collect. Dalam collect, sentuhan dikumpulkan untuk Touch.send(); Touch.wait() menunggu selesai.

Contoh

# Klik koordinat layar dengan Point atau 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)

# Kumpulkan dua sentuhan paralel, kirim bersama, lalu tunggu antrean
Touch.collect()
a = click(Point(300, 900), parallel=True)
b = click(Point(780, 900), parallel=True)
Touch.send()
Touch.wait()

# Tahan p1, lalu ketuk p2 setelah 1 detik tanpa melepas 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()

Kesalahan / batasan

Tidak ada batasan tambahan yang didokumentasikan; ikuti kontrak parameter dan perilaku di atas.