Screen:swipe()
Realizar un deslizamiento con un solo dedo en la pantalla. La ruta del deslizamiento se define mediante una lista de valores SwipePoint que el dedo recorre secuencialmente.
Firma
Screen:swipe(swipePoints: List<SwipePoint>, params?: SwipeParams): void
Devuelve
void
Parámetros
| Parameter | Type | Description |
|---|---|---|
| swipePoints | List<SwipePoint> | Una lista de puntos que el dedo recorre. Mínimo 2 puntos. |
| params | SwipeParams | Opcional. Controla el comportamiento del deslizamiento, como el modo continuo y el retardo. |
Comportamiento de SwipePoint
Cada punto de la lista es un SwipePoint(x, y, holdDuration, swipeDuration). El significado depende de la posición del punto:
Primer punto (posición inicial):
swipeDuration— Retardo inicial en milisegundos antes de que el dedo toque la pantallaholdDuration— Cuánto tiempo mantenerse en la posición inicial antes de moverse al siguiente punto
Puntos posteriores (destinos de movimiento):
swipeDuration— Duración en milisegundos para desplazarse desde el punto anterior hasta este puntoholdDuration— Cuánto tiempo mantenerse en este punto después de llegar (pausa antes del siguiente movimiento)
Último punto:
holdDuration— Mantenimiento final en la última posición antes de que el dedo se levante
Ejemplos
Deslizamiento simple
Screen:swipe({
SwipePoint(500, 1200, 50, 0),
SwipePoint(500, 400, 50, 1000),
})
El dedo toca la pantalla en (500, 1200) inmediatamente, se mantiene 50ms, luego se desliza hacia arriba hasta (500, 400) durante 1 segundo.
Deslizamiento con retardo inicial
Screen:swipe({
SwipePoint(300, 800, 50, 2000),
SwipePoint(700, 800, 50, 1500),
})
Espera 2 segundos, luego toca la pantalla en (300, 800), se mantiene 50ms y se desliza hacia la derecha hasta (700, 800) durante 1.5 segundos.
Deslizamiento multipunto con mantenimiento
Screen:swipe({
SwipePoint(100, 500, 50, 0),
SwipePoint(400, 500, 3000, 1000),
SwipePoint(400, 900, 50, 1000),
})
Cronología:
| Time | Action |
|---|---|
| 0ms | Presionar en (100, 500) |
| 50ms | Comenzar a moverse a (400, 500) |
| 1050ms | Llegar a (400, 500), mantener 3000ms |
| 4050ms | Comenzar a moverse a (400, 900) |
| 5050ms | Llegar a (400, 900), mantener 50ms |
| 5100ms | El dedo se levanta |
El dedo se desliza hacia la derecha, hace una pausa de 3 segundos y luego se desliza hacia abajo.
Deslizamiento continuo con SwipeParams
Screen:swipe({
SwipePoint(200, 600, 50, 0),
SwipePoint(500, 300, 50, 2000),
}, SwipeParams():setContinue(true))
Cuando se establece setContinue(true), el dedo no se levanta entre los puntos de deslizamiento. Esto permite gestos continuos suaves en Android 8.1+ con Accessibility Service. En Native Service, los deslizamientos siempre son continuos independientemente de esta configuración.
Arrastre lento
Screen:swipe({
SwipePoint(540, 1800, 100, 0),
SwipePoint(540, 600, 50, 5000),
})
Toca la pantalla en (540, 1800), se mantiene 100ms, luego arrastra lentamente hacia arriba hasta (540, 600) durante 5 segundos.