pckg_timeline_id
The pckg_timeline_id directive in the Kaltura Media Framework sets a unique identifier for media package timelines.
Description
The 'pckg_timeline_id' directive allows users to specify a unique identifier for a particular media package's timeline in the Kaltura Media Framework. This directive is essential in managing and tracking media events across the streaming server and can be used within various contexts including http, server, and location blocks. By assigning a distinct timeline ID, it enables better organization and retrieval of media element data, particularly useful in scenarios with complex streaming setups where multiple timelines may exist concurrently.
When this directive is defined, the associated timeline is effectively registered within the internal structure of the Kaltura Media Framework. As media components generate events, they can reference this ID to correlate actions with the correct timeline. This becomes especially useful for clients requesting a specific media timeline, as it ensures that they are viewing the accurate state of the stream in real-time. The directive thus plays a pivotal role in synchronizing various media components and maintaining the integrity of the streaming process across distributed systems.
The 'pckg_timeline_id' directive accepts a single argument, which serves as the unique identifier. Care must be taken to ensure that this ID is indeed unique within the context of Kaltura’s media ecosystem but can be any string that conforms to NGINX's naming conventions. Avoid using spaces or special characters to prevent potential issues during parsing or request routing.
Config Example
http {
server {
location /stream {
pckg_timeline_id my_unique_timeline_id;
}
}
}Ensure the timeline ID is unique across the application to prevent conflicts.
Avoid using special characters or spaces in the timeline ID.