Screen:swipe()

화면에서 단일 손가락 스와이프를 수행합니다. 스와이프 경로는 손가락이 순차적으로 이동하는 SwipePoint 값 목록으로 정의됩니다.

시그니처

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

반환값

void

매개변수

매개변수	타입	설명
swipePoints	List<SwipePoint>	손가락이 이동하는 지점 목록입니다. 최소 2개의 지점이 필요합니다.
params	SwipeParams	선택 사항입니다. 연속 모드 및 지연과 같은 스와이프 동작을 제어합니다.

swipe에서 SwipePoint 동작

목록의 각 지점은 SwipePoint(x, y, holdDuration, swipeDuration)입니다. 각 매개변수의 의미는 지점의 위치에 따라 다릅니다.

첫 번째 지점(시작 위치):

• swipeDuration — 손가락이 눌리기 전의 초기 지연(밀리초)
• holdDuration — 다음 지점으로 이동하기 전에 시작 위치에서 유지하는 시간

이후 지점들(이동 대상):

• swipeDuration — 이전 지점에서 이 지점까지 이동하는 데 걸리는 시간(밀리초)
• holdDuration — 도착 후 이 지점에서 유지하는 시간(다음 이동 전 일시 정지)

마지막 지점:

• holdDuration — 손가락이 떼어지기 전에 최종 위치에서 후행 유지 시간

예시

간단한 스와이프

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

손가락이 (500, 1200)에서 즉시 눌리고, 50ms 동안 유지된 후, 1초에 걸쳐 (500, 400)까지 위로 스와이프합니다.

초기 지연이 있는 스와이프

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

2초 대기한 후 (300, 800)에서 누르고, 50ms 동안 유지한 다음, 1.5초에 걸쳐 (700, 800)까지 오른쪽으로 스와이프합니다.

유지가 있는 다중 지점 스와이프

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

타임라인:

시간	동작
0ms	(100, 500)에서 누르기
50ms	(400, 500)으로 이동 시작
1050ms	(400, 500)에 도착, 3000ms 동안 유지
4050ms	(400, 900)으로 이동 시작
5050ms	(400, 900)에 도착, 50ms 동안 유지
5100ms	손가락 떼기

손가락이 오른쪽으로 스와이프하고, 3초 동안 일시 정지한 후 아래로 스와이프합니다.

SwipeParams를 사용한 연속 스와이프

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

setContinue(true)를 설정하면 손가락이 스와이프 지점 사이에서 떼지지 않습니다. 이를 통해 Android 8.1 이상에서 접근성 서비스와 함께 부드러운 연속 제스처를 사용할 수 있습니다. 네이티브 서비스에서는 이 설정과 관계없이 항상 연속으로 스와이프됩니다.

느린 드래그

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

(540, 1800)에서 누르고, 100ms 동안 유지한 후, 5초에 걸쳐 (540, 600)까지 천천히 위로 드래그합니다.