Input configuration

Updated: April 19, 2023

You can attach an input to the context by naming the URL of a track or playlist stored on a media device or in the local filesystem. The acceptable URL formats vary with the input type. For some formats, you can include parameters in the URL string, to specify settings such as the audio sampling rate.

A context can have only one input; if you call mmr_input_attach() one time to attach an input and a second time to attach a new input without having called mmr_input_detach(), the first input gets detached when the second one is attached.

With mmr_input_parameters(), you can instruct mm-renderer to repeat playback of a single track or many tracks in sequence. For HTTP-based inputs, you can configure parameters for cookies, proxy servers, and authentication credentials. For playlists, you can override any of the input parameters (except the repeat setting) for individual tracks by calling mmr_track_parameters().

Sometimes, you may want to or need to define input parameters before attaching the input. For example, when you want to read subtitles from a file that's separate than the video file you intend to play, you must first define the subpicture_url parameter, then attach the input.