Linux环境Zoom无法共享XCreateSimpleWindow创建的简易X11窗口

直接调用XCreateSimpleWindow()生成的是未经过窗口管理器托管的裸窗口，缺失X11 EWMH（扩展窗口管理器规范）要求的标准窗口属性。Zoom枚举可共享窗口时完全遵循EWMH规范过滤窗口，不符合要求的窗口会被直接排除在共享列表外。
你提到的“共享屏幕区域”功能可正常选中该窗口，是因为该逻辑直接读取X11帧缓冲的指定像素区域，不依赖窗口属性枚举，不受窗口属性缺失影响。

• 必须持有WM_STATE属性，这是窗口被窗口管理器正式托管的核心标记，裸窗口默认无该属性，会被Zoom直接跳过。
• 必须正确设置_NET_WM_WINDOW_TYPE属性，普通顶层应用窗口需将该值设为_NET_WM_WINDOW_TYPE_NORMAL，如果留空或设为tooltip、dock、desktop、splash等特殊窗口类型，会被Zoom判定为非用户主窗口过滤掉。
• 必须设置有效窗口标题，即存在WM_NAME（ASCII标题）或_NET_WM_NAME（UTF-8标题）属性，部分版本Zoom会直接跳过无标题窗口。
• 窗口不能开启override_redirect标志，开启该标志的窗口会完全绕过窗口管理器托管，不会进入Zoom的窗口枚举列表。
• 窗口的_NET_WM_STATE属性不能携带_NET_WM_STATE_SKIP_TASKBAR、_NET_WM_STATE_SKIP_PAGER标记，带这两个标记的窗口会被判定为后台辅助窗口，被Zoom过滤。

不需要单独向Gnome桌面环境做额外注册，只要按EWMH规范设置窗口属性，让窗口被窗口管理器正常托管即可，具体操作步骤：

1. 创建窗口时不要开启override_redirect：调用XCreateSimpleWindow()时不要传入CWOverrideRedirect掩码，创建后也不要手动将该属性设为True。
2. 调用XMapWindow()映射窗口前，先设置_NET_WM_WINDOW_TYPE属性，参考代码：

   Atom net_wm_type = XInternAtom(display, "_NET_WM_WINDOW_TYPE", False);
   Atom net_wm_type_normal = XInternAtom(display, "_NET_WM_WINDOW_TYPE_NORMAL", False);
   XChangeProperty(display, target_win, net_wm_type, XA_ATOM, 32, PropModeReplace, (unsigned char*)&net_wm_type_normal, 1);
   

3. 为窗口设置有效标题，可直接调用XStoreName(display, target_win, "你的应用窗口名称")设置ASCII标题，需要支持UTF-8标题则额外设置_NET_WM_NAME属性。
4. 窗口映射后等待窗口管理器完成托管流程，即等待窗口首次收到WM_STATE属性变更事件后，窗口才会进入可被枚举的状态。

不需要为窗口共享实现特殊事件逻辑，只要满足基础X11窗口的事件响应要求即可：

• 正常处理Expose事件，保证窗口内容可以正常绘制输出
• 正常响应ConfigureNotify事件，处理窗口移动、尺寸调整的逻辑
• 不要让窗口处于完全无响应的卡死状态，部分版本Zoom会跳过长时间无响应的窗口

属性设置完成后，可在终端执行xprop命令点击目标窗口，查询输出内容确认：

• 存在WM_STATE字段
• _NET_WM_WINDOW_TYPE字段值包含_NET_WM_WINDOW_TYPE_NORMAL
• 存在有效WM_NAME或_NET_WM_NAME字段
  确认以上信息后重启Zoom，即可在共享窗口列表中看到该窗口。

内容的提问来源于stack exchange，提问作者Ralf