Skip to main content

Agora Conversational AI Engine v2.4 Release

×

March 2026 Agora Monthly Digest Meet our new AI agents

×

Resolving Screen Share Outline Flickering: Optimizing Capture Parameter Updates on Windows

Updated

Issue Description

When updating screen capture parameters via the updateScreenCaptureParameters method on Windows, the screen share outline, specifically the green highlight border, briefly flashes upon each update. This visual artifact occurs even when exclusively modifying the excludeWindowList parameter while the enableHighLight flag remains active.

 

Platform/SDK

  • Operating System: Microsoft Windows

  • Service: Agora RTC SDK

  • Affected Feature: Screen sharing dynamic parameter updates

 

Root Cause

The flashing green border manifests because the highlight outline undergoes a complete reinitialization every time the updateScreenCaptureParameters method is invoked, regardless of whether the specific highlight settings have actually changed. The SDK redraws the highlight border on each update without verifying if an existing highlight state is already active.

 

Step-by-Step Solution

  1. Upgrade the SDK Version 

    The rendering behavior has been optimized at the SDK level to initialize the highlight border only once during an active screen sharing session. Update the application to the latest SDK release containing this specific optimization.

     

  2. Verify Expected Behavior Post Update 

    Upon applying the updated SDK, the border is redrawn exclusively if its core properties, such as color, width, or height, undergo modification. Repeatedly calling updateScreenCaptureParameters to alter only the excluded window list will no longer trigger the green highlight border to flicker.

     

  3. Implementation Validation 

    No additional application level code changes are required beyond the SDK upgrade. Conduct a screen sharing session and dynamically modify the excluded windows list to verify the complete elimination of the flickering artifact.