ScreenCapture

ควบคุมการใช้ภาพจับหน้าจอซ้ำในการตรวจจับระหว่างการรันมาโครปัจจุบัน โดยปกติใช้ภาพซ้ำได้นานถึง 100 ms เรียกเมธอดผ่าน ScreenCapture โดยตรง ไม่ต้องสร้างออบเจ็กต์

รูปแบบคำสั่ง

ScreenCapture

ไม่สามารถสร้างคลาสนี้โดยตรงได้

ค่าที่ส่งกลับ

—

ตัวอย่าง

# ใช้เฟรมที่จับไว้หนึ่งเฟรมซ้ำสำหรับการตรวจหน้าจอหลายครั้ง
ScreenCapture.cache_on()
color = Color.get(Point(500, 900))
hit = Region.full_screen().find("enemy", timeout=0)
ScreenCapture.cache_off()

# ใช้เฟรมล่าสุดที่มีสำหรับการตรวจจับช่วงสั้น
ScreenCapture.auto_cache_off(duration_ms=1000)
hit = Region.full_screen().find("enemy", timeout=800, rate=30)

# ปิดโดยไม่ตั้งเวลา แล้วเรียกเปิดแคชอัตโนมัติอีกครั้ง
ScreenCapture.auto_cache_off()
hit = Region.full_screen().find("enemy", timeout=2000, rate=30)
ScreenCapture.auto_cache_on()

เมธอด

4 เมธอด

ScreenCapture.cache_on

เก็บภาพหน้าจอหนึ่งภาพไว้ตรวจซ้ำจนเรียก cache_off() หรือจบการรันมาโคร ใช้ภาพถัดไปที่มี หรือภาพล่าสุดที่ใช้ได้หากยังไม่มีภาพใหม่ โหมดนี้มีลำดับเหนือการใช้ภาพซ้ำอัตโนมัติและไม่ขอสิทธิ์จับภาพหน้าจอ

รูปแบบคำสั่ง

ScreenCapture.cache_on()

ค่าที่ส่งกลับ

None — ไม่มีค่าส่งคืน

ตัวอย่าง

# ตรึงเฟรมร่วมหนึ่งเฟรมสำหรับการตรวจจับสองรอบ
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

หยุดเก็บภาพที่เลือกด้วย cache_on() การตั้งค่าใช้ภาพซ้ำอัตโนมัติไม่เปลี่ยน จึงอาจยังใช้ภาพล่าสุดซ้ำ เรียก auto_cache_off() ด้วยหากแต่ละครั้งต้องใช้ภาพใหม่ที่สุดที่มี

รูปแบบคำสั่ง

ScreenCapture.cache_off()

ค่าที่ส่งกลับ

None — ไม่มีค่าส่งคืน

ตัวอย่าง

# ยกเลิกการตรึงเฟรมก่อนสแกนครั้งถัดไป
ScreenCapture.cache_off()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)

ScreenCapture.auto_cache_off

ปิดการใช้ภาพซ้ำอัตโนมัติเพื่อให้คำขอจับภาพหาภาพล่าสุดที่มี คืนค่าทันที ระยะเวลาเริ่มจากการเรียกนี้และเรียกซ้ำจะเปลี่ยนระยะเวลาเดิม ใช้กับ bitmap ภาพดิบ TFLite และพิกเซล อาจเพิ่มการประมวลผลและใช้แบตเตอรี่มากขึ้นโดยไม่ทำงานเร็วขึ้นหรือบังคับ Android วาดพิกเซลใหม่ การรอภาพยังมีขีดจำกัด ไม่ยกเลิก cache_on() หรือขอสิทธิ์จับภาพ

รูปแบบคำสั่ง

ScreenCapture.auto_cache_off(duration_ms=None)

พารามิเตอร์

ชื่อคำอธิบาย
duration_msNumber | None
ระยะเวลาเป็นจำนวนเต็มบวกหน่วยมิลลิวินาที (100 และ 100.0 ใช้ได้) ละไว้หรือใช้ None เพื่อปิดจนเรียก auto_cache_on() หรือจบมาโคร ค่า 0 ค่าลบ เศษส่วน สตริง boolean และค่าเกินขอบเขตจะเกิดข้อผิดพลาด
ไม่บังคับ · ระบุตามตำแหน่งหรือชื่อ
ค่าเริ่มต้น: None

ค่าที่ส่งกลับ

None — ไม่มีค่าส่งคืน

ตัวอย่าง

# ข้ามแคชอัตโนมัติชั่วคราว การตรึงเฟรมเป็นอีกการตั้งค่าหนึ่ง
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

เปิดให้ใช้ภาพซ้ำอัตโนมัติทันที และยกเลิกช่วงปิดเดิม เมื่อจบการรันมาโครจะคืนโหมดนี้ด้วย ไม่ยกเลิก cache_on() ไม่ขอสิทธิ์จับภาพ และไม่รอ

รูปแบบคำสั่ง

ScreenCapture.auto_cache_on()

ค่าที่ส่งกลับ

None — ไม่มีค่าส่งคืน

ตัวอย่าง

# คืนค่าการใช้เฟรมซ้ำอัตโนมัติตามปกติ
ScreenCapture.auto_cache_on()
region = Region(100, 200, 300, 400)
print(region.find("start", 0).found)