Skip to main content

You are looking at Video Calling v3.x Docs. The newest version is  Video Calling 4.x

Android
iOS
macOS
Windows C++
Windows C#
Unity
Flutter
React Native
Electron
Cocos Creator
Cocos2d-x

Speed up the First Video Frame Rendering Time

This page describes how to speed up the first video frame rendering time by modifying the integration method. For more assistance, contact technical support.

Initialize the remote view

The process of local users seeing remote users is essentially the reception, decoding, and rendering of each remote video frame by local users. To speed up the local user's ability to see the remote user's video, you need to shorten the time it takes for the first remote video frame to start rendering in the view window of the local user's application user interface. Therefore, Agora recommends that you create a view for the remote video before the local user renders the remote video in order to avoid delaying the video rendering. Do this as follows:

  • Before the remote user joins a channel: Get the user ID of the remote user in advance and then immediately call setupRemoteVideo to initialize the remote view. If you cannot get the user ID in advance, you can get it from the onUserJoined callback and immediately call setupRemoteVideo to initialize the remote view. This can delay the video rendering, however.
  • After the remote user joins the channel: The SDK triggers the onUserJoined and onFirstRemoteVideoDecoded callbacks in sequence. Until the local user receives the onFirstRemoteVideoDecoded callback, the decoding of the first remote video frame has not started. Therefore, during this time, no image appears on the remote view you have initialized, and the local user could grow impatient. To reduce the user's perceived waiting time, add an image to the remote view to indicate that the video is loading.

Switch channels using switchChannel

When switching channels, if the user calls leaveChannel and joinChannel in sequence, internally the SDK destroys and creates the media engine, which takes some time. Agora recommends switching channels by switchChannel to shorten the time it takes for the user to switch channels so that other users can see the user's video faster.

Avoid time-consuming operations

If you add a time-consuming operation to the callback thread of the SDK, the latency of SDK event notifications increases. For example, the onUserJoined callback could be delayed, making it take longer for you to get the user ID of the remote user by the callback, which results in a slower time for creating the remote view. For this reason, Agora strongly recommends that you do not add any time-consuming operations to the callback thread of the SDK.

Video Calling