Saltar al contenido principal

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

ParameterTypeDescription
swipePointsList<SwipePoint>Una lista de puntos que el dedo recorre. Mínimo 2 puntos.
paramsSwipeParamsOpcional. 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 pantalla
  • holdDuration — 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 punto
  • holdDuration — 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:

TimeAction
0msPresionar en (100, 500)
50msComenzar a moverse a (400, 500)
1050msLlegar a (400, 500), mantener 3000ms
4050msComenzar a moverse a (400, 900)
5050msLlegar a (400, 900), mantener 50ms
5100msEl 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.