Runtime v2.81 · Na-update noong Set 30, 2026

click

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

Syntax

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

Mga parameter

PangalanPaglalarawan
targetPoint | tuple[Number, Number] | Match | MatchList
Target Point, coordinate tuple, found Match, or MatchList. Match/MatchList values with multiple points click each found point.
Kailangan · Ayon sa posisyon o pangalan
Walang default
hold_msInt
Hold duration in milliseconds
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
offsettuple[Number, Number]
Add a pixel offset after resolving the target point.
Opsyonal · Ayon sa posisyon o pangalan
Default: (0, 0)
randomNumber | tuple[Number, Number]
Add random pixel offset after resolving the target point.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
delay_beforeNumber
Delay before the click in milliseconds.
Opsyonal · Ayon sa posisyon o pangalan
Default: 0
delay_afterNumber
Delay after the click in milliseconds.
Opsyonal · Ayon sa posisyon o pangalan
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.
Opsyonal · Ayon sa posisyon o pangalan
Default: False

Ibinabalik na halaga

Number | list[Number] | None — Nagbabalik ng isang numeric id para sa isang naka-queue na parallel na pag-click, isang listahan[Number] kapag ang isang multi-point na Match o MatchList ay pumila ng maraming parallel na pag-click, kung hindi, Wala.

Pagkilos / epekto

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.

Pagpapatakbo

  • Naghihintay matapos: May kondisyon
  • Kaligtasan ng sabayang paggamit: May limitasyon
  • Sabayang pagpapatakbo: May kondisyon

Pinagsasaluhan ng mga Android gesture ang device. Naglalagay sa queue ng touch id ang parallel=True, pero naghihintay pa rin ang delay_before at delay_after sa labas ng collect mode. Sa collect, iniipon ang mga touch para sa Touch.send(); hinihintay ng Touch.wait() ang pagtatapos.

Halimbawa

# I-click ang coordinate sa screen gamit ang Point o 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)

# Kolektahin ang dalawang parallel touch, ipadala nang sabay, pagkatapos hintayin ang queue
Touch.collect()
a = click(Point(300, 900), parallel=True)
b = click(Point(780, 900), parallel=True)
Touch.send()
Touch.wait()

# Hawakan ang p1, pagkatapos i-tap ang p2 pagkalipas ng 1 segundo nang hindi binibitiwan ang 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()

Mga error / limitasyon

Walang karagdagang limitasyong nakadokumento; sundin ang mga parameter at pagkilos sa itaas.

Mga kaugnay na API