You need to enable JavaScript to run this app. 如何使用python获取电脑的空闲时长(idle time)?
优惠活动
大模型
产品
解决方案
定价
更多

如何使用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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.14 02:54:00