How can I solve the quality issues of screen sharing on Web clients?
Problem
When a Web client shares the screen, the screen freezes or blurs.
Solution
Find the solution that corresponds to the version of the Web SDK you are using.
Web 3.x
Troubleshoot the problem by following the steps below:
- Ask the user to use the latest official version of the Chrome browser on desktop.
- Set codec as
vp8
when callingcreateClient
. - Check whether the user is sharing an application window.
- If so, ask the user to share the browser tab or the entire screen instead.
- If not, check the encoding configurations you set in
setScreenProfile
.
- Upgrade the SDK to 3.2.0 or later versions, and set
optimizationMode
when creating the stream for screen-sharing. Choose the appropriate transmission optimization mode according to the shared content:- If the shared content is mainly slides, texts, or static images, set
optimizationMode
as"details"
. - If the shared content is mainly videos or games, set
optimizationMode
as"motion"
.
- If the shared content is mainly slides, texts, or static images, set
Web 4.x
Troubleshoot the problem by following the steps below:
-
Ask the user to use the latest official version of the Chrome browser on desktop.
-
Set codec as
vp8
when callingcreateClient
. -
Check whether the user is sharing an application window.
- If so, ask the user to share a browser tab or the entire screen.
- If not, check the encoding configurations you set in
createScreenVideoTrack
.
-
Set
optimizationMode
when creating the video track for screen sharing, and choose the appropriate transmission optimization mode according to the shared content:- If the shared content is mainly slides, texts, or static images, set
optimizationMode
as "details". - If the shared content is mainly videos or games, set
optimizationMode
as"motion"
.
- If the shared content is mainly slides, texts, or static images, set
As of v4.2.0, you can change the transmission optimization mode during a screen sharing session by calling setOptimizationMode
.