Runtime v2.81 · Cập nhật 30 thg 9, 2026

SwipePoint

Một điểm trong đường vuốt phẳng.

Cú pháp

SwipePoint(point, speed="NORMAL", delay_before=0, random=10, humanized=False, scale="fixed", anchor="none")

Tham số khởi tạo

TênMô tả
pointPoint | tuple[Number, Number]
Tọa độ dạng Point hoặc tuple (x, y). Metadata scale/anchor của Point được copy trừ khi SwipePoint truyền scale/anchor riêng.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
speedString
Preset tốc độ từ điểm này sang điểm kế tiếp. Giá trị: VERY_SLOW, SLOW, NORMAL, FAST, VERY_FAST.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: NORMAL
delay_beforeNumber
Độ trễ trước điểm/đoạn này theo milliseconds.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 0
randomNumber
Bán kính lệch ngẫu nhiên theo pixel cho điểm này.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: 10
humanizedBoolean
Dùng đường cong giống thao tác người thật khi được hỗ trợ.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: False
scaleString
Chế độ scale tọa độ.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: fixed
anchorString
Neo tọa độ.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: none

Giá trị trả về

SwipePoint

Hành vi / tác động

Một điểm trong đường vuốt phẳng. Point phải là Point hoặc tuple (x, y). Truyền list có ít nhất hai SwipePoint vào swipe([...]) để một ngón đi qua nhiều điểm.

Thực thi

  • Chờ hoàn tất: Không
  • An toàn khi chạy đồng thời: Dùng đối tượng riêng cho mỗi luồng
  • Chạy song song: Có

Thao tác giá trị chạy trong luồng gọi, không chủ động chờ chụp màn hình, hoàn tất cử chỉ hoặc nhập liệu. Tạo container/builder có thể thay đổi riêng cho từng luồng; đây là sự cô lập, không bảo đảm đồng bộ đối tượng dùng chung.

Ví dụ

# Hai ngón vuốt song song, mỗi ngón là một path phẳng
Touch.collect()
left = swipe([
    SwipePoint(Point(300, 1500), speed="FAST"),
    SwipePoint(Point(300, 500))
], parallel=True)
right = swipe([
    SwipePoint(Point(780, 1500), speed="FAST"),
    SwipePoint(Point(780, 500))
], parallel=True)
Touch.send()
Touch.wait()

Lỗi / giới hạn

Không có giới hạn bổ sung được ghi nhận; tuân thủ hợp đồng tham số và hành vi ở trên.

API liên quan

Không có

Thuộc tính

TênMô tả
pointPoint
Point tọa độ theo pixel. Point mang metadata scale/anchor.
speedString
Preset tốc độ từ điểm này sang điểm kế tiếp. Giá trị: VERY_SLOW, SLOW, NORMAL, FAST, VERY_FAST.
Mặc định: NORMAL
delay_beforeNumber
Độ trễ trước điểm/đoạn này theo milliseconds.
Mặc định: 0
randomNumber
Bán kính lệch ngẫu nhiên theo pixel cho điểm này.
Mặc định: 10
humanizedBoolean
Dùng đường cong giống thao tác người thật khi được hỗ trợ.
Mặc định: False
scaleString
Chế độ scale tọa độ.
Mặc định: fixed
anchorString
Neo tọa độ.
Mặc định: none
Ví dụ khởi tạo
path = [
    SwipePoint(Point(500, 1500), speed="FAST"),
    SwipePoint((560, 980), speed="NORMAL", humanized=True),
    SwipePoint(Point(500, 500))
]
swipe(path)