如何使用python获取电脑的空闲时长(idle time)?
Python读取系统原生空闲时长的实现方案
系统记录的空闲时长(即最后一次键盘、鼠标物理输入操作到当前的间隔值),Python可以直接通过调用各系统的原生接口读取,不需要自行全局监控输入事件,读取到的数值和系统屏保、自动锁屏的判断数据源完全一致,具体实现按平台区分如下:
Windows 平台实现
- 无需安装第三方依赖,直接通过ctypes调用user32.dll提供的
GetLastInputInfo系统接口,该接口就是Windows系统屏保判断的原生数据源,示例代码:
import ctypes class LASTINPUTINFO(ctypes.Structure): _fields_ = [ ("cbSize", ctypes.c_uint), ("dwTime", ctypes.c_uint) ] def get_idle_seconds(): last_input_info = LASTINPUTINFO() last_input_info.cbSize = ctypes.sizeof(last_input_info) ctypes.windll.user32.GetLastInputInfo(ctypes.byref(last_input_info)) current_tick = ctypes.windll.kernel32.GetTickCount() return (current_tick - last_input_info.dwTime) / 1000.0
返回值为以秒为单位的空闲时长
macOS 平台实现
- 基于Quartz图形框架的HID事件源接口获取空闲时长,需要先安装
pyobjc-framework-Quartz依赖,该接口和macOS自动锁屏、屏保的判断逻辑同源,示例代码:
from Quartz import CGEventSourceSecondsSinceLastEventType, kCGEventSourceStateHIDSystemState def get_idle_seconds(): # 传入全事件类型参数,即匹配所有键盘、鼠标输入事件 return CGEventSourceSecondsSinceLastEventType(kCGEventSourceStateHIDSystemState, 0xFFFFFFFF)
返回值为以秒为单位的空闲时长
Linux 平台实现(X11会话)
- 基于X11协议的XScreenSaver扩展接口获取空闲时长,通过ctypes加载系统自带的X11、Xss动态库实现,无需安装Python第三方库,示例代码:
import ctypes import ctypes.util def get_idle_seconds(): x11_lib = ctypes.cdll.LoadLibrary(ctypes.util.find_library("X11")) xss_lib = ctypes.cdll.LoadLibrary(ctypes.util.find_library("Xss")) # 建立和当前X11显示服务的连接 display = x11_lib.XOpenDisplay(None) screen_info = ctypes.create_string_buffer(32) root_window = x11_lib.XDefaultRootWindow(display) xss_lib.XScreenSaverQueryInfo(display, root_window, screen_info) # 从返回的结构体中读取空闲时间字段(单位为毫秒) idle_millis = ctypes.cast(screen_info, ctypes.POINTER(ctypes.c_ulong))[2] x11_lib.XCloseDisplay(display) return idle_millis / 1000.0
注意:Wayland会话下受沙箱隔离限制,无法通过通用接口全局读取空闲时长,需要匹配对应桌面环境的权限申请规则
跨平台兼容简化方案
如果不想单独处理各平台的接口适配逻辑,可以使用封装好的开源跨平台空闲时长读取工具库,这类库的内部实现就是整合了上述三个系统的原生接口调用逻辑,只需要一次调用就可以返回当前系统的空闲时长,不需要自行编写平台判断逻辑。
内容的提问来源于stack exchange,提问作者Albert
相关产品推荐
相关产品推荐

