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

[Emerson1 (Emerson)]

For everyone who has having black screen issues, I’ve found something that can be useful…

It seem that some of those black screen errors are related to how Flutter handles hybrid composition - For example, ZoomVideo SDK uses UiKitView to render the video on iOS and our app is applying rounded corners or any other transformation on Flutter side. This was causing a rendering error and leading to the black screen view.

After doing some tests I was able to get rid of those errors by removing everything that’s transforming the view. Even using a `Stack → Positioned` can cause this error.

[ticorrian.heard (Ticorrian)]

@Emerson1 Thank you for sharing your findings on this. Engineering is still looking into this currently and I’ve shared this and your logs with them so that should give them more insight.

[chen2 (chen)]

Hello, what’s the status of this issue.
Best regards.
Thank you

[Fouad]

Hello All,

The black screen issue on iOS (and sometimes Android) occurs because of how Flutter’s hybrid composition interacts with Zoom’s UiKitView (on iOS) or PlatformView (on Android).

Zoom renders its video surface using a native platform view, and if Flutter applies any transformation (e.g., rounded corners, opacity, clipping, overlays, or using Stack + Positioned), the native view may fail to render properly — resulting in a blank / black screen.

This is my working code on IOS and Android:

class VideoGrid extends StatelessWidget {
  final List<ZoomVideoSdkUser> users;

  const VideoGrid({super.key, required this.users});

  @override
  Widget build(BuildContext context) {
    if (users.isEmpty) {
      return const Center(child: CircularProgressIndicator());
    }
    // ✅ Avoid GridView → Use Wrap for stable layout
    return LayoutBuilder(
      builder: (context, constraints) {
        final isSingle = users.length <= 1;
        final width = isSingle
            ? constraints.maxWidth
            : (constraints.maxWidth / 2) - 2;
        final height = isSingle
            ? constraints.maxHeight
            : (constraints.maxHeight / (users.length > 2 ? 2 : 1)) - 2;

        return Center(
          child: Wrap(
            direction: Axis.vertical,
            spacing: 0,
            runSpacing: 2,
            children: users
                .map(
                  (user) => SizedBox(
                    width: width,
                    height: height,
                    child: _SafeZoomView(user: user),
                  ),
                )
                .toList(),
          ),
        );
      },
    );
  }
}

class _SafeZoomView extends StatelessWidget {
  final ZoomVideoSdkUser user;

  const _SafeZoomView({required this.user});

  @override
  Widget build(BuildContext context) {
    // ✅ No Material, Container, or decoration!
    return ClipRect(
      // Only ClipRect is safe — doesn’t transform native layer
      child: zoom_view.View(
        key: Key(user.userId),
        creationParams: {
          "userId": user.userId,
          "videoAspect": VideoAspect.FullFilled,
          "fullScreen": false,
        },
      ),
    );
  }
}

[Maulik (Maulik Sinroja)]

Hello @ticorrian.heard

Can you please let us know when the latest version of “flutter_zoom_videosdk” will be released?

Best Regards,

[ticorrian.heard (Ticorrian)]

@Maulik We have Flutter 2.3.5 releasing this month. I’ll try to get you a specific date.

[Maulik (Maulik Sinroja)]

Hello @ticorrian.heard

Is there any update on the ‘flutter_zoom_videosdk’ package that was planned for release this month? Please let me know if there’s any new information from the development team.

Best Regards.

[ticorrian.heard (Ticorrian)]

Hi @Maulik The 2.3.5 update was released Nov 24th. You can view the changelog details here: Version 2.3.5

[Maulik (Maulik Sinroja)]

@ticorrian.heard Thanks for sharing the update.

I believe the Development team has released a version intended for “Web” development, but it does not resolve the issue we are facing.

From the beginning until now, I (and many other users) have repeatedly explained this problem after using the Flutter plugin. The issue exists in flutter_zoom_videosdk ^2.3.0 and in flutter_zoom_videosdk ^2.1.10.

To explain again clearly:

• I tested both flutter_zoom_videosdk: ^2.1.10 and flutter_zoom_videosdk ^2.3.0.

• After adding the plugin to my Flutter app and running pod install/update, it installs the native iOS dependency ZoomVideoSDK (2.3.0).

• However, this version does not fix the black screen issue on iOS.

To resolve the black screen issue, the app requires ZoomVideoSDK (2.3.5) or higher.

As shown in the screenshot below, the issue has already been fixed by the iOS development team in ZoomVideoSDK 2.3.5+. However, the Flutter plugin has not yet been updated to include this newer native SDK version. The Flutter team’s code is still tied to ZoomVideoSDK 2.3.0, which is why the issue persists for Flutter users.

So again, I request an update on this:

When will the Flutter Development team upgrade flutter_zoom_videosdk to use ZoomVideoSDK (2.3.5) or a higher version?

This update is critical for resolving the black screen issue on iOS for all Flutter users.

Thank you.

[Rostyslav]

Fixing Black Screen Issue in Zoom Video SDK Flutter 2.4.0 by Updating iOS SDK

Problem:
After updating iOS or when running the app on newer iOS versions, Zoom Video SDK meetings showed a black screen instead of video. The issue occurred on iOS devices, while Android worked normally.

Root Cause:
The problem was related to an outdated iOS SDK version (2.3.10) in the Flutter plugin flutter_zoom_videosdk. The new iOS SDK version (2.4.0) contains compatibility fixes for newer iOS versions and improvements for video handling.

Solution: Update iOS SDK to Version 2.4.0
Due to this issue, you need to update the iOS SDK inside your Flutter SDK. Here are the steps:

Step 1: Update Dependencies in podspec File

Update the ios/flutter_zoom_videosdk.podspec file in your Flutter SDK project:

s.dependency "ZoomVideoSDK/ZoomVideoSDK", '2.4.0'

s.dependency 'ZoomVideoSDK/zoomcml', '2.4.0'

s.dependency 'ZoomVideoSDK/CptShare', '2.4.0'

s.dependency 'ZoomVideoSDK/zm_annoter_dynamic', '2.4.0'

s.dependency 'ZoomVideoSDK/ZoomTask', '2.4.0'

s.dependency 'ZoomVideoSDK/Whiteboard', '2.4.0'

Step 2: Update Version in pubspec.yaml

Update the plugin version in pubspec.yaml:

version: 2.4.0

Step 3: Clean and Reinstall Dependencies

Run the following commands in the root of your Flutter project:

# Clean Flutter cache
flutter clean

# Get dependencies
flutter pub get

# Navigate to iOS directory
cd ios

# Update CocoaPods dependencies
pod install --repo-update

# Return to project root
cd ..

Step 4: Verify Build

Check if the project builds without errors:

flutter build ios --no-codesign

If the build is successful, you will see:

✓ Built build/ios/iphoneos/Runner.app

Result

After updating:

• Black screen is gone, video displays correctly
• Improved compatibility with newer iOS versions
• All Zoom Video SDK features work stably
• ScreenShare functionality works without additional configuration

Technical Details

• Previous iOS SDK Version: 2.3.10
• New iOS SDK Version: 2.4.0
• Update Method: Through CocoaPods dependencies (recommended)
• Compatibility: iOS 15.0+

Conclusion

Updating the iOS SDK from version 2.3.10 to 2.4.0 resolved the black screen issue. I recommend everyone who encounters similar problems to check the iOS SDK version and update it to the latest stable version.

Note:
Since most developers download the ready-made Flutter SDK zip file rather than a public package, you will need to update the iOS SDK inside the Flutter SDK manually by following the steps above.