全局函数 T

T.jobRegister

注册任务

参数	类型	默认	说明
func	callable		函数
cronjob	string		执行计划
enable	bool		是否启用

# 注册 unname 函数，并循环执行，并启用
def unname(ctx):
    T.log("hello world")

T.jobRegister(unname, cronjob="*", enable=True)

T.click

点击

参数	类型	默认	说明
x	int		为横向偏移左至右计算
y	int		为纵向偏移上至下计算
unit	px 像素 % 百分比	px	单位

单位为 % 时，xy 取值范围：(0, 100)。使用 %，能避免获取像素的复杂

# 像素
T.click(111, 222, unit="px")
# 百分百
T.click(33, 44, unit="%")
# 快捷的
T.click(111, 222)
# 完整的
T.click(x=33, y=44, unit="%")

T.clickByImg

点击图片

参数	类型	默认	说明
src	string		图片文件名，图片保存在脚本文件目录下，为文件别名
crop	dict	None	指定范围 "unit": "%" "x": 10 指从左10%开始 "y": 10 指从上10%开始 "width": 30 指宽度30% "height": 40 指高度40% 表示为：从左10%到40%，从上10%到50%范围内

# 快捷的
T.clickByImg("test.png")
T.clickByImg(src="test.png")
# 限制范围的
T.clickByImg(src="test.png", crop={"unit": "%", "x": 10, "y": 10, "width": 30, "height": 40})

T.clickByText

点击文字

参数	类型	默认	说明
search	string		默认局部，即一段字里有包含该字符串的就行 "^百度" 必须以百度开头 "一下$" 必须以一下结尾 "我.你" 点表示任意字符，能匹配：我爱你，我恨你，我x你
crop	dict	None	搜索区域，同 T.clickByImg / corp

# 快捷的
T.clickByText("鱼")
T.clickByText(search="鱼")
T.clickByText(search="我.你")
# 限制范围的
T.clickByText(search="鱼", crop={"unit": "%", "x": 0, "y": 0, "width": 20, "height": 30})

T.drag

拖拽

参数	类型	默认	说明
points	List[tuple]		一组点，至少2个点，才能形成线 2个时为，起点 + 终点
unit	px 像素 % 百分比	px	单位
duration	float	0.5	整体用时，秒

# 0.5秒 横着拖一小点
x, y = random.randint(20, 60), random.randint(20, 60)
T.drag([(x, y), (x + 5, y + 1)], unit="%", duration=0.5)

# 2秒 画个 正方形
T.drag(
    [
        (x, y),
        (x + 100, y),
        (x + 100, y + 100),
        (x, y + 100),
        (x, y),
    ],
    unit="px",
    duration=2,
)

# 2秒 画个 三角形
T.drag(
    [
        (x, y),
        (x + 100, y + 100),
        (x - 50, y + 150),
        (x, y),
    ],
    unit="px",
    duration=2,
)

T.key

键入

参数	类型	默认	说明
text	string		键盘上的按键，可以组合，并多个
gap	float	0.05	停顿时间，用于防检测

# 输入 q
T.key("q")
# 依次输入 q w e r
T.key("q", "w", "e", "r")
# 每0.5秒，依次输入 q w e r
T.key("q", "w", "e", "r", gap=0.5)

T.input

输入一段字

参数	类型	默认	说明
text	string		复制粘贴一段字

# 直接输入一段字
T.input("床前明月光")

T.sleep

停顿等待

参数	类型	默认	说明
seconds	float		单位秒

# 等 2 秒
T.sleep(2)
# 等 0.5 秒
T.sleep(seconds=0.5)