backend.loop

loop

类：

名称	描述
LoopAction
Loop

LoopAction

方法：

名称	描述
reset	重置 LoopAction，以复用此对象。
do	执行 LoopAction。
click	点击寻找结果。若结果为空，会跳过执行。

属性：

名称	类型	描述
found		是否找到结果。若父 Loop 未在运行中，则返回 False。

found property

found

是否找到结果。若父 Loop 未在运行中，则返回 False。

reset

reset()

重置 LoopAction，以复用此对象。

do

do()

执行 LoopAction。

返回：

类型	描述
	执行结果。

click

click(*, at: tuple[int, int] | None = None)

点击寻找结果。若结果为空，会跳过执行。

返回：

类型	描述

Loop

方法：

名称	描述
exit	结束循环。
when	判断某个条件是否成立。
until	当满足指定条件时，结束循环。
click_if	检测指定对象是否出现，若出现，点击该对象或指定位置。

属性：

名称	类型	描述
auto_screenshot		是否在每次循环开始时（Loop.tick() 被调用时）截图。
interval		每次循环后等待的时间。
screenshot	MatLike | None	上次截图时的图像数据。

auto_screenshot instance-attribute

auto_screenshot = auto_screenshot

是否在每次循环开始时（Loop.tick() 被调用时）截图。

interval instance-attribute

interval = interval

每次循环后等待的时间。

screenshot instance-attribute

screenshot: MatLike | None = None

上次截图时的图像数据。

exit

exit()

结束循环。

when

when(condition: Image) -> LoopAction

when(condition: TextComparator) -> LoopAction

when(condition: Any)

判断某个条件是否成立。

参数：

名称	类型	描述	默认
condition	Any		必需

返回：

类型	描述

until

until(condition: Any)

当满足指定条件时，结束循环。

等价于 loop.when(...).call(lambda _: loop.exit())

click_if

click_if(condition: Any, *, at: tuple[int, int] | None = None)

检测指定对象是否出现，若出现，点击该对象或指定位置。

click_if() 等价于 loop.when(...).click(...)。

参数：

名称	类型	描述	默认
condition	Any	检测目标。	必需
at	tuple[int, int] | None	点击位置。若为 None，表示点击找到的目标。	None