Zoom Developer Forum

Debugging Zoom SDK failed video capture

Updated at:
October 14, 2025
Written By:
Aydin Schwartz

Question

People commonly ask on the Zoom Developer Forum:

What are the common issues and troubleshooting steps for capturing raw video frames using the Linux Meeting SDK, especially when audio capture works but video frames are not being received or saved?

Answer

When working with the Linux Meeting SDK and facing issues related to capturing raw video frames, there are several common causes and troubleshooting steps to consider:

  1. Active Cameras:
  • Ensure that at least one participant has their camera turned on. If all cameras are off, you will not receive any video frames, even if audio is being captured successfully.
  • Implement detailed logging in the onRawDataStatusChanged callback to monitor when a participant's video stream becomes active or inactive. This will help confirm whether the SDK is detecting an active video feed.
  1. Configuration Settings:
  • Double-check your configuration files (e.g., config.txt or config.ini) to ensure that both GetVideoRawData and GetAudioRawData are set to true.
  • Review the initialization and setup of your video renderer. Ensure that it is being created properly and that you have added logging to verify that the renderer is instantiated and receiving callbacks.
  1. Bandwidth Limitations:
  • Be aware that Zoom imposes bandwidth caps on the number of concurrent video feeds a single client can request. Subscribing to multiple 720p streams may result in some requests being rejected.
  • Start by subscribing to a single participant's video stream (preferably at 720p) and confirm that frames are being received. Once successful, gradually increase the number of subscriptions.
  1. Logging and Debugging: - Add comprehensive logging throughout your application, especially in the SDK callbacks, to track whether frames are being requested and received. - Check the standard output for any error messages during the joining process and while attempting to receive raw video.

If you prefer not to work directly with the Linux SDK, consider using community tools like Python bindings for the Linux Meeting SDK or third-party services such as Recall.ai, which can provide raw audio/video without the need for extensive SDK management.

By following these steps, you should be able to troubleshoot and resolve issues related to capturing raw video frames using the Linux Meeting SDK.


Zoom Developer Forum Examples

Some examples of this question are:

Written By:
Aydin Schwartz