hid28063559应用媒体
设备媒体
图形图像
HarmonyOS SDK
PC端AVScreenCapture窗口录制有黑色背景
环境:
鸿蒙 pc 端,使用 c++ api ,通过鸿蒙接口拿到录屏后的图像数据,自行编码压缩写文件。
现象:
录制窗口时,录制出来的结果除了窗口,还有黑色的背景,如图所示,黑色的背景其实是桌面的大小,但不包括任务栏。
问题:
这个现象正常吗?为什么会有黑色的背景?是否有相关配置去掉? 文档中实在找不到说明,

积极迭代开发者您好,
该现象属于正常情况。
录屏获取的原始码流为全屏范围(包含窗口外区域的视频流)。
根据实际业务需求,对录屏数据进行自定义处理,例如裁剪,实现保留目标窗口内容的输出效果。
如果还有其他疑问,烦请反馈。
hid28063559目前设置的captureMode是OH_CAPTURE_SPECIFIED_WINDOW,如果效果符合预期,那这里有两个问题。 1、采集模式OH_CAPTURE_SPECIFIED_WINDOW 和OH_CAPTURE_SPECIFIED_SCREEN 在使用上没有本质区别了,因为在录制窗口的时候,都需要根据窗口所在的位置,实时对采集图像进行裁切处理, 2、"根据实际业务需求,对录屏数据进行自定义处理,例如裁剪,实现保留目标窗口内容的输出效果" 理论上是这个处理方式。但实现时首先需要拿到当前窗口在当前图像帧中的坐标位置才能做裁切,这个位置需要同图像数据帧绑定,不能通过单独的接口去获取,因为可能存在不一致的情况,特别是窗口在快速移动时。但数据帧中并没有找到这个属性2026-02-26 03:27 来自北京
鹿鸣于野回复hid28063559开发者您好, 问题1:全屏录制窗口可能被遮挡,窗口录制是仅录制指定窗口,目前的回答还是基于窗口录制让应用裁剪; 问题2:针对您“难以直接寻找窗口位置信息”的需求,麻烦请提供以下信息: 请问您是在什么样的业务场景中使用该能力,交互流程是怎样的,在哪一个环节遇到了问题?方便说明能力不满足可能带来的影响:什么时间用到?是否高频?有无三方库可以做到?若提供该能力,是否会造成大工作量返工?请您注意提供的内容不要包含您或第三方的非公开信息,如给您带来不便,敬请谅解。2026-02-27 07:05 来自广东
积极迭代开发者你好,本地测试选择窗口录制,出现黑屏的情况是当应用从全屏到应用窗口化,边上有黑色背景,请问是否是这种情况?
是否有相关配置去掉是指不管应用是否缩小还是放大,都不出现黑色背景吗。
能否提供相关SDK版本,IDE版本,以及设备版本号。
hid280635591、窗口未全屏,开启录制后,窗口未进行任何更改,录制出来的内容就是上面的现象,窗口四周全是黑色,其实是录制了整个旧面,只是保留了窗口的内容,桌面的内容变成了黑色。 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 应该是鸿蒙所有的版本都是这个现象2026-02-12 09:18 来自北京
- 为了保障您的信息安全,请勿上传您的敏感个人信息(如您的密码等信息)和您的敏感资产信息(如关键源代码、签名私钥、调试安装包、业务日志等信息),且您需自行承担由此产生的信息泄露等安全风险。
- 如您发布的内容为转载内容,请注明内容来源。
我要提问题
HarmonyOS Text组件设置红色或者绿色后,设置开启高对比度文字,显示为黑色,如何解决(API20+)
HarmonyOS NDK中如何实现AVScreenCapture在Surface模式下回调编码数据到ArkTS侧?(API12+)
HarmonyOS 使用AVRecorder录制报错,5400102 (API12)
HarmonyOS 为什么黑色的按钮没有按压效果 (API12+)
HarmonyOS 屏幕截图背景变黑(API12+)
HarmonyOS 设备升级到后,录屏以后出现黑屏 (API12+)
HarmonyOS 使用AVRecorder录像和AVScreenCapture录屏同时进行,如何让录屏的视频去掉声音,而录像的视频是要有声音的?(API12+)
HarmonyOS 截图拼接异常 (API12+)




































苏公安网备 32011402010933号