Helper tĩnh cho các click/swipe chạy song song được tạo bởi UI hoặc code click(..., parallel=True), swipe(..., parallel=True).
Cú pháp
Touch
Không thể khởi tạo trực tiếp lớp này.
Tham số
Không có
Giá trị trả về
—
Hành vi / tác động
Helper tĩnh cho các click/swipe chạy song song được tạo bởi UI hoặc code click(..., parallel=True), swipe(..., parallel=True). Bạn có thể gom các click/swipe lại rồi gửi một lượt, hoặc lấy thông tin về các click/swipe đang nhấn/đang chờ. Helper cũng cung cấp khả năng huỷ click/swipe đang hoạt động (chỉ hoạt động đối với Android 8.0+).
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
Cử chỉ Android dùng chung thiết bị. parallel=True xếp hàng id chạm nhưng delay_before và delay_after vẫn chặn luồng gọi ngoài collect. Trong collect, các lần chạm được gom để Touch.send(); Touch.wait() chờ chúng hoàn tất.
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()
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.
Bật chế độ gom click/swipe có parallel = True. Khi bật, các click/swipe song song sẽ không được gửi đi luôn mà các click/swipe sẽ được gom lại, và chỉ gửi đi sau lệnh Touch.send(). Phương thức này hoạt động đối với cả UI/code. Nếu không bật Touch.collect() thì các click/swipe song song sẽ được gửi đi ngay lập tức, các click/swipe gửi sau sẽ phải chờ click/swipe trước đó chạy xong thì mới có thể hoạt động (tại vì nếu click/swipe gửi sau mà hoạt động luôn thì sẽ khiến click/swipe trước đó bị huỷ, bạn có thể chủ động huỷ click/swipe trước đó bằng Touch.cancel())
Thực thi
Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
collect/send và truy vấn trạng thái chạm không chờ cử chỉ hoàn tất. Lệnh đã gom chỉ đến executor khi Touch.send(); snapshot hàng đợi có thể đổi ngay.
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()
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.
Gửi tất cả các click/swipe đã được collect cùng một lúc, trả về các id dạng số tương ứng, rồi tắt chế độ gom của Touch.collect().
Cú pháp
Touch.send()
Tham số
Không có
Giá trị trả về
list[Number]
Hành vi / tác động
Gửi tất cả các click/swipe đã được collect cùng một lúc, trả về các id dạng số tương ứng, rồi tắt chế độ gom của Touch.collect().
Thực thi
Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
collect/send và truy vấn trạng thái chạm không chờ cử chỉ hoàn tất. Lệnh đã gom chỉ đến executor khi Touch.send(); snapshot hàng đợi có thể đổi ngay.
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()
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.
collect/send và truy vấn trạng thái chạm không chờ cử chỉ hoàn tất. Lệnh đã gom chỉ đến executor khi Touch.send(); snapshot hàng đợi có thể đổi ngay.
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()
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.
collect/send và truy vấn trạng thái chạm không chờ cử chỉ hoàn tất. Lệnh đã gom chỉ đến executor khi Touch.send(); snapshot hàng đợi có thể đổi ngay.
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()
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.
Trả về touch gần đây và touch đang nằm trong hàng đợi hoặc đang chạy.
Cú pháp
Touch.all()
Tham số
Không có
Giá trị trả về
list[TouchState]
Hành vi / tác động
Trả về touch gần đây và touch đang nằm trong hàng đợi hoặc đang chạy.
Thực thi
Chờ hoàn tất: Không
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
collect/send và truy vấn trạng thái chạm không chờ cử chỉ hoàn tất. Lệnh đã gom chỉ đến executor khi Touch.send(); snapshot hàng đợi có thể đổi ngay.
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()
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.
Chờ một id dạng số, hoặc chờ mọi touch trong hàng đợi/đang chạy khi id là None.
Cú pháp
Touch.wait(id=None)
Tham số
Không có
Giá trị trả về
TouchState | list[TouchState]
Hành vi / tác động
Chờ một id dạng số, hoặc chờ mọi touch trong hàng đợi/đang chạy khi id là None.
Thực thi
Chờ hoàn tất: Có
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
Chờ trong luồng gọi đến hết thời gian yêu cầu hoặc hoàn tất chạm. Luồng khác có thể tiếp tục; pause và stop vẫn có hiệu lực.
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()
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.
Hủy một touch đang queue hoặc active theo id dạng số.
Cú pháp
Touch.cancel(id=None)
Tham số
Không có
Giá trị trả về
Boolean | Int
Hành vi / tác động
Hủy một touch đang queue hoặc active theo id dạng số. Khi id là None, hủy mọi touch đang queue/active và trả về số lệnh hủy đã nhận. Hủy touch active cần Android 8.0+; trên Android 7.x, script sẽ lỗi rõ ràng nếu nhắm tới touch đang active.
Thực thi
Chờ hoàn tất: Tùy điều kiện
An toàn khi chạy đồng thời: Có giới hạn
Chạy song song: Tùy điều kiện
Cử chỉ Android dùng chung thiết bị. parallel=True xếp hàng id chạm nhưng delay_before và delay_after vẫn chặn luồng gọi ngoài collect. Trong collect, các lần chạm được gom để Touch.send(); Touch.wait() chờ chúng hoàn tất.
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()
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.
