ScreenCapture

Điều khiển việc dùng lại ảnh chụp khi nhận diện màn hình trong lượt chạy macro hiện tại. Thông thường, một ảnh chụp có thể được dùng lại trong tối đa 100 ms. Gọi trực tiếp các phương thức trên ScreenCapture; không tạo đối tượng.

Cú pháp

ScreenCapture

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

Giá trị trả về

—

Ví dụ

# Dùng lại một khung hình đã chụp cho nhiều lần kiểm tra màn hình
ScreenCapture.cache_on()
color = Color.get(Point(500, 900))
hit = Region.full_screen().find("enemy", timeout=0)
ScreenCapture.cache_off()

# Ưu tiên frame mới nhất hiện có cho một đợt nhận diện ngắn
ScreenCapture.auto_cache_off(duration_ms=1000)
hit = Region.full_screen().find("enemy", timeout=800, rate=30)

# Tắt không hẹn giờ, sau đó chủ động bật lại cache tự động
ScreenCapture.auto_cache_off()
hit = Region.full_screen().find("enemy", timeout=2000, rate=30)
ScreenCapture.auto_cache_on()

Phương thức

4 phương thức

ScreenCapture.cache_on

Giữ một ảnh chụp màn hình để kiểm tra nhiều lần cho đến khi gọi cache_off() hoặc lượt chạy macro kết thúc. Dùng ảnh tiếp theo có sẵn, hoặc ảnh hợp lệ gần nhất nếu chưa có ảnh mới. Chế độ này được ưu tiên hơn thiết lập dùng lại ảnh tự động và không xin quyền chụp màn hình.

Cú pháp

ScreenCapture.cache_on()

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Ghim một khung hình dùng chung cho hai lượt nhận diện
ScreenCapture.cache_on()
region = Region(100, 200, 300, 400)
first = region.find("start", 0)
second = region.find("confirm", 0)
ScreenCapture.cache_off()
print(first.found, second.found)

ScreenCapture.cache_off

Ngừng giữ ảnh đã chọn bằng cache_on(). Thiết lập dùng lại ảnh tự động không đổi nên ảnh còn mới vẫn có thể được dùng lại. Gọi thêm auto_cache_off() khi mỗi lần kiểm tra cần ảnh mới nhất hiện có.

Cú pháp

ScreenCapture.cache_off()

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Bỏ ghim thủ công trước lần quét tiếp theo
ScreenCapture.cache_off()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)

ScreenCapture.auto_cache_off

Tắt dùng lại ảnh tự động để các yêu cầu chụp tìm ảnh mới nhất hiện có. Hàm trả về ngay; thời hạn bắt đầu từ lệnh gọi này và gọi lại sẽ thay thế thời hạn cũ. Áp dụng cho chụp bitmap, ảnh thô, TFLite và pixel. Việc này có thể tăng xử lý và hao pin mà không làm chạy nhanh hơn hoặc buộc Android vẽ pixel mới; thời gian chờ ảnh vẫn có giới hạn. Không hủy cache_on() hoặc xin quyền chụp màn hình.

Cú pháp

ScreenCapture.auto_cache_off(duration_ms=None)

Tham số

TênMô tả
duration_msNumber | None
Thời hạn theo số mili giây nguyên dương (100 và 100.0 đều hợp lệ). Bỏ qua hoặc dùng None để tắt đến khi gọi auto_cache_on() hoặc kết thúc lượt chạy macro. Số 0, số âm, số có phần lẻ, chuỗi, boolean và giá trị vượt giới hạn sẽ báo lỗi.
Tùy chọn · Theo vị trí hoặc tên
Mặc định: None

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Tạm bỏ qua cache tự động; ghim thủ công là thiết lập riêng
ScreenCapture.cache_off()
ScreenCapture.auto_cache_off(1000)
region = Region(100, 200, 300, 400)
print(region.find("start", 500).found)
ScreenCapture.auto_cache_on()

ScreenCapture.auto_cache_on

Cho phép dùng lại ảnh tự động ngay, hủy thời hạn tắt trước đó. Chế độ này cũng được khôi phục khi lượt chạy macro kết thúc. Không hủy cache_on(), xin quyền chụp màn hình hoặc chờ.

Cú pháp

ScreenCapture.auto_cache_on()

Giá trị trả về

None — Không có giá trị trả về.

Ví dụ

# Khôi phục việc tự động dùng lại khung hình như bình thường
ScreenCapture.auto_cache_on()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)