Touch

Quản lý các lần nhấn và vuốt song song từ script hoặc action của macro: gom nhóm, xem tiến độ, chờ hoặc hủy. Trong script, dùng click(..., parallel=True) hoặc swipe(..., parallel=True). Gửi thao tác cần bật dịch vụ Trợ năng của CogniTab.

Cú pháp

Touch

Không thể khởi tạo trực tiếp lớp này.

Giá trị trả về

—

Ví dụ

Touch.collect()
a = click(Point(300, 900), hold_ms=5000, parallel=True)
b = click(Point(780, 900), hold_ms=1000, delay_before=1000, parallel=True)
sent = Touch.send()
Touch.cancel(a)
Touch.wait()

Phương thức

7 phương thức

Touch.collect

Giữ các lệnh nhấn/vuốt tiếp theo trong script có parallel=True đến khi gọi Touch.send() để chúng có thể chạy cùng nhau. Các lời gọi khác không bị ảnh hưởng. Nếu không gom, lệnh song song được gửi ngay. Phải gọi Touch.send() trước khi script kết thúc, nếu còn thao tác chưa gửi thì script báo lỗi.

Cú pháp

Touch.collect()

Giá trị trả về

None

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Touch.send

Gửi các thao tác đã gom cùng nhau rồi tắt chế độ gom. Trả về ID dạng số theo thứ tự gom, hoặc danh sách rỗng nếu chưa gom thao tác nào. Quá 10 thao tác sẽ báo lỗi. Hàm không chờ chạy xong; dùng Touch.wait() để chờ.

Cú pháp

Touch.send()

Giá trị trả về

list[Number]

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait()

Touch.queued

Trả về trạng thái các thao tác đã gửi đang chờ chạy. Thao tác được giữ bởi Touch.collect() chỉ xuất hiện sau Touch.send().

Cú pháp

Touch.queued()

Giá trị trả về

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.queued())
Touch.wait()

Touch.active

Trả về trạng thái các thao tác đang chạy.

Cú pháp

Touch.active()

Giá trị trả về

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.active())
Touch.wait()

Touch.all

Trả về trạng thái thao tác đang chờ, đang chạy và tối đa 64 trạng thái vừa kết thúc. Không gồm thao tác chưa gửi bằng Touch.send().

Cú pháp

Touch.all()

Giá trị trả về

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
print(Touch.all())
Touch.wait()

Touch.wait

Chờ thao tác đã gửi có ID dạng số này và trả về TouchState, hoặc None nếu không có hoặc không còn lưu ID đó. Với id=None, chờ mọi thao tác đang chờ/đang chạy rồi trả về các trạng thái còn lưu, gồm cả thao tác vừa kết thúc. Cần gửi các thao tác đã gom trước khi chờ.

Cú pháp

Touch.wait(id=None)

Giá trị trả về

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
Touch.wait(first)
Touch.wait()

Touch.cancel

Hủy thao tác đã gửi đang chờ/đang chạy theo ID dạng số; trả True nếu nhận lệnh hủy, ngược lại trả False. Với id=None, hủy mọi thao tác đang chờ/đang chạy và trả về số lệnh hủy đã nhận. Hủy thao tác đang chạy cần Android 8.0+ và báo lỗi trên Android 7.x. Không hủy thao tác còn được giữ bởi Touch.collect().

Cú pháp

Touch.cancel(id=None)

Giá trị trả về

Boolean | Int

Ví dụ

# Kiểm tra hoặc điều khiển các lần chạm đã thu thập
Touch.collect()
first = click((300, 900), hold_ms=1000, parallel=True)
second = click((780, 900), delay_before=300, parallel=True)
Touch.send()
# Hủy thao tác đang chạy cần Android 8 trở lên
Touch.cancel(second)
Touch.wait()