Black Screen on iOS and Full-Screen Video Not Rendering on Both Android & iOS with flutter_zoom_videosdk: ^2.1.10

Video SDK Flutter
, , ,
1

Issue Summary

I’m using the flutter_zoom_videosdk: ^2.1.10 library to implement video calling functionality in my Flutter application. Everything was working fine with version ^1.14.0. However, after upgrading to ^2.1.10, I’m encountering a black screen issue on iOS devices during video calls.

The video functionality works fine on Android devices in terms of connection and audio, but full-screen video rendering is not working on either Android or iOS platforms — even though the required arguments for resolution and aspect ratio have been provided.

Environment

  • Library Version: flutter_zoom_videosdk: ^2.1.10
  • Platform :
    • :white_check_mark: Android — Video call connects, but full-screen video is not rendered
    • :cross_mark: iOS — Black screen (no video), audio works

Issues Observed

  • On iOS, the video screen stays black, though audio is functioning.
  • On both Android and iOS, the video does not render in full-screen mode despite passing the proper resolution and aspect ratio parameters.

Steps to Reproduce

  1. Upgrade to flutter_zoom_videosdk: ^2.1.10.
  2. Initiate a video call from an Android or iOS device.
  3. Observe:
  • iOS: Black screen, no video display.
  • Android & iOS: Full-screen video not rendered properly.

Additional Notes

  • Permissions for camera and microphone are properly configured on both platforms.
  • The issue did not occur in version ^1.14.0.
  • Screenshots and device logs can be shared if needed.

Request

Could you please guide me in resolving these issues? Any insights on proper handling or known workarounds for video rendering issues in the latest SDK would be highly appreciated.

3 Likes
2

@richard.zoom, can you please help me here?

3

Hello Maulik,

We are currently investigating this issue internally.

Thank you for your patience,
Richard

1 Like
4

@richard.zoom Any update on this issue?

6

Hi @Maulik Woud you be able to upgrade to 2.2.5 and try again?

I also believe you might be running into our frequency limits for subscribing, unsubscribing, and switching resolutions where:

  1. Same user: video subscribe/unsubscribe will have the same resolution after success, and must wait interval of 30ms before subscribing again. No limit when subscribing to different resolutions.

For example, there should atleast be 30ms delay for subscribing to the same user’s video with same resolution. sub A—>unSub A then delay 30ms, subA will succeed. Less than 30ms interval will fail and the user video will show black.

Can you try upgrading and/or adjusting for this and let me know if the problem persists?

7

@ticorrian.heard

Thank you for the clarification. However, I’m not sure which version you’re referring to for the upgrade. I’m currently using the Flutter plugin for Zoom video call integration, and based on the available versions in the Flutter plugin library, version 2.2.5 does not appear to be listed.

Could you please confirm if this version is specific to a different SDK or platform, or guide me to the correct package/version reference?

Package - flutter_zoom_videosdk

1 Like
8

I’m also using the flutter_zoom_videosdk: ^2.1.10
and faced with black screen issue on iOS devices during video calls

1 Like
9

I’m having a trouble with some videos only on iOS (on simulator and real devices) when I run the app sometimes I can watch a black screen but the audio is ok.

1 Like
10

You would be upgrading the iOS and/or Android SDK used alongside the Flutter SDK. You can see the steps for this here.

11

The black screen issue on iOS and video not rendering full-screen on both platforms in flutter_zoom_videosdk: ^2.1.10 is likely due to changes in how video views are handled.
Steps to Fix:

AspectRatio(
aspectRatio: 16 / 9,
child: ZoomVideoView(controller: _controller),
)

  1. For iOS, add this to Info.plist:

io.flutter.embedded_views_preview

  1. Run flutter clean and reinstall the app.

If issues persist, revert to version ^1.14.0 temporarily and check Zoom’s SDK changelog for updates.

12

When this release update on the pub.dev?

Screenshot 2025-09-01 at 9.37.55 PM
Screenshot 2025-09-01 at 9.37.55 PM1668×1380 286 KB

13

@richard.zoom @ticorrian.heard I’m also having the same issue reported in this ticket and I’m willing to upgrade Zoom to version 2.3.0, however we need this upgrade available on pub.dev.

1 Like
14

@Emerson1 I reached out to my team to get more info on an update to pub.dev.

15

@Emerson1 We are looking at this week to update the version.

1 Like
16

@ticorrian.heard I saw that the version 2.3.0 was released today on pub.dev, but the version that fixes black video issue is 2.3.5, according to changelog:

image
image1516×480 64.3 KB

17

I’m facing same issue, I manually downloaded the version 2.3.0 from Zoom Developer Portal and tested still having black screen issue.

18

@ticorrian.heard Do your team have plans to update the Flutter plugin to version 2.3.5 soon?

Besides the issues with video, we’re planning to use the in-app screen sharing as well…

1 Like
19

@ticorrian.heard

I am still facing the issue on a iPhone real device even after upgrading to flutter_zoom_videosdk 2.3.0. However, the issue does not occur on the simulator, where everything works as expected.

Simulator Testing Scenario

  1. On an Real Android device, I can open the app and use the camera for the video call without issues.
  2. On the iOS simulator, I am able to see the video stream from the Android device user successfully.
20

Hi @Emerson1 Version 2.3.5 would refer to the iOS and Android SDKs the Flutter SDK is wrapping. You could upgrade those by downloading those SDKs and using that version alongside the 2.3.0 version of Flutter.

21

@Maulik @Emerson1 @Anders1 I have an open ticket for engineering to look more into this issue if the upgrade is not working for you. Would you be able to share logs from your app to this thread (or DM me if you want) that I can send to engineering for further investigation?