如何使用Swift在MacOS中创建全屏覆盖层？

问题描述 #

有一款名为Intermission的应用可创建覆盖整个屏幕（包括顶部菜单栏）的全屏覆盖层。我尝试用NSPanel制作浮动面板，但它无法扩展到顶部菜单栏/程序栏之外。我不想通过全屏模式的新窗口实现，希望直接在屏幕上方绘制该覆盖层，请问该如何实现？

实现方案 #

核心是使用NSWindow而非NSPanel，通过配置窗口的样式、层级和属性，实现无限制的全屏覆盖：

1. 创建全屏无边框窗口

初始化窗口时直接使用主屏幕的完整尺寸，同时设置无边框、全屏内容视图的样式掩码：

let screenFrame = NSScreen.main!.frame
let overlayWindow = NSWindow(
    contentRect: screenFrame,
    styleMask: [.borderless, .fullSizeContentView],
    backing: .buffered,
    defer: false
)

2. 设置窗口层级，覆盖菜单栏

将窗口层级设为比状态栏更高，确保能覆盖顶部菜单栏：

overlayWindow.level = .statusBar + 1

3. 配置窗口视觉属性

根据需求设置背景色、透明度，可选去掉阴影让覆盖层更简洁：

// 示例：半透明黑色背景，类似Intermission的遮罩效果
overlayWindow.backgroundColor = NSColor.black.withAlphaComponent(0.8)
overlayWindow.isOpaque = false
overlayWindow.hasShadow = false

4. 控制窗口交互行为

• 如果需要阻止用户操作覆盖层下方的内容，保持窗口可成为焦点：

  overlayWindow.canBecomeKeyWindow = true
  overlayWindow.canBecomeMainWindow = true
  

• 如果希望覆盖层仅作展示，不抢夺焦点：

  overlayWindow.canBecomeKeyWindow = false
  overlayWindow.canBecomeMainWindow = false
  

5. 显示覆盖层窗口

最后将窗口显示出来，并添加自定义内容视图：

overlayWindow.makeKeyAndOrderFront(nil)
// 将你的自定义覆盖层视图赋值给窗口内容视图
overlayWindow.contentView = yourCustomOverlayView

关键说明 #

NSPanel受系统面板类的行为约束，默认层级低于状态栏，无法覆盖顶部菜单栏，因此改用NSWindow是实现该需求的正确路径。

内容的提问来源于stack exchange，提问作者kirtan-shah