ts_kmp_ctrl_unpublish_url

Configures the unpublish URL for Kaltura media streams in NGINX.

Syntaxts_kmp_ctrl_unpublish_url "url";
Defaultnone
Contextstream, stream server
Arguments1

Description

The ts_kmp_ctrl_unpublish_url directive specifies the URL to which NGINX will send a request when a stream is being unpublished by the Kaltura Media Framework. This URL is critical for notifying external components or services about the cessation of streaming activity, allowing for resource cleanup, logging, or any necessary post-processing tasks.

When used in the appropriate context (either stream or stream server), the directive expects a single argument that represents the complete URL for the unpublish operation. This URL will be invoked whenever a stream is stopped, ensuring that any required cleanup or notification processes can be enacted. As a result, this enhances the overall robustness and maintainability of media streaming applications by providing a mechanism to manage stream lifecycles explicitly.

It’s essential to integrate this directive correctly within your NGINX configuration to ensure seamless interaction with the Kaltura Media Framework. Misconfiguration may lead to unfulfilled expectations regarding stream lifecycle events, resulting in potential resource leaks or failures to invoke necessary cleanup routines.

Config Example

stream {
    ts_kmp_ctrl_unpublish_url "http://example.com/unpublish";
}

Ensure the URL is accessible and the endpoint is prepared to handle the request from NGINX.

Using a URL that redirects may cause complications if not handled correctly on the server.

Do not forget to include the protocol (http:// or https://) when specifying the URL.

← Back to all directives