Screen:swipe()

Führt ein einfingeriges Wischen auf dem Bildschirm aus. Der Wischpfad wird durch eine Liste von SwipePoint-Werten definiert, die der Finger nacheinander durchläuft.

Signatur

Screen:swipe(swipePoints: List<SwipePoint>, params?: SwipeParams): void

Rückgabe

void

Parameter

Parameter	Typ	Beschreibung
swipePoints	List<SwipePoint>	Eine Liste von Punkten, die der Finger durchläuft. Minimum 2 Punkte.
params	SwipeParams	Optional. Steuert das Wischverhalten wie kontinuierlichen Modus und Verzögerung.

SwipePoint-Verhalten

Jeder Punkt in der Liste ist ein SwipePoint(x, y, holdDuration, swipeDuration). Die Bedeutung hängt von der Position des Punkts ab:

Erster Punkt (Startposition):

• swipeDuration — Anfangsverzögerung in Millisekunden, bevor der Finger aufsetzt
• holdDuration — Wie lange an der Startposition gehalten wird, bevor zum nächsten Punkt bewegt wird

Nachfolgende Punkte (Bewegungsziele):

• swipeDuration — Dauer in Millisekunden, um vom vorherigen Punkt zu diesem Punkt zu gelangen
• holdDuration — Wie lange nach dem Ankommen an diesem Punkt gehalten wird (Pause vor der nächsten Bewegung)

Letzter Punkt:

• holdDuration — Abschließendes Halten an der Endposition, bevor der Finger angehoben wird

Beispiele

Einfaches Wischen

Screen:swipe({
  SwipePoint(500, 1200, 50, 0),
  SwipePoint(500, 400, 50, 1000),
})

Der Finger setzt sofort bei (500, 1200) auf, hält 50 ms und wischt dann innerhalb von 1 Sekunde nach oben zu (500, 400).

Wischen mit anfänglicher Verzögerung

Screen:swipe({
  SwipePoint(300, 800, 50, 2000),
  SwipePoint(700, 800, 50, 1500),
})

Wartet 2 Sekunden, setzt dann bei (300, 800) auf, hält 50 ms und wischt innerhalb von 1,5 Sekunden nach rechts zu (700, 800).

Multipunkt-Wischen mit Halten

Screen:swipe({
  SwipePoint(100, 500, 50, 0),
  SwipePoint(400, 500, 3000, 1000),
  SwipePoint(400, 900, 50, 1000),
})

Zeitachse:

Zeit	Aktion
0 ms	Aufsetzen bei (100, 500)
50 ms	Bewegung zu (400, 500) beginnt
1050 ms	Ankunft bei (400, 500), 3000 ms halten
4050 ms	Bewegung zu (400, 900) beginnt
5050 ms	Ankunft bei (400, 900), 50 ms halten
5100 ms	Finger wird angehoben

Der Finger wischt nach rechts, pausiert für 3 Sekunden und wischt dann nach unten.

Kontinuierliches Wischen mit SwipeParams

Screen:swipe({
  SwipePoint(200, 600, 50, 0),
  SwipePoint(500, 300, 50, 2000),
}, SwipeParams():setContinue(true))

Wenn setContinue(true) gesetzt ist, wird der Finger zwischen den Wischpunkten nicht angehoben. Dies ermöglicht fließende kontinuierliche Gesten auf Android 8.1+ mit Accessibility Service. Beim Native Service sind Wischgesten unabhängig von dieser Einstellung immer kontinuierlich.

Langsames Ziehen

Screen:swipe({
  SwipePoint(540, 1800, 100, 0),
  SwipePoint(540, 600, 50, 5000),
})

Setzt bei (540, 1800) auf, hält 100 ms und zieht dann langsam innerhalb von 5 Sekunden nach oben zu (540, 600).