帮助中心
快速寻找答案
首页>帮助手册>

xbot.win32.screensaver

描述:主要操作屏幕保护,屏保可用于遮盖屏幕或在屏幕上显示自定义文字。包括唤起、关闭影刀屏保,设置、清空屏保显示文字等

方法

open_screen_saver()

唤起屏幕保护

open_screen_saver( settings = None, default_text = None )

参数

settings:自定义屏保配置json(可在可视化'唤起屏幕保护'指令编辑界面直接复制), json包含屏保和屏保默认显示文字配置, json结构如下:

{
"bounding":{
"left":0,
"top":0,
"width":0,
"height":0
},
"background":{
"color":16777215,
"opacity":0.1
},
"blur":true,
"font":{
"family":"微软雅黑",
"size":48,
"style":"normal",
"weight":450,
"foreground":59850237
}
}
  • "bounding":屏保区域设置,可配置 "left"(位置横坐标)、"top"(位置纵坐标)、"width"(区域宽度)、"height"(区域高度)

  • "background":屏保背景设置,可以配置的参数为"color"(背景色)、"opacity"(背景色透明度)

  • "blur":是否使用毛玻璃效果

  • "font":屏保默认显示文子样式设置,可配置 family(字体)、size(字号)、style(字型)、weight(粗细)、foreground(字色)

default_text:影刀屏保被唤起时显示的默认文字,默认值为None

返回值

示例1

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver()
sleep(3)

该示例执行逻辑: 唤起影刀屏保,使用屏保默认设置,屏保在显示器上显示3s后消失

示例2

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
sleep(3)

该示例执行逻辑: 唤起屏幕保护,使用屏保默认设置,并设置自定义的屏保默认显示文字 "影刀正在帮你完成工作 让鼠标休息会儿..." ,屏保在显示器上显示 3s 后消失

示例3

from xbot import win32
def main(args):
win32.screensaver.open_screen_saver(
settings={
"bounding": {
"left": 256.0,
"top": 0.0,
"width": 1024.0,
"height": 172.0
},
"background": {
"color": 16777215,
"opacity": 0.1
},
"blur": True,
"font": {
"family": "微软雅黑",
"size": 48.0,
"style": "normal",
"weight": 450,
"foreground": 5985023
}
},
default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
sleep(3)

该示例执行逻辑: 唤起屏幕保护,自定义屏保及屏保默认显示文本样式,屏保在显示器上显示3s后消失

append_screen_saver_text()

设置屏保提示

*append_screen_saver_text(text, , settings = None)

输入参数

text:设置影刀屏保显示文字

settings:对屏保文字进行自定义显示设置的json串(可在可视化'设置屏保提示'指令便捷界面直接复制), json结构如下:

{
"family":"微软雅黑",
"size":48,
"style":"normal",
"weight":450,
"foreground":5985023
}
  • settings json 解释
    参数解释
    family字体
    size字号
    style字型
    weight粗细
    foreground字色

返回值

示例1

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver()
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能")
sleep(3)

该示例执行逻辑: 唤起默认唤起屏幕保护,并在屏保上添加文本"结束重复工作 释放创意潜能",屏保在显示器上显示3s后消失

示例2

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能",
settings={
"family": "Dubai Medium",
"size": 33,
"style": "normal",
"weight": 761,
"foreground": 255
})
sleep(3)

该示例执行逻辑: 唤起默认唤起屏幕保护,在屏保上添加文本"结束重复工作 释放创意潜能",并未新添加的文本设置样式。屏保在显示器上显示 3s 后消失

clear()

清空屏保提示

clear()

输入参数

返回值

示例

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver()
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能")
sleep(2)
win32.screensaver.clear()
sleep(3)

该示例执行逻辑: 唤起默认唤起屏幕保护,连续在屏保上添加两次"结束重复工作 释放创意潜能"文字,显示 2s 后清空屏保所有文字,之后屏保在显示器上显示 3s 后消失

close()

关闭屏幕保护

close()

输入参数

返回值

示例

from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver()
sleep(2)
win32.screensaver.close()

该示例执行逻辑: 唤起默认唤起屏幕保护,显示 2s 关闭影刀屏保

问题没有解决?去社区提问