How to handle video zoom or black bars issue?
2022-10-09
Products / Plugins:Video Call / Audio Call / Live streaming
Platform / Framework:iOS / Android / macOS / Windows / ReactNative
Video zoom and black bars are mainly caused by inconsistency between video resolution and display view size, resulting in video image problems. You can refer to the following troubleshooting steps.
Problem Troubleshooting
Common zoom and black bars situations are as follows:
- If the phone camera orientation and encoding resolution are inconsistent, cropping will occur before encoding, causing video zoom. For example, if the phone screen orientation is portrait and the encoding resolution is landscape, or the phone screen orientation is landscape and the encoding resolution is portrait, there will be obvious zoom. For related information, please refer to Video Capture Rotation.
- If the rendering fill mode used by the stream pulling end is ASPECT_FILL mode, and the video size (encoding resolution) is inconsistent with the display view size ratio, cropping will occur causing video zoom.
- If the rendering fill mode used by the stream pulling end is ASPECT_FIT mode, and the video size (encoding resolution) is inconsistent with the display view size ratio, scaling will occur causing black bars.
Contact ZEGOCLOUD Technical Support
If the problem persists, please contact ZEGOCLOUD Technical Support and provide the following information to help quickly locate the problem.
| Information | Details |
|---|---|
| Required Information | Whether the video sending end APP is landscape or portrait, and whether the encoding resolution is landscape or portrait. |
| The aspect ratio of the video receiving end view. | |
| SDK log file. For details, please refer to How to set and get SDK logs and stack information. |