SrtDedicatedPortOutputSettings.onPublishedNameFailed property

Called when the SrtDedicatedPortOutputSettings.publishedName configured on this output was not published, so nothing using resolve will find it. Either the discovery directory refused the claim — most often because something else is already publishing that name — or this instance never made the claim, because no discovery service is configured for it or its advertise configuration cannot express the bound port. reason says which; the last two are plain misconfiguration and are the likeliest in practice.

This is not a failure of the output. It keeps streaming, and anything configured with an explicit address still reaches it; what is lost is only the name. Nothing retries: whether a name is worth waiting for depends on what the name is for, which only your code knows. To retry, publish again under a name you know to be free.

This callback is the durable record. The engine also raises a node notification, which surfaces in the visualiser and on the notification bus, but that is an event rather than a standing alert — it ages out after a few seconds. If you do not supply this callback the failure is logged to the console rather than passing silently.

Signature:

onPublishedNameFailed?: (info: {
        name: string;
        reason: string;
    }) => void;