实时音视频
实时音视频
文档指南
请输入
实时音视频
快速入门
场景方案
开发指南
Token 鉴权
音频管理
视频管理
屏幕共享
SDK 升级指南
客户端 API 参考
服务端 API 参考
房间管理
转推直播
输入在线媒体流
WTN 流（原公共流）
实时数据监控
历史数据查询
业务标识管理
实时消息通信
历史版本（文档停止维护）
2023-08-01
2023-06-01
转推直播
2022-06-01
2020-12-01
转推直播
输入在线媒体流
获取数据指标
常见问题
集成相关
质量相关
AI 音视频互动方案
开发指南
配置 ASR/LLM/TTS 服务
API 参考
硬件对话智能体
用户指南
服务端 API
智能体
实时信令
互动白板
客户端 API 参考
服务端 API 参考
- 文档首页
实时音视频实时音视频常见问题质量相关排查视频画面异常
复制全文
下载 pdf排查视频画面异常
文档反馈
问问助手问题详述
为什么视频会黑屏/花屏/绿屏，视频大头，视频黑边？如何解决？
问题解答
步骤 1：自检
- 出现黑边和视频大头，可能由于视窗比例与视频比例不一致导致视频画面出现剪裁。确认调用 setLocalVideoCanvas 是否将 VideoCanvas 设置为 Hidden 或 Fit。
- 如果发送端或订阅端为移动端，可能由旋转设置错误引起，详见视频采集旋转方向。
步骤 2：联系技术支持协助解决
联系技术支持时，提供以下信息：
必要信息：
- 出现问题的时间点或时间段；
- 出现问题的房间号；
- 出现问题现象的用户ID。具体是看本地预览的视频时出现问题，还是看来自远端用户的视频时出现问题。
- 提供本地日志以供排查。
辅助信息：
- 如有录屏可提供对应时间段的文件；
- 出现问题时使用的摄像头设备具体型号。
- 发送端使用的采集、旋转方式；
- 接收端渲染方式；
- 使用第三软件是否能重现花屏、绿屏现象；
- 如非系统自带摄像头设备，可提供具体的设备型号以供排查。
最近更新时间：2026.08.06 11:05:27
这个页面对您有帮助吗？
有用
有用
无用
无用