Runtime v2.81 · Diperbarui 30 Sep 2026

Touch

Pembantu statis untuk tindakan klik/gesek paralel yang dibuat oleh UI atau kode melalui klik(..., paralel=True) dan geser(..., paralel=True).

Sintaks

Touch

Kelas ini tidak dapat dibuat langsung.

Parameter

Tidak ada

Nilai yang dikembalikan

—

Perilaku / efek samping

Pembantu statis untuk tindakan klik/gesek paralel yang dibuat oleh UI atau kode melalui klik(..., paralel=True) dan geser(..., paralel=True). Anda dapat mengumpulkan tindakan klik/gesek dan mengirimkannya bersama-sama, atau memeriksa tindakan klik/gesek yang aktif atau antri. Helper ini juga mendukung pembatalan tindakan klik/gesek aktif (khusus Android 8.0+).

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

Touch.collect()
a = click(Point(300, 900), hold_ms=5000, parallel=True)
b = click(Point(780, 900), hold_ms=1000, delay_before=1000, parallel=True)
sent = Touch.send()
Touch.cancel(a)
Touch.wait()

Kesalahan / batasan

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

API terkait

Metode

7 metode

Touch.collect

Enable collect mode for click/swipe calls with parallel=True.

Sintaks

Touch.collect()

Parameter

Tidak ada

Nilai yang dikembalikan

None

Perilaku / efek samping

Enable collect mode for click/swipe calls with parallel=True. When enabled, parallel click/swipe calls are not sent immediately; they are collected and only sent after Touch.send(). This method works for both UI/code. If Touch.collect() is not enabled, parallel click/swipe calls are sent immediately, and later click/swipe calls must wait for the previous click/swipe to finish before they can run because running a later click/swipe immediately would cancel the previous one. You can intentionally cancel the previous click/swipe with Touch.cancel().

Eksekusi

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

collect/send dan kueri status tidak menunggu gestur selesai. Perintah terkumpul baru masuk executor melalui Touch.send(); snapshot antrean dapat segera berubah.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.send

Send all click/swipe calls collected by Touch.collect() at once, return their matching numeric ids, then turn off Touch.collect() collection mode.

Sintaks

Touch.send()

Parameter

Tidak ada

Nilai yang dikembalikan

list[Number]

Perilaku / efek samping

Send all click/swipe calls collected by Touch.collect() at once, return their matching numeric ids, then turn off Touch.collect() collection mode.

Eksekusi

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

collect/send dan kueri status tidak menunggu gestur selesai. Perintah terkumpul baru masuk executor melalui Touch.send(); snapshot antrean dapat segera berubah.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.queued

Return touch states currently in the queue.

Sintaks

Touch.queued()

Parameter

Tidak ada

Nilai yang dikembalikan

list[TouchState]

Perilaku / efek samping

Return touch states currently in the queue.

Eksekusi

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

collect/send dan kueri status tidak menunggu gestur selesai. Perintah terkumpul baru masuk executor melalui Touch.send(); snapshot antrean dapat segera berubah.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.queued())
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.active

Return active touch states.

Sintaks

Touch.active()

Parameter

Tidak ada

Nilai yang dikembalikan

list[TouchState]

Perilaku / efek samping

Return active touch states.

Eksekusi

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

collect/send dan kueri status tidak menunggu gestur selesai. Perintah terkumpul baru masuk executor melalui Touch.send(); snapshot antrean dapat segera berubah.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.active())
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.all

Return recent and queued/active touch states.

Sintaks

Touch.all()

Parameter

Tidak ada

Nilai yang dikembalikan

list[TouchState]

Perilaku / efek samping

Return recent and queued/active touch states.

Eksekusi

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

collect/send dan kueri status tidak menunggu gestur selesai. Perintah terkumpul baru masuk executor melalui Touch.send(); snapshot antrean dapat segera berubah.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.all())
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.wait

Wait for one numeric id, or every queued/active touch when id is None.

Sintaks

Touch.wait(id=None)

Parameter

Tidak ada

Nilai yang dikembalikan

TouchState | list[TouchState]

Perilaku / efek samping

Wait for one numeric id, or every queued/active touch when id is None.

Eksekusi

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

Menunggu dalam alur pemanggil hingga waktu yang diminta atau sentuhan selesai. Alur lain dapat lanjut; pause dan stop tetap berlaku.

Contoh

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait(first)
Touch.wait()

Kesalahan / batasan

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

API terkait

Touch.cancel

Cancel one queued or active touch by numeric id.

Sintaks

Touch.cancel(id=None)

Parameter

Tidak ada

Nilai yang dikembalikan

Boolean | Int

Perilaku / efek samping

Cancel one queued or active touch by numeric id. When id is None, cancels every queued/active touch and returns the accepted cancel count. Active cancel requires Android 8.0+; Android 7.x scripts fail with a clear error when an active touch is targeted.

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

# Periksa atau kendalikan sentuhan yang terkumpul
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
# Pembatalan aktif memerlukan Android 8 atau lebih baru
Touch.cancel(second)
Touch.wait()

Kesalahan / batasan

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

API terkait