Runtime v2.81 · Diperbarui 30 Sep 2026

swipe

Lakukan gerakan menggesek dari daftar datar nilai SwipePoint.

Sintaks

swipe(points, *, parallel=False)

Parameter

NamaDeskripsi
pointslist[SwipePoint]
Flat path for one finger. Requires at least 2 points.
Wajib · Posisi atau nama
Tanpa nilai bawaan
parallelBoolean
When True, returns a numeric touch id. In collect mode the swipe waits for Touch.send(); otherwise it queues immediately. Use Touch.cancel(id) or Touch.cancel() to cancel queued/active touches.
Opsional · Hanya nama
Default: False

Nilai yang dikembalikan

Number | None — Mengembalikan id numerik hanya ketika parallel=True; jika tidak, Tidak ada.

Perilaku / efek samping

Lakukan gerakan menggesek dari daftar datar nilai SwipePoint. Setiap daftar menciptakan satu jalur multi-titik untuk satu jari.

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

path = [
    SwipePoint(Point(500, 1500), speed="FAST"),
    SwipePoint((560, 980), speed="NORMAL", humanized=True),
    SwipePoint(Point(500, 500))
]
swipe(path)

Touch.collect()
left = swipe(path, parallel=True)
right = swipe([
    SwipePoint(Point(780, 1500), speed="FAST"),
    SwipePoint(Point(780, 500))
], parallel=True)
Touch.send()
Touch.wait()

Kesalahan / batasan

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

API terkait