Frequently Asked Questions
Here, you can query common questions for different products, platforms, or frameworks.
Integration Issues
Does Express SDK support a disconnection and reconnection mechanism?
How to set and get SDK logs and stack information for Express?
How to select video resolution, frame rate, and bitrate?
How to upgrade Express from AppSign authentication to Token authentication?
What is the difference between media volume and call volume?
CocoaPods Common Issues
How to set the audio device mode ZegoAudioDeviceMode?
How to prevent ghost microphone or room bombing phenomena in audio and video interaction?
How to enable headphone monitor?
Why does the APK package size increase after setting Android minSdkVersion to 23?
How to use ZEGO SDK with ASan tool?
How to reduce the app size when integrating Native SDK?
How to cross-compile Linux v4l-utils dependency library?
How to implement switching camera/video screen/microphone/audio/speaker?
How to implement screen sharing through custom capture?
How to customize video capture rotation method?
In iOS application development, when stuttering, device heating, excessive memory usage and other problems occur, how should they be analyzed?
Why is haptic feedback ineffective on iOS devices during stream publishing?
Why is it unable to get device ID on Chrome 81 and above browsers?
How to cross-compile Linux alsa-lib dependency library?
Does ZIM SDK support automatic reconnection mechanism?
What is the SDK installation package increment?
Why can't I make calls through a Bluetooth device after connecting a Bluetooth device to iOS or Android?
How to implement system sound card capture on Mac?
How to switch between screen sharing stream and camera video stream?
Why do some files fail to transcode?
In a live streaming scenario, how to listen to the event of remote audience role users logging in/exiting the room?
After OBS publishes a stream, the iOS mini program has no audio when pulling the stream. What should I do?
When packaging iOS, Xcode reports an error indicating Bitcode version incompatibility?
How to view API comments and documentation in Express Android SDK?
How to monitor the microphone and camera status of users in a room?
How to set and get ZIM SDK log information?
How to fill in each cloud storage related parameter in StorageParams?
In Android platform development, how to analyze the problem of high CPU usage and device overheating?
In Windows application development, how to analyze problems such as high CPU usage and memory leaks?
How to perform mute/unmute, mute audio, and disable camera operations on remote users?
When running Java source code to generate Token, if an exception "java.security.InvalidKeyException
Key Size" appears, how to handle it?How to use ZEGO Express Web SDK on mobile?
Why does building a project with iOS simulator fail in Xcode 12.3 and above?
How to upgrade ZIM from AppSign authentication to Token authentication?
How to set landscape orientation when publishing streams in mini programs?
Why is the camera indicator light still on after disabling your own video on the web page?
Why can't I adjust background music volume through the system volume?
How to resolve macOS permission issues?
How to modify the configuration of audio 3A processing?
Why do some files fail to transcode?
How to handle Token-related error codes in Express?
How to handle common Web browser console errors?
Is it supported to send messages to yourself?
Does Express SDK on the Web platform support automatic reconnection mechanism?
After cloud recording ends, I don't see the recorded files in cloud storage. How to handle this?
How to handle file upload or loading failure?
How to obtain and upload audio Dump files?
How to resolve macOS window-related issues?
What are big and small streams?
If the client integrates Express SDK, is it necessary to maintain the room?
How to solve Metal-related crash when debugging on iOS 12 physical device?
How to make the whiteboard display normally when the browser window is in fullscreen mode
Why can't the page turn when clicking on the dynamic PPT file page?
How to handle the issue of whiteboard or file display being incomplete or having blank spaces?
Why does the cursor have ghosting (two cursors displayed) when screen sharing?
When using ZIM SDK, packaging a release version of Android apk under the Flutter framework, after installing on a real device, unable to request network, how should this be handled?
When enabling the sound level feature during mixed streaming, playing video in Safari browser shows lag. How to handle this?
When using a browser to publish third-party video streams, publishing/preview is normal, but the image is black when playing. How to handle this?
How to handle Xcode compilation errors after upgrading Express from a version before 2.8.0?
When Xcode Archive prompts "Undefined symbols for architecture armv7: "OBJC_CLASS$_ZegoProduct"", how to handle?
After integrating Express uni-app SDK on the Windows platform, when using dev certificate cloud packaging to run iOS applications, an error occurs. How should this be handled?
How to clear the cache?
How to remove a specified user from a room?
How to handle Windows 7 window sharing exceptions?
Why does the SDK crash on macOS 10.13 and below system versions?
Why does Express SDK report error 1002001 when logging into a room?
Why is the whiteboard or file content seen on each end out of sync?
How to handle issues when integrating Express SDK?
How to get the log information of the ZegoEffects SDK?
Where are the recording resolutions for single stream and mixed stream set respectively?
How to load files through the whiteboard?
Why doesn't the transcoding clarity take effect immediately after setting it, and re-rendering also doesn't work?
Compilation error after upgrading to Express v2.20.0 or later?
When the camera supports it, the preview is set to 1920 * 1080, but the actual published stream is only 640 * 480. How should this be handled?
How to set the environment for Web platform Interactive Whiteboard SDK and File Transcoding SDK?
How to switch audio and video input devices during calls on the Web platform with Express?
After successful co-streaming between both parties, if one party stops publishing the stream due to powering off or killing the process, how long does the pulling party need to receive the stream removal message?
How to set mirror mode in Express?
Why does running the source code directly after downloading from GitHub result in an error?
After clicking to leave the classroom in the room, the page does not redirect. How to handle this?
During single stream recording, why does the StreamType set for the whiteboard file not take effect?
How to use Interactive Whiteboard SDK and Video Call SDK together?
What should I do when creating a stream on the Web platform and getting the error "devices detect error: NotReadableError Could not start video source"?
How to perform authentication in the server-side API?
How to implement autoplay on the Web end?
When integrating RoomKit iOS SDK and packaging, the error "Failed to verify bitcode in xxx.framework/xxx" occurs. How to handle this?
What is the correspondence between Qt's enumerated windows and the window enumeration in the SDK?
Running electron applications on macOS Monterey (12.2.1) and above versions causes camera and other devices to not work or crash?
Why is the font display inconsistent across multiple platforms after some files are transcoded?
How to handle Super Board file upload failure?
How to handle the issue where H5 cannot see the teacher's video in Web large class?
Why is it impossible to draw on the whiteboard when using a stylus on a Windows device on the Web platform?
How many streams can a user pull simultaneously at most?
How to solve the problem of interactive whiteboard SDK login failure on the Web platform?
Why does the area capture setting fail?
How to get the stack trace information of ZIM SDK?
After whiteboard is created successfully, calling the page turn interface does not take effect?
On the uni-app platform, there is no video display for both local preview and stream pulling. How to handle this?
Why doesn't the custom layout take effect even though I specified StreamId?
During recording, if the whiteboard in the room no longer needs to be recorded, how to operate?
How to handle the prompt "Building for iOS Simulator..." when running the App?
Does Super Board SDK support hotkey operations?
How to set Super Board logs?
How to adjust the camera's focal length (zoom function)?
How to implement playing streams from CDN on the Web platform?
How to handle the issue where all interfaces of the file sharing SDK are abnormal?
For the MixInputList parameter of mixed stream, if ViewType is set to 2, how should StreamId be set?
How to handle the "No version of NDK..." error when compiling Roomkit source code?
What do you need to do before using interactive whiteboard?
How to display the whiteboard normally when the browser window is in fullscreen mode?
Is the token of File Sharing SDK compatible with the token of Interactive Whiteboard SDK?
How to use Super Board SDK and Video Call SDK together?
When using "switchRoom" to switch rooms, why does the error 1000002 - not logged in appear?
When Express SDKs on various platforms interoperate, are there any restrictions on userID/roomID/streamID?
How to get the stack trace information of the ZegoEffects SDK?
How to get the CDN stream playing address on the Web platform?
After loading a dynamic PPT file, clicking on the dynamic PPT cannot turn the page. How to handle this?
How to implement screenshot functionality for preview and play stream video on Web platform?
On the Web platform, after creating a stream through the "createStream" method and assigning a value to the "srcObject" of the video object, why is there no video in the video object?
How to get Roomkit SDK logs?
How to handle the error "onScreenCaptureError 3" when starting screen sharing?
How to add whiteboard tools?
On Web platform, RoomKit large class, how to handle the issue where students cannot see the teacher's video when joining?
On the Web platform, when playing streams from CDN using FLV format playback, why does pausing and then playing again cause latency accumulation?
When calling the createEngine interface to create an engine, if the room scenario is set to "voice call/voice chat room/KTV" and other scenarios, do I still need to actively call the "enableCamera" interface to close the camera?
Why doesn't the transcoding clarity take effect immediately after setting it, and re-rendering also doesn't work?
When pushing stream on Web end, error "code: 1103065, msg: Not Readable Error: device is not readable" is reported. How to handle?
How to set logs for files/whiteboards?
How to handle the issue where all interfaces of Super Board SDK are abnormal?
On the Web platform, when the set video resolution "width" is greater than "height", how is it displayed on PC and mobile respectively?
On the Web platform, how to set mirror mode for Express?
Express SDK: Why can't I receive a callback after sending a real-time message?
Why is opening the camera not supported when the app is in the background?
How to handle the issue where animation clicks in dynamic PPT have no response?
How often does ZIM send heartbeats by default? After how long without receiving a user heartbeat will the backend determine it as timeout?
On the Web platform, how to handle connection disconnection during the process of relaying streams to CDN?
How to reduce the information printed by Express SDK in the Web console?
When Express SDK logs out of a room, is it necessary to actively stop publishing and playing streams?
Why is it impossible to draw on the whiteboard when using a stylus on a Windows device on the Web platform?
What is the difference between the onConnectionStateChanged callback and the onRoomStateChanged callback in ZIM SDK? When are they triggered respectively?
What is the difference between the onRoomAttributesUpdated callback and the onRoomAttributesBatchUpdated callback in ZIM SDK? When are they triggered respectively?
When the Web platform reports an error "https or localhost required", is "https" mandatory?
On the Web platform, when only previewing the published stream without playing streams, there is noise/howling. How to handle this?
How to mix the audio from media player playback into the published stream?
When publishing a stream, after calling the "enableTrafficControl" method to enable traffic control, why does only the main stream trigger the traffic control policy when the network quality is poor?
How to resolve conflicts when integrating Firebase Cloud Message simultaneously?
When using the "muteMicrophone" and "enableAudioCaptureDevice" interfaces and setting the parameter to false, what is the difference between them?
On the Web platform, how to share system sound and microphone sound during screen sharing?
How to handle errors when calling Roomkit SDK interfaces after compilation and packaging?
What is the reason for file transcoding loading failure with error code 60018?
On the Web platform, "playQualityUpdate" has audio bitrate, but after successful stream playing, there is video but no sound. What is the reason?
When mixed stream is enabled with sound level feature, using "flv.js" to pull and play streams results in black screen on some browsers?
Web platform uses "https" to go online, but the flv play stream address returned by SDK is "http", which is incompatible. How to solve?
How to push pure audio stream on Web platform?
In scenarios where rooms need to be switched frequently, the rendering speed of the playing stream's screen is relatively slow. How to optimize it?
How to pass mixed stream name information between different users?
When the ZIM server "query user online status" interface returns error code 660200001, how should this be handled?
How to get offline push PushID?
Can the parameters "audioInput" and "videoInput" be passed as empty strings when calling the createStream method on the Web platform?
Web platform SDK publish stream error "stream not from zego", how to handle?
When using the "uni-app" framework, "playerStateUpdate" shows successful stream pulling, but using "srcObject" cannot render the video?
On the Web platform, during screen sharing, when clicking the "Stop Sharing" button, will there be a callback message?
After dynamic PPT transcoding is completed, some animations are different from the source file. How to handle this?
Why does the "background callback - recording file generation callback" callback twice? And the video content of both callbacks is the same?
Does the "Real-time Messaging and Signaling" feature of Video Call (ZEGO Express SDK) support querying history messages?
When using Express SDK with a mini program as the publish stream end, how does the play stream end get the status changes of the microphone and camera?
How to set mirror for preview and stream playing on the Web platform?
How does a mini program push directly to CDN?
Why does the client online authentication fail when accessing the ZegoEffects service through the URL address?
What are the Token authentication methods for Express SDK, and how should they be used?
When using CDN recording, if the streaming end experiences stream interruption, multiple recording files will be generated. How can these recording files be merged?
When using external capture, is it supported to push PNG images with alpha channel?
How to prohibit the access permission popup for microphone/camera on Web platform?
When playing streams on the Web platform, the error "Player already exist!" appears. What is the reason?
How to print SDK logs to the console using Express SDK?
When logging in to a room on the Web platform, the error "cmd=login, err_code=1011, err_message=token format error" is displayed?
How to specify StreamID for cloud recording?
How to implement pendant function in AI?
How to solve the server error "No valid license" (cannot get the certificate) when using ZegoEffects?
Does Express streaming support setting an encryption key that requires the corresponding key to pull the stream?
When logging in to a room on the Web platform, the error "content":"cmd=login, err_code=1000000101, err_message=login liveroom request fail", or "content":"server error=1000000101" appears. What is the reason?
What is the reason for file transcoding loading failure with error code 2030004?
After PPT transcoding is completed, text loss occurs. How to handle this?
After calling "enablePublishDirectToCDN" to directly push to CDN, do I need to set "enablePublishDirectToCDN" back to "false" after stopping the stream?
After users modify their name, avatar, and personal information extension fields through ZIM SDK interface, how to query the modified information?
When the whiteboard on the Windows end blocks the user's modal dialog, and the user's program cannot be clicked, how should this be handled?
When Unity SDK renders images to a mesh, why can selecting "Universal Render Pipeline > Lit" render successfully, but selecting "Universal Render Pipeline > Unlit" cannot render?
Why can't I see the effect after setting a filter in face beautification?
How to retrieve log files?
On Android platform, initializing the Whiteboard SDK reports an error: Didn't find class "com.zego.edu.logger.ZegoEduLogger"?
When using ZIM SDK, after dissolving a group, can I use the GroupID of this group to create a new group?
Does Express server have an API to create a room?
Why can't ZIM SDK find offline messages in the room?
Can the server's "stream creation" and "stream closure" callback notifications be guaranteed to be ordered?
Is a room destroyed immediately when there are no users in it?
After updating the ZIM SDK version, do I need to rebuild the base?
Why does uploading a file multiple times return the same fileID?
When using Express SDK, what problems occur if different clients log in to a room with the same userID?
How to handle the issue of crashes caused by calling ZegoEffects SDK interfaces?
How to customize the back button event during a call?
After enabling the face slimming effect, when the user's face is close to the edge of the screen, the surrounding area will have a black block, how should it be handled?
How to handle the case where the certificate is obtained but the beauty effect is not effective?
How to pause/resume receiving streams in a room?
When using ZegoEffects in the custom preprocessing feature of RTC, the preview and published stream show a black screen. How to handle this?
How to disable toast display for callInviteButton?
Can I implement an audio-only call scenario using the Video Call SDK?
How to handle the failure of accessing the ZegoEffects server through URL address when the client is online authentication?
How to handle the black screen caused by calling processImageBuffer?
How does Express create a room?
How to handle font misalignment or size inconsistency in dynamic transcoding?
What is the difference between ZIM's login interface and Video Call's loginRoom interface?
When will the floating window video be displayed?
How to handle integration errors?
How to keep ZEGO SDK's audio and video functions running normally when the application goes to the background?
How to handle calls when multiple incoming calls exist simultaneously?
How to handle offline push notifications in the background?
Room-related issues
How to add the Maven repositories in Android Studio version bumblebee?
Stream playing issues
How can I listen for the event callbacks related to room users' login/logout in live streaming?
Stream publishing issues
Common integration issues
Stream mixing issues
Quality Issues
Why can't I turn on the camera?
How to handle video zoom or black bars issue?
How to handle black screen or no audio during live streaming on the Web platform?
How to handle audio echo issues?
How to handle audio and video out of sync issues?
How to avoid volume changes when switching microphone on/off during live streaming?
How to ensure smooth audio and video streaming in poor network environments (flow control)?
How to handle the issue of audio volume being too low?
Express: How to handle audio stutter issues?
How to handle video blur issues?
How to handle video freeze issues in Express?
How to handle audio noise issues?
How to handle the no audio issue?
How to solve screen sharing quality issues on the Web platform?
How to resolve video anomalies (such as black screen, green screen, corrupted screen, etc.) when Web platform and Native platform interoperate?
How to handle video black screen issues in Express?
Why does the recording task succeed after starting recording, but the whiteboard is not displayed in the recorded video?
How to handle video artifacts or green screen issues?
How to handle the issue of incomplete whiteboard display or blank space?
What should I do if the screen turns dark or bluish after enabling skin tone enhancement?
Why does the whiteboard window position display a background image?
Why does the whiteboard window become smaller and appear abnormal in the recording result?
Why does the whiteboard window position display audio and video streams?
Why does file transcoding sometimes take a long time?
How to handle abnormal font display in file whiteboard?
Sound issues
Product Consultation
What are the alternative solutions after Avatar, MetaWorld products and related solutions are delisted?
What are the alternative solutions after RoomKit and Go Classroom products and their related solutions are delisted?
What is the alternative solution after the data stream recording product and its related solutions are discontinued?
What solutions does ZEGO provide?
Which browsers does ZEGOCLOUD Express Web SDK support?
What is the relationship between Super Board, Interactive Whiteboard, and File Sharing?
What is the difference between ZEGOCLOUD low-latency live streaming and other RTMP + CDN live streaming technology?
What is Token? How to generate Token? How to use Token?
How to get a temporary Token for calling ZEGO SDK?
Why can't the audio files embedded in PPT be paused and the progress bar dragged?
Does In-app Chat support overseas access?
During recording, if an audio and video stream exits the room and then rejoins, what will happen?
Which platforms does ZEGO Cloud Communication SDK support, and what are the system version requirements for each platform?
What is custom graphics?
The documentation for casual mini games (casual games, card games) has been discontinued. How to access the related content?
Does ZIM room contain real-time audio and video streams?
Does ZEGO Express SDK support playing 60fps streams?
After starting recording, if a new stream is added to the room, will this new stream be recorded?
Is recording IM messages supported?
What happens when the cloud recording server experiences network disconnection or abnormal crash?
Does Super Board SDK support file size and format restrictions?
What are the characteristics of ZEGOCLOUD's audio processing?
Can PPT Notes be hidden when recording PPT?
Does Interactive Whiteboard SDK support hotkey operations?
In mixed stream recording, can we specify the shared PPT from the teacher's side or student's side?
What impact will user program crashes have on cloud recording?
Do custom layout, horizontal layout, equal layout, vertical layout, and floating layout all support specifying the whiteboard position?
In mixed stream recording with custom layout, if mix_input_list has only one layout, can multiple streams be recorded?
What is the lifecycle of Interactive Whiteboard?
Does the third-party cloud storage parameter (StorageParams) support passing in a temporary authorization Token?
Is dynamic PPT recording supported?
What file formats does file transcoding support?
Can two whiteboard windows be displayed simultaneously in the recorded video?
When whiteboard recording is enabled, but a whiteboard is added to the room after a period of time, how is the whiteboard recorded?
How is the traffic consumed by file upload transcoding and download viewing calculated?
What is the relationship between Interactive Whiteboard SDK and File Sharing SDK?
Why doesn't a menu appear when right-clicking on the transcoded dynamic PPT file page?
What is the lifecycle of Super Board?
What are the differences between the various use cases to select when creating a project in RoomKit?
What is the maximum number of whiteboards that can be created in a room?
How to get the SDK version number?
Are there size and format restrictions for files supported by the file sharing SDK?
Does Super Board support audio and video file sharing?
Does Super Board distinguish between roles such as teachers and students?
What is custom graphics?
Does Interactive Whiteboard distinguish between roles such as teachers and students?
When using OBS or mini program platforms for streaming, can I view the streaming records in "Analytics Dashboard > Call Insights"?
How to configure domain CNAME?
If a user is in both real-time video and instant messaging rooms at the same time, when leaving the room, should I call the "logoutRoom" interface of Express SDK first, or the "leaveRoom" interface of ZIM SDK?
Which browsers does Express Web SDK support?
In the ZIM trial version plan, the default maximum number of rooms that can be created under the same AppID is 20. If 5 are created and then 5 are destroyed, how many more can be created?
How to perform domain ownership verification?
When will cloud recording receive callback notifications?
Are there file size limits?
Can ZIM's Google offline push be used in domestic environments?
What is the timeout duration for file transcoding to load files?
Is there an administrator in each room during a call?
Does file transcoding support audio and video file sharing?
Does the multi-room feature require special configuration?
In RoomKit small class scenarios, does the student side support H5?
How to add whiteboard tools?
The
ZIMMessageSentCallbackin ZIM Flutter sendMessage interface does not exposeerrorcode. How to get it?When using the message receipt feature to mark messages as read, why does the unread count in the conversation list not decrease?
What are the alternative solutions after the mini-game platform is taken down?
Other Issues
How to connect to ZEGOCLOUD Document MCP service?
How to call server-side API online?
How to understand and use SEI (Supplemental Enhancement Information)?
What are some known issues with WebRTC browsers and workaround solutions?
How to handle the issue of video stuttering or audio-video out of sync when using OBS to publish and SDK to play?
How to handle the App Nap issue on macOS system?
How to use bitmask?
How to select different voice detection interfaces according to scenarios?
How to define streamID appropriately?
When to use custom messages?
How to restrict messaging only between friends?
Why is audio and video capture ineffective on Android 9 when the app is locked or switched to the background?
How to mute a certain stream or all streams when playing streams?
How to destroy a room in IM?
How to set message priority more reasonably?
When deploying a server on the Web platform, must you use the HTTPS protocol?
Can a user join multiple rooms?
When in a room, after pressing the Home key to return to the desktop, clicking the application icon to return to the application, why didn't it return to the room?
Can "pic_url" in "Server Callback - Stream Creation Callback" be configured with SSL for content moderation?
When the network environment is poor, will Express SDK forcibly make users automatically exit the room?
When publishing streams normally, only the Android platform can play streams normally using WeChat browser, but iOS platform cannot play streams, yet there is data in the "playQualityUpdate" callback?
Why does the system crash when screen sharing on iOS devices?
How to monitor who is speaking in the room with Express SDK?
How to provide only audio permission when publishing streams on the Web platform?
When mixing two streams, if one of them disconnects, will the stream mixing automatically stop?
For low-end devices with lower configurations, how to choose capture configuration and encoding resolution to reduce performance overhead?
When calling the "room user kick-out interface" to kick out a nonexistent user, will it report an error?
When using the server-side mixed stream API, what is the function of the "seq" value in the start mixed stream interface?
When using cloud recording, there are only two real users in the room, but the onRoomOnlineUserCountUpdate callback shows three users?
In an audio-only scenario, how to display a background image for stream mixing?
Does the whiteboard support erasing content by trail?
Why is the data returned by the backend stream creation and stream closure callbacks invalid when processed using "Form" format?
When using a wildcard domain to apply for an SSL certificate, why does the console prompt that the uploaded certificate does not match the domain when uploading the certificate?
Common audio issues
Common issues of the Express SDK
How to upgrade UIKits with a plugin to V2.0.0?