HarmonyOS鸿蒙Next中PC端AVScreenCapture窗口录制有黑色背景

HarmonyOS鸿蒙Next中PC端AVScreenCapture窗口录制有黑色背景 环境：

鸿蒙 pc 端，使用 c++ api ，通过鸿蒙接口拿到录屏后的图像数据，自行编码压缩写文件。

现象：

录制窗口时，录制出来的结果除了窗口，还有黑色的背景，如图所示，黑色的背景其实是桌面的大小，但不包括任务栏。

问题：

这个现象正常吗？为什么会有黑色的背景？是否有相关配置去掉？ 文档中实在找不到说明，

cke_11666.png


更多关于HarmonyOS鸿蒙Next中PC端AVScreenCapture窗口录制有黑色背景的实战教程也可以访问 https://www.itying.com/category-93-b0.html

7 回复

开发者您好，

该现象属于正常情况。

录屏获取的原始码流为全屏范围（包含窗口外区域的视频流）。

根据实际业务需求，对录屏数据进行自定义处理，例如裁剪，实现保留目标窗口内容的输出效果。

如果还有其他疑问，烦请反馈。

更多关于HarmonyOS鸿蒙Next中PC端AVScreenCapture窗口录制有黑色背景的实战系列教程也可以访问 https://www.itying.com/category-93-b0.html


目前设置的captureMode是OH_CAPTURE_SPECIFIED_WINDOW，如果效果符合预期，那这里有两个问题。

  1. 采集模式OH_CAPTURE_SPECIFIED_WINDOW 和OH_CAPTURE_SPECIFIED_SCREEN 在使用上没有本质区别了，因为在录制窗口的时候，都需要根据窗口所在的位置，实时对采集图像进行裁切处理。
  2. “根据实际业务需求，对录屏数据进行自定义处理，例如裁剪，实现保留目标窗口内容的输出效果” 理论上是这个处理方式。但实现时首先需要拿到当前窗口在当前图像帧中的坐标位置才能做裁切，这个位置需要同图像数据帧绑定，不能通过单独的接口去获取，因为可能存在不一致的情况，特别是窗口在快速移动时。但数据帧中并没有找到这个属性。

开发者您好，

问题1：全屏录制窗口可能被遮挡，窗口录制是仅录制指定窗口，目前的回答还是基于窗口录制让应用裁剪；

问题2：针对您“难以直接寻找窗口位置信息”的需求，麻烦请提供以下信息： 请问您是在什么样的业务场景中使用该能力，交互流程是怎样的，在哪一个环节遇到了问题？方便说明能力不满足可能带来的影响：什么时间用到？是否高频？有无三方库可以做到？若提供该能力，是否会造成大工作量返工？请您注意提供的内容不要包含您或第三方的非公开信息，如给您带来不便，敬请谅解。

开发者你好，本地测试选择窗口录制，出现黑屏的情况是当应用从全屏到应用窗口化，边上有黑色背景，请问是否是这种情况？

是否有相关配置去掉是指不管应用是否缩小还是放大，都不出现黑色背景吗。

能否提供相关SDK版本，IDE版本，以及设备版本号。

1、窗口未全屏，开启录制后，窗口未进行任何更改，录制出来的内容就是上面的现象，窗口四周全是黑色，其实是录制了整个旧面，只是保留了窗口的内容，桌面的内容变成了黑色。

2、“是否有相关配置去掉是指不管应用是否缩小还是放大，都不出现黑色背景吗。” 是的，窗口录制就是这个概念，可以参考 windows，mac, 窗口录制。

3、HarmonyOS 5.1.0 Release SDK, inclusion of OpenHarmony SDK Ohos_sdk_public 5.1.0.125 (API Version 18 Release) as is IDE Build Version: 5.1.0.849, built on August 13, 2025 应该是鸿蒙所有的版本都是这个现象，

鸿蒙Next中PC端AVScreenCapture窗口录制出现黑色背景，通常是因为未正确设置捕获源或窗口句柄。需检查是否指定了有效窗口，并确保窗口在录制时处于可见状态。可尝试使用setWindowId方法明确目标窗口，或调整捕获区域参数。若窗口被最小化或遮挡，也可能导致此问题。

根据您描述的现象，这通常是正常的系统级行为，与AVScreenCapture的底层实现机制有关。

原因分析：

  1. 窗口合成与捕获层级：现代操作系统（包括HarmonyOS）的窗口管理器通常在一个统一的桌面合成器（如Wayland/KWin的合成器）下工作。当您请求捕获一个窗口时，系统API捕获的是该窗口在桌面合成缓冲区中对应的图层区域。
  2. 区域与背景：这个图层区域是一个矩形，其大小通常等于窗口的完整大小（包括可能不可见的边框或阴影区域）。如果目标窗口不是全屏的，那么在这个矩形区域内，窗口本身内容之外的区域，在合成缓冲区中可能就是“未定义”或“透明”的。当AVScreenCapture获取到这个缓冲区的数据时，这些“未定义/透明”的区域在某些处理环节（如颜色空间转换、内存初始化或编码器处理空数据时）可能会被填充为黑色（RGB 0,0,0）。
  3. 任务栏的例外：您提到黑色背景是桌面大小但不包括任务栏，这进一步印证了上述逻辑。任务栏通常是另一个独立的顶层窗口或特殊图层。当您指定捕获某个应用窗口时，合成器通常不会将任务栏的图层混合到该窗口的捕获缓冲区中，因此任务栏区域不会被包含进来，也就不会出现其内容。

结论与现状：

  • 现象正常性：在当前（HarmonyOS Next早期）的API设计下，此现象可以认为是符合预期的。它提供的是窗口在桌面坐标系中的原始图层缓冲区。
  • 配置去除：目前公开的C++ API接口中，可能没有直接提供“去除窗口外背景”或“仅捕获窗口客户区内容”的开关选项。AVScreenCapture的核心职责是捕获原始的、由系统合成器提供的视频帧数据。
  • 后续处理：如果您需要纯净的窗口内容，需要在获取到图像数据后自行进行后处理。例如，通过OH_NativeWindow相关的接口或窗口管理器接口获取窗口的精确位置和形状（如透明通道信息），然后对捕获到的帧进行裁剪或Alpha通道处理，以剔除周围的黑色区域。

建议的排查与处理方向：

  1. 检查像素格式：确认AVScreenCapture输出的像素格式（如OH_PixelFormat）。某些格式（如RGB24）不支持透明度，透明区域会被填充为黑色。如果支持带Alpha通道的格式（如RGBA），则透明区域可能表现为Alpha值为0。
  2. 获取窗口信息：尝试通过OH_NativeWindow或窗口管理子系统（如Window接口）获取目标窗口的精确几何信息（包括边框、阴影等），以便更准确地区分内容区域。
  3. 后处理裁剪：在编码前，根据窗口的实际内容区域（可能需要通过其他接口计算得出）对捕获到的图像帧进行内存裁剪，只保留有效区域。

由于这是底层图形合成与捕获机制决定的特性，在API未提供更精细控制之前，后处理是目前可行的主要方案。

回到顶部