ts_stream_id
The `ts_stream_id` directive configures a unique streaming identifier for each media stream processed by the Kaltura Media Framework in NGINX.
Description
The ts_stream_id directive is used within the Kaltura Media Framework to uniquely identify each media stream handled by the NGINX server. This identifier is critical in environments where multiple streams are being processed simultaneously, ensuring that each stream can be tracked and managed independently. When configured, the ts_stream_id allows backend components or client applications to reference the specific stream being handled, enabling smoother media operations and orchestration among various components of the media stack.
In terms of its parameters, the ts_stream_id directive accepts a single argument, which should be a string representing the ID for the stream. This ID should be unique among all streams to avoid conflicts and ensure proper routing of requests and responses. It is important to configure this directive carefully, especially in environments where dynamic stream ingestion occurs, as reusing stream IDs could lead to erroneous behaviors or data issues.
This directive is supported in several contexts including HTTP, server, and location blocks, making it versatile for various levels of configuration in the NGINX setup. This flexibility allows administrators to define stream IDs at different scopes depending on their needs, enhancing the configurability of the streaming infrastructure.
Config Example
location /stream {
ts_stream_id "unique_stream_id_123";
# Other proxy or stream settings
}Ensure the stream ID is unique across all active streams to avoid routing issues.
Setting the same ID for multiple concurrent streams can cause conflicts and unexpected behavior.
Make sure to validate the stream ID format to prevent incompatibility with other components.