The SelectStreamsWorkflowOperationHandler can be used in case not all source streams should be processed. For example, given a recording with a presenter and a presentation track, the final recording to be published should only include the video stream of the presenter track and the audio stream of the presentation track.
The workflow operation will use workflow properties set by the Opencast video editor to determine which streams should be
selected for further processing and add them to the media package based on
|source-flavor*||*/source||The flavor of the track(s) to use as a source input|
|target-flavor*||*/work||The flavor of the target track(s)|
|target-tags||download||The tags applied to all target tracks|
|audio-muxing||force||Move single-audio media packages to a specific track (see below)|
|force-target||presenter||Target track for the
* mandatory configuration key
audio-muxing parameter has three possible values:
none (same as omitting the option),
none is specified or the option is omitted, the audio stream is taken from the specified
source-flavor track and is
edited according to the selections in video editor’s “Tracks” panel. The resulting tracks are stored in the
target-tags are applied.
Note: If your editing results in a single video and single audio (track/stream) they will be muxed together even if
this option is set to
The parameter value
force only applies to media packages that have exactly one non-hidden audio stream. For media
packages without an audio stream or with more than one audio stream, the behavior is the same as if the parameter were
omitted. The same applies to media packages for which there is only one audio stream, and it already belongs to the
track with flavor type given by
presenter if that parameter is omitted).
If, however, there is only one non-hidden audio stream and it does not belong to the track given by
then the WOH will “move” the audio stream to this target track. Specifically, it will mux the video stream of
force-target with the audio stream it found. Then, it removes the audio stream from the original track.
For example, consider a media package with two tracks, presenter and presentation. Both of these tracks have audio components, however the presenter audio stream is hidden. This WOH will mux presentations's audio stream with presenter's video, and remove the audio track from presentation's video.
The parameter value
duplicate only applies to media packages that have exactly one non-hidden audio stream and no
hidden video streams. For these media packages, the WOH will mux the audio stream it found to all video streams in
the media package. For media packages without an audio stream or with more than one audio stream, the behavior is
the same as if the parameter were omitted.
<operation id="select-tracks" fail-on-error="true" exception-handler-workflow="partial-error" description="Select tracks for further processing"> <configurations> <configuration key="source-flavor">*/source</configuration> <configuration key="target-flavor">*/work</configuration> <configuration key="audio-muxing">force</configuration> </configurations> </operation>