xbot.win32.screensaver
概述
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":5985023
}
}
- "bounding"屏保区域设置
- left: 位置横坐标
- top: 位置纵坐标
- width: 区域宽度
- height: 区域高度
- background: 屏保背景设置
- color: 背景色
- opacity: 背景色透明度
- blur: 是否使用毛玻璃效果
font: 屏保默认显示文子样式设置
- family: 字体
- size: 字号
- style: 字型
- weight: 粗细
- foreground: 字色
default_text：影刀屏保被唤起时显示的默认文字
返回值
- 无
示例1
唤起影刀屏保，使用屏保默认设置，屏保在显示器上显示3s后消失
from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver()
sleep(3)
pass
示例2
唤起屏幕保护，使用屏保默认设置，并设置自定义的屏保默认显示文字，屏保在显示器上显示3s后消失
from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
sleep(3)
pass
示例3
唤起屏幕保护，自定义屏保及屏保默认显示文本样式，屏保在显示器上显示3s后消失
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)
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
唤起默认唤起屏幕保护，并在屏保上添加文本"结束重复工作 释放创意潜能"，屏保在显示器上显示3s后消失
from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能")
sleep(3)
pass
示例2
唤起默认唤起屏幕保护，在屏保上添加文本"结束重复工作 释放创意潜能"，并未新添加的文本设置样式。屏保在显示器上显示3s后消失
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)
pass
clear
清空屏保提示
clear()
参数
- 无
返回值
- 无
示例
唤起默认唤起屏幕保护，连续在屏保上添加两次"结束重复工作 释放创意潜能"文字，显示2s后清空屏保所有文字，之后屏保在显示器上显示3s后消失
from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能")
win32.screensaver.append_screen_saver_text("结束重复工作 释放创意潜能")
sleep(2)
win32.screensaver.clear()
sleep(3)
pass
close
关闭屏幕保护
close()
参数
- 无
返回值
- 无
示例
唤起默认唤起屏幕保护，显示2s关闭影刀屏保
from xbot import win32,sleep
def main(args):
win32.screensaver.open_screen_saver(default_text="影刀正在帮你完成工作 让鼠标休息会儿...")
sleep(2)
win32.screensaver.close()
pass