Chạy song song các luồng macro có tên và gửi tin nhắn giữa chúng. Mỗi luồng có biến riêng. Truyền dữ liệu ban đầu qua Flow.params; tin nhắn là bản sao độc lập, được đọc theo thứ tự gửi.
Cú pháp
Flow
Không thể khởi tạo trực tiếp lớp này.
Giá trị trả về
—
Ví dụ
# Lưu template enemy và cấu hình watch_enemy trước khi chạy
# Main: kích hoạt watcher rồi dừng sau tác vụ chính
Flow.start("watch_enemy")
Flow.send("watch_enemy", {"command": "ARM"})
wait(1000)
Flow.stop("watch_enemy")
Dữ liệu ban đầu của luồng này. Mỗi lần đọc trả một dict độc lập; sửa dict đó không đổi dữ liệu bên gửi hoặc các lần đọc sau. Luồng chính nhận dict rỗng.
Phương thức
6 phương thức
Flow.start
Static Method
Khởi chạy luồng đã cấu hình song song với luồng chính. Có thể gửi tin ngay khi lời gọi trả về. Tối đa hai luồng nền cùng chạy; chúng cũng có thể khởi chạy luồng khác.
Một tên không thể chạy hai lần, kể cả khi đang tạm dừng hoặc đang dừng. Tên sai hoặc trùng, đủ số luồng nền, hoặc lỗi trong luồng sẽ dừng toàn bộ lượt chạy. System.stop() và Main Stop cũng dừng mọi luồng.
Luồng chính chờ các luồng nền trước khi kết thúc lượt chạy: cần chủ động dừng luồng chạy vô hạn. Dữ liệu ban đầu được sao chép theo giới hạn của Flow.send().
Dữ liệu ban đầu tùy chọn được sao chép cho luồng mới và đọc qua Flow.params.
Tùy chọn · Theo vị trí hoặc tên
Mặc định:None
Giá trị trả về
Int — Số dương tăng theo mỗi lần khởi chạy, dùng trong trạng thái dock và nhật ký. Không thể dùng số này để điều khiển luồng.
Ví dụ
# Khởi chạy nhận diện và telemetry cùng main flow
recognition_no = Flow.start("recognition", {"region": "arena", "threshold": 0.86})
telemetry_no = Flow.start("telemetry")
# Trong flow nhận diện đã cấu hình, đọc input đã sao chép của nhánh này
region_name = Flow.params.get("region", "full_screen")
threshold = Flow.params.get("threshold", 0.8)
Flow.send
Static Method
Gửi bản sao độc lập đến luồng đang chạy mà không chờ. Nhiều luồng có thể gửi tin an toàn; tin được nhận theo thứ tự gửi, kể cả khi tạm dừng. Giá trị được phép gồm None, Boolean, số hữu hạn, String, list, tuple và dict có khóa String. Độ sâu lồng tối đa là 8, tổng số giá trị là 512 và tổng độ dài văn bản là 65536. Hàm, đối tượng tài nguyên hoặc của app và tham chiếu vòng gây lỗi. Mỗi lần khởi chạy có hàng đợi tin mới; tin chưa đọc bị bỏ khi luồng dừng hoặc kết thúc.
Tên chính xác đã cấu hình của luồng đích. Luồng chính không có tên được tự động gán.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
dataAny
Giá trị cần gửi. Giá trị được sao chép trước khi thêm vào hàng đợi tin.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
Giá trị trả về
Boolean — True nếu được chấp nhận; False khi đích không xác định, không hoạt động hoặc đang dừng.
Ví dụ
# Gửi lệnh ARM cho watcher đã cấu hình
Flow.start("watch_enemy")
accepted = Flow.send("watch_enemy", {"command": "ARM"})
print(accepted)
Flow.receive
Static Method
Chờ và lấy tin cũ nhất của luồng này. Luồng chính và các luồng nền đều nhận được tin. Nhóm có tên chạy lồng trong cùng luồng dùng chung hàng đợi của luồng đó.
Hủy sẽ kết thúc chờ nhanh chóng; Pause giữ các tin trong hàng đợi. List và dict nhận được là bản sao độc lập.
Cú pháp
Flow.receive(timeout=None)
Tham số
Tên
Mô tả
timeoutNumber?
Thời gian chờ tùy chọn là số hữu hạn tính bằng mili giây: 0 <= timeout < 2^63. Phần lẻ mili giây bị bỏ; None chờ vô hạn, 0 kiểm tra ngay.
Tùy chọn · Theo vị trí hoặc tên
Mặc định:None
Giá trị trả về
Any? — Tin cũ nhất, hoặc None khi hết thời gian chờ hay kiểm tra ngay không thấy tin. Tin chứa None cũng trả về None.
Ví dụ
# Luồng watch_enemy đã cấu hình: chờ ARM rồi kiểm tra lệnh giữa các lượt xử lý
message = Flow.receive()
if message is not None and message.get("command") == "ARM":
while True:
command = Flow.poll()
if command is not None:
print(command)
if Region().find("enemy", timeout=0).found:
print("enemy")
wait(100)
Flow.poll
Static Method
Lấy ngay tin cũ nhất của luồng này mà không chờ. Dùng cùng hàng đợi tin và bản sao độc lập như Flow.receive().
Cú pháp
Flow.poll()
Giá trị trả về
Any? — Tin cũ nhất, hoặc None khi không có tin. Tin chứa None cũng trả về None.
Ví dụ
# Kiểm tra lệnh mà không chờ
message = Flow.poll()
if message is not None:
print(message)
Flow.running
Static Method
Kiểm tra luồng có tên này đang chạy hoặc tạm dừng. Kết quả có thể thay đổi ngay sau lời gọi.
Tên chính xác đã cấu hình của luồng đích. Luồng chính không có tên được tự động gán.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
Giá trị trả về
Boolean — True khi còn hoạt động; False khi không xác định, đang dừng hoặc đã kết thúc.
Ví dụ
print(Flow.running("watch_enemy"))
Flow.stop
Static Method
Yêu cầu dừng một luồng nền; trả về mà không chờ dọn dẹp. Luồng chính và các luồng khác vẫn chạy. Không thể dùng hàm này để dừng luồng chính. Tự dừng sẽ kết thúc luồng gọi.
Với nhóm có tên chạy lồng, dừng luồng nền chứa nhóm đó. Chờ dọn dẹp xong trước khi chạy lại cùng tên.
Dock luồng nền có Pause/Resume. Main Pause/Resume tác động mọi luồng; Main Resume cũng xóa trạng thái tạm dừng riêng của chúng.