如何在 Wayland 上使用 Python 捕获任何窗口的屏幕截图？

Question

对于上下文，我有一个 PyQt5 小部件，带有一个按钮，让我选择要捕获的屏幕区域。我可以使用

pillow

和

mss

来捕获 X11 上的内容，就像这样

def take_screenshot(self, x1, y1, x2, y2):
    with mss.mss() as sct:
        monitor = {"top": y1, "left": x1, "width": x2 - x1, "height": y2 - y1}
        sct_img = sct.grab(monitor)
        img = Image.frombytes("RGB", sct_img.size, sct_img.bgra, "raw", "BGRX")
        img.save("screenshot.png")
        print("Screenshot saved as screenshot.png")

但是在 Wayland 上尝试时，我收到一个关于

XGetImage()

的错误

mss.exception.ScreenShotError: XGetImage() failed

我也尝试过这样做

def take_screenshot(self, x1, y1, x2, y2):
    # Ensure x1 < x2 and y1 < y2
    x1, x2 = min(x1, x2), max(x1, x2)
    y1, y2 = min(y1, y2), max(y1, y2)
    
    screen = QApplication.primaryScreen()
    screenshot = screen.grabWindow(0, x1, y1, x2 - x1, y2 - y1)
    screenshot.save("screenshot.png", "png")
    print("Screenshot saved as screenshot.png")

但这只会导致黑屏捕获，据我所知，这是因为 Wayland 具有安全功能，可以明确防止从一个窗口捕获内容到下一个窗口

有一些我可以使用的Python 库吗？作为最终解决方案，我可以使用

gnome-screenshot

或一些类似物从子流程中截取屏幕截图，但我想让事情尽可能简单

Answer 1

目前（2024 年 7 月），Wayland 上没有像 X11 那样独特、通用且可靠的方法来捕获屏幕区域，因为这取决于合成器和配置。

pillow 和 Qt 都有相关报告的问题尚未解决。

尽管已经快 15 岁了，但 Wayland 上还没有通用的屏幕捕获协议。
这两个项目的政策是提供一个在每个系统上透明且一致地工作的 API，因此这种情况可能会在相当长的一段时间内保持不变（我的预测是，这种情况至少在一年内，也许更长时间内不会发生） ，直到 Wayland 最终可以使用通用接口。