Edit

Share via

capturerStartFailed UFD

  • Article

The capturerStartFailed UFD event with a true value occurs when the SDK is unable to acquire the screen sharing stream because the source is unavailable. This issue can happen when the underlying layer prevents the sharing of the selected source.

capturerStartFailed Details
UFD type MediaDiagnostics
value type DiagnosticFlag
possible values true, false

Example

call.feature(Features.UserFacingDiagnostics).media.on('diagnosticChanged', (diagnosticInfo) => {
    if (diagnosticInfo.diagnostic === 'capturerStartFailed') {
       if (diagnosticInfo.value === true) {
           // show a warning message on UI
       } else {
           // The capturerStartFailed UFD recovered, notify the user
       }
    }
});

How to mitigate or resolve

The capturerStartFailed is due to external reasons, so your application should subscribe to events from the User Facing Diagnostics and display a message on your user interface to alert users of screen sharing failures. Users can then take steps to resolve the issue on their own, such as checking if there are other processes causing this issue.

Next steps