Flow

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")

Thuộc tính

TênMô tả
paramsdict
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

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().

Cú pháp

Flow.start(name, params=None)

Tham số

TênMô tả
nameString
Tên chính xác của luồng đã cấu hình.
Bắt buộc · Theo vị trí hoặc tên
Không có giá trị mặc định
paramsdict?
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

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.

Cú pháp

Flow.send(name, data)

Tham số

TênMô tả
nameString
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

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ênMô 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

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

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.

Cú pháp

Flow.running(name)

Tham số

TênMô tả
nameString
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

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.

Cú pháp

Flow.stop(name)

Tham số

TênMô tả
nameString
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 vừa yêu cầu dừng; False khi đích vắng mặt, không xác định, đã đang dừng hoặc thuộc main. True không xác nhận đã dọn dẹp xong.

Ví dụ

print(Flow.stop("watch_enemy"))