Package org.opencastproject.composer.impl

Class ComposerServiceImpl

java.lang.Object

org.opencastproject.job.api.AbstractJobProducer

org.opencastproject.composer.impl.ComposerServiceImpl

All Implemented Interfaces:

ComposerService, JobProducer, org.osgi.service.cm.ManagedService

public class ComposerServiceImpl
extends AbstractJobProducer
implements ComposerService, org.osgi.service.cm.ManagedService

FFMPEG based implementation of the composer service api.

Field Summary

Fields

Modifier and Type	Field	Description
static final float	DEFAULT_JOB_LOAD_MAX_MULTIPLE_PROFILES	The maximum job load allowed for operations that use multiple profile (ProcessSmil, MultiEncode)
static final int	DEFAULT_MULTI_ENCODE_FADE_MILLISECONDS
static final float	DEFAULT_MULTI_ENCODE_JOB_LOAD_FACTOR
static final int	DEFAULT_MULTI_ENCODE_TRIM_MILLISECONDS
static final float	DEFAULT_PROCESS_SMIL_CLIP_TRANSITION_DURATION	default transition duration for process_smil in seconds
static final float	DEFAULT_PROCESS_SMIL_JOB_LOAD_FACTOR	The default factor used to multiply the sum of encoding profiles load job for ProcessSmil
static final String	JOB_LOAD_FACTOR_MULTI_ENCODE
static final String	JOB_LOAD_FACTOR_PROCESS_SMIL
static final String	JOB_LOAD_MAX_MULTIPLE_PROFILES
static final String	MULTI_ENCODE_FADE_MILLISECONDS
static final String	MULTI_ENCODE_TRIM_MILLISECONDS
static final String	PROCESS_SMIL_CLIP_TRANSITION_DURATION	Configuration for process-smil transition duration

Fields inherited from class org.opencastproject.job.api.AbstractJobProducer

ACCEPT_JOB_LOADS_EXCEEDING_PROPERTY, acceptJobLoadsExeedingMaxLoad, DEFAULT_ACCEPT_JOB_LOADS_EXCEEDING, executor, jobType

Fields inherited from interface org.opencastproject.composer.api.ComposerService

AUDIO_ONLY, BOTH, JOB_TYPE, LOWER, UPPER, VIDEO_ONLY

Constructor Summary

Constructors

Constructor	Description
ComposerServiceImpl()	Creates a new composer service instance.

Method Summary

Modifier and Type	Method	Description
void	activate(org.osgi.service.component.ComponentContext cc)	OSGi callback on component activation.
Job	composite(Dimension compositeTrackSize, Option<LaidOutElement<Track>> upperTrack, LaidOutElement<Track> lowerTrack, Option<LaidOutElement<Attachment>> watermark, String profileId, String background, String sourceAudioName)	Compose two videos into one with an optional watermark.
Job	concat(String profileId, Dimension outputDimension, boolean sameCodec, Track... tracks)	Concat multiple tracks to a single track.
Job	concat(String profileId, Dimension outputDimension, float outputFrameRate, boolean sameCodec, Track... tracks)	Concat multiple tracks to a single track.
Job	convertImage(Attachment image, String... profileIds)	Converts the given image to a different image format using the specified image profiles.
List<Attachment>	convertImageSync(Attachment image, String... profileIds)	Synchronously converts the given image to different image formats using the specified encoding profiles.
void	deactivate()	OSGi callback on component deactivation.
Job	demux(Track sourceTrack, String profileId)	Demux a multi-track source into 2 media as defined by the encoding profile, the results are flavored and tagged positionally. eg: One ffmpeg operation to produce presenter/work and presentation/work
Job	encode(Track sourceTrack, String profileId)	Encode one track, using that track's audio and video streams.
protected OrganizationDirectoryService	getOrganizationDirectoryService()	Returns a reference to the organization directory service.
EncodingProfile	getProfile(String profileId)	Gets a profile by its ID
protected SecurityService	getSecurityService()	Returns a reference to the security service
protected ServiceRegistry	getServiceRegistry()	Returns a reference to the service registry.
protected UserDirectoryService	getUserDirectoryService()	Returns a reference to the user directory service
protected void	hlsFixReference(long id, List<File> outputs)
protected void	hlsSetReference(Track track)
Job	image(Track sourceTrack, String profileId, double... times)	Extracts an image from the media package element identified by sourceVideoTrackId.
Job	image(Track sourceTrack, String profileId, Map<String,String> properties)	Extracts an image from the media package element identified by sourceTrack.
List<Attachment>	imageSync(Track sourceTrack, String profileId, double... time)	Synchronously extracts images from the source track.
Job	imageToVideo(Attachment sourceImageAttachment, String profileId, double time)	Transforms an image attachment to a video track
protected Track	inspect(Job job, URI workspaceURI)
protected List<Track>	inspect(Job job, List<URI> uris)
protected List<Track>	inspect(Job job, List<URI> uris, List<List<String>> tags)
EncodingProfile[]	listProfiles()
void	modified(Map<String,Object> config)	OSGI callback when the configuration is updated.
protected List<Track>	multiEncode(Job job, Track track, List<String> profileIds)	A single encoding process that produces multiple outputs from a single track(s) using a list of encoding profiles.
Job	multiEncode(Track sourceTrack, List<String> profileIds)	Encodes a track to set of media targets as defined by a list of encoding profiles
Job	mux(Map<String,Track> sourceTracks, String profileId)	Mux multiple tracks into a new Track.
Job	mux(Track videoTrack, Track audioTrack, String profileId)	Encode the video stream from one track and the audio stream from another, into a new Track.
Job	parallelEncode(Track sourceTrack, String profileId)	Encode one track to multiple other tracks in one encoding operation, using that track's audio and video streams.
protected String	process(Job job)	Asks the overriding class to process the arguments using the given operation.
protected List<Track>	processSmil(Job job, Smil smil, String trackParamGroupId, String mediaType, List<String> encodingProfiles)	Splice segments given by smil document for the given track to the new one.
Job	processSmil(Smil smil, String trackparamId, String mediaType, List<String> profileIds)	ProcessSmil processes editing of one source group (which may contain multiple source tracks) to one set of outputs (to one or more encoding profiles).
void	setEncodingProfileReadinessIndicator(ReadinessIndicator unused)
protected void	setMediaInspectionService(MediaInspectionService mediaInspectionService)	Sets the media inspection service
void	setOrganizationDirectoryService(OrganizationDirectoryService organizationDirectory)	Sets a reference to the organization directory service.
protected void	setProfileScanner(EncodingProfileScanner scanner)	Sets the profile scanner.
void	setSecurityService(SecurityService securityService)	Callback for setting the security service.
protected void	setServiceRegistry(ServiceRegistry serviceRegistry)	Sets the service registry
void	setSmilService(SmilService smilService)
void	setUserDirectoryService(UserDirectoryService userDirectoryService)	Callback for setting the user directory service.
protected void	setWorkspace(Workspace workspace)	Sets the workspace
Job	trim(Track sourceTrack, String profileId, long start, long duration)	Trims the given track to the given start time and duration.
void	updated(Dictionary<String,?> properties)

Methods inherited from class org.opencastproject.job.api.AbstractJobProducer

acceptJob, countJobs, finallyUpdateJob, getJobType, incident, isReadyToAccept, isReadyToAcceptJobs

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

PROCESS_SMIL_CLIP_TRANSITION_DURATION

public static final String PROCESS_SMIL_CLIP_TRANSITION_DURATION

Configuration for process-smil transition duration

See Also:

• Constant Field Values

DEFAULT_PROCESS_SMIL_CLIP_TRANSITION_DURATION

public static final float DEFAULT_PROCESS_SMIL_CLIP_TRANSITION_DURATION

default transition duration for process_smil in seconds

See Also:

• Constant Field Values

DEFAULT_JOB_LOAD_MAX_MULTIPLE_PROFILES

public static final float DEFAULT_JOB_LOAD_MAX_MULTIPLE_PROFILES

The maximum job load allowed for operations that use multiple profile (ProcessSmil, MultiEncode)

See Also:

• Constant Field Values

DEFAULT_PROCESS_SMIL_JOB_LOAD_FACTOR

public static final float DEFAULT_PROCESS_SMIL_JOB_LOAD_FACTOR

The default factor used to multiply the sum of encoding profiles load job for ProcessSmil

See Also:

• Constant Field Values

DEFAULT_MULTI_ENCODE_JOB_LOAD_FACTOR

public static final float DEFAULT_MULTI_ENCODE_JOB_LOAD_FACTOR

See Also:

• Constant Field Values

JOB_LOAD_MAX_MULTIPLE_PROFILES

public static final String JOB_LOAD_MAX_MULTIPLE_PROFILES

See Also:

• Constant Field Values

JOB_LOAD_FACTOR_PROCESS_SMIL

public static final String JOB_LOAD_FACTOR_PROCESS_SMIL

See Also:

• Constant Field Values

JOB_LOAD_FACTOR_MULTI_ENCODE

public static final String JOB_LOAD_FACTOR_MULTI_ENCODE

See Also:

• Constant Field Values

DEFAULT_MULTI_ENCODE_TRIM_MILLISECONDS

public static final int DEFAULT_MULTI_ENCODE_TRIM_MILLISECONDS

See Also:

• Constant Field Values

MULTI_ENCODE_TRIM_MILLISECONDS

public static final String MULTI_ENCODE_TRIM_MILLISECONDS

See Also:

• Constant Field Values

DEFAULT_MULTI_ENCODE_FADE_MILLISECONDS

public static final int DEFAULT_MULTI_ENCODE_FADE_MILLISECONDS

See Also:

• Constant Field Values

MULTI_ENCODE_FADE_MILLISECONDS

public static final String MULTI_ENCODE_FADE_MILLISECONDS

See Also:

• Constant Field Values

Constructor Details

ComposerServiceImpl

public ComposerServiceImpl()

Creates a new composer service instance.

Method Details

activate

public void activate(org.osgi.service.component.ComponentContext cc)

OSGi callback on component activation.

Overrides:

activate in class AbstractJobProducer

Parameters:

cc - the component context

deactivate

public void deactivate()

OSGi callback on component deactivation.

encode

public Job encode(Track sourceTrack,
 String profileId)
           throws EncoderException,
MediaPackageException

Encode one track, using that track's audio and video streams.

Specified by:

encode in interface ComposerService

Parameters:

sourceTrack - The source track

profileId - The profile to use for encoding

Returns:

The receipt for this encoding job. The receipt can be used with ComposerService#getJob to obtain the status of an encoding job.

Throws:

EncoderException

MediaPackageException

See Also:

• ComposerService.encode(org.opencastproject.mediapackage.Track, java.lang.String)

parallelEncode

public Job parallelEncode(Track sourceTrack,
 String profileId)
                   throws EncoderException,
MediaPackageException

Encode one track to multiple other tracks in one encoding operation, using that track's audio and video streams.

Specified by:

parallelEncode in interface ComposerService

Parameters:

sourceTrack - The source track

profileId - The profile to use for encoding

Throws:

EncoderException

MediaPackageException

See Also:

• ComposerService.encode(org.opencastproject.mediapackage.Track, java.lang.String)

trim

public Job trim(Track sourceTrack,
 String profileId,
 long start,
 long duration)
         throws EncoderException,
MediaPackageException

Trims the given track to the given start time and duration.

Specified by:

trim in interface ComposerService

Parameters:

sourceTrack - The source track

profileId - The profile to use for trimming

start - start time in miliseconds

duration - duration in miliseconds

Returns:

The receipt for this encoding job. The receipt can be used with ComposerService#getJob to obtain the status of an encoding job.

Throws:

EncoderException - if trimming fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.trim(org.opencastproject.mediapackage.Track, java.lang.String, long, long)

mux

public Job mux(Track videoTrack,
 Track audioTrack,
 String profileId)
        throws EncoderException,
MediaPackageException

Encode the video stream from one track and the audio stream from another, into a new Track.

Specified by:

mux in interface ComposerService

Parameters:

videoTrack - The source video track

audioTrack - The source audio track

profileId - The profile to use for encoding

Returns:

The receipt for this encoding job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.mux(org.opencastproject.mediapackage.Track, org.opencastproject.mediapackage.Track, java.lang.String)

mux

public Job mux(Map<String,Track> sourceTracks,
 String profileId)
        throws EncoderException,
MediaPackageException

Mux multiple tracks into a new Track.

Specified by:

mux in interface ComposerService

Parameters:

sourceTracks - The source tracks

profileId - The profile to use for encoding

Returns:

The receipt for this encoding job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.mux(Map, String)

composite

public Job composite(Dimension compositeTrackSize,
 Option<LaidOutElement<Track>> upperTrack,
 LaidOutElement<Track> lowerTrack,
 Option<LaidOutElement<Attachment>> watermark,
 String profileId,
 String background,
 String sourceAudioName)
              throws EncoderException,
MediaPackageException

Compose two videos into one with an optional watermark.

Specified by:

composite in interface ComposerService

Parameters:

compositeTrackSize - The composite track dimension

upperTrack - upper track element from mediapackage (optional)

lowerTrack - lower track element from mediapackage

watermark - watermark element (optional)

profileId - Encoding profile name

background - The background color

sourceAudioName - Use audio from only lower or upper track or both, use both when available if omitted

Returns:

The receipt for this composite job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

concat

public Job concat(String profileId,
 Dimension outputDimension,
 boolean sameCodec,
 Track... tracks)
           throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Concat multiple tracks to a single track.

Specified by:

concat in interface ComposerService

Parameters:

profileId - The encoding profile to use

outputDimension - The output dimensions

sameCodec - Defines if lossless concat should be used

tracks - an array of track to concat in order of the array

Returns:

The receipt for this concat job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

concat

public Job concat(String profileId,
 Dimension outputDimension,
 float outputFrameRate,
 boolean sameCodec,
 Track... tracks)
           throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Concat multiple tracks to a single track. Required ffmpeg version 1.1

Specified by:

concat in interface ComposerService

Parameters:

profileId - The encoding profile to use

outputDimension - The output dimensions

outputFrameRate - The output frame rate

sameCodec - Defines if lossless concat should be used

tracks - an array of track to concat in order of the array

Returns:

The receipt for this concat job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

imageToVideo

public Job imageToVideo(Attachment sourceImageAttachment,
 String profileId,
 double time)
                 throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Transforms an image attachment to a video track

Specified by:

imageToVideo in interface ComposerService

Parameters:

sourceImageAttachment - The source image attachment

profileId - The profile to use for encoding

time - the length of the resulting video track in seconds

Returns:

The receipt for this image to video job

Throws:

EncoderException - if encoding fails

MediaPackageException - if the mediapackage is invalid

image

public Job image(Track sourceTrack,
 String profileId,
 double... times)
          throws EncoderException,
MediaPackageException

Extracts an image from the media package element identified by sourceVideoTrackId. The image is taken at the timepoint time seconds into the movie.

Specified by:

image in interface ComposerService

Parameters:

sourceTrack - the source video track

profileId - identifier of the encoding profile

times - number of seconds into the video

Returns:

the extracted image as an attachment

Throws:

EncoderException - if image extraction fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.image(Track, String, double...)

imageSync

public List<Attachment> imageSync(Track sourceTrack,
 String profileId,
 double... time)
                           throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Synchronously extracts images from the source track. The images are taken at the given timepoints (seconds into the movie). Please note that synchronously doing this means, that the workload cannot be distributed amongst all nodes. This should be used rarely.

Specified by:

imageSync in interface ComposerService

Parameters:

sourceTrack - the source video track

profileId - identifier of the encoding profile

time - number of seconds into the video

Returns:

the extracted images as attachments

Throws:

EncoderException - if image extraction fails

MediaPackageException - if the mediapackage is invalid

image

public Job image(Track sourceTrack,
 String profileId,
 Map<String,String> properties)
          throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Extracts an image from the media package element identified by sourceTrack. The image is taken by the given properties and the corresponding encoding profile.

Specified by:

image in interface ComposerService

Parameters:

sourceTrack - the source video track

profileId - identifier of the encoding profile

properties - the properties applied to the encoding profile

Returns:

the extracted image as an attachment

Throws:

EncoderException - if image extraction fails

MediaPackageException - if the mediapackage is invalid

convertImage

public Job convertImage(Attachment image,
 String... profileIds)
                 throws EncoderException,
MediaPackageException

Converts the given image to a different image format using the specified image profiles.

Specified by:

convertImage in interface ComposerService

Parameters:

image - the image

profileIds - the profiles to use for conversion

Returns:

the job for the image conversion

Throws:

EncoderException - if image conversion fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.convertImage(org.opencastproject.mediapackage.Attachment, java.lang.String...)

convertImageSync

public List<Attachment> convertImageSync(Attachment image,
 String... profileIds)
                                  throws EncoderException,
MediaPackageException

Synchronously converts the given image to different image formats using the specified encoding profiles. Please note that synchronously doing this means that the workload cannot be distributed amongst all nodes.

Specified by:

convertImageSync in interface ComposerService

Parameters:

image - the image

profileIds - the profiles to use for conversion

Returns:

the converted images

Throws:

EncoderException - if image conversion fails

MediaPackageException - if the mediapackage is invalid

See Also:

• ComposerService.convertImageSync(org.opencastproject.mediapackage.Attachment, java.lang.String...)

process

protected String process(Job job)
                  throws ServiceRegistryException

Asks the overriding class to process the arguments using the given operation. The result will be added to the associated job as the payload.

Specified by:

process in class AbstractJobProducer

Parameters:

job - the job to process

Returns:

the operation result

Throws:

ServiceRegistryException

See Also:

• AbstractJobProducer.process(org.opencastproject.job.api.Job)

listProfiles

public EncodingProfile[] listProfiles()

Specified by:

listProfiles in interface ComposerService

Returns:

All registered EncodingProfiles.

See Also:

• ComposerService.listProfiles()

getProfile

public EncodingProfile getProfile(String profileId)

Gets a profile by its ID

Specified by:

getProfile in interface ComposerService

Parameters:

profileId - The profile ID

Returns:

The encoding profile, or null if no profile is registered with that ID

See Also:

• ComposerService.getProfile(java.lang.String)

inspect

protected List<Track> inspect(Job job,
 List<URI> uris,
 List<List<String>> tags)
                       throws EncoderException

Throws:

EncoderException

inspect

protected List<Track> inspect(Job job,
 List<URI> uris)
                       throws EncoderException

Throws:

EncoderException

inspect

protected Track inspect(Job job,
 URI workspaceURI)
                 throws EncoderException

Throws:

EncoderException

hlsFixReference

protected void hlsFixReference(long id,
 List<File> outputs)
                        throws IOException

Throws:

IOException

hlsSetReference

protected void hlsSetReference(Track track)
                        throws IOException

Throws:

IOException

setMediaInspectionService

protected void setMediaInspectionService(MediaInspectionService mediaInspectionService)

Sets the media inspection service

Parameters:

mediaInspectionService - an instance of the media inspection service

setWorkspace

protected void setWorkspace(Workspace workspace)

Sets the workspace

Parameters:

workspace - an instance of the workspace

setServiceRegistry

protected void setServiceRegistry(ServiceRegistry serviceRegistry)

Sets the service registry

Parameters:

serviceRegistry - the service registry

getServiceRegistry

protected ServiceRegistry getServiceRegistry()

Returns a reference to the service registry.

Specified by:

getServiceRegistry in class AbstractJobProducer

Returns:

the service registry

See Also:

• AbstractJobProducer.getServiceRegistry()

setProfileScanner

protected void setProfileScanner(EncodingProfileScanner scanner)

Sets the profile scanner.

Parameters:

scanner - the profile scanner

setSecurityService

public void setSecurityService(SecurityService securityService)

Callback for setting the security service.

Parameters:

securityService - the securityService to set

setUserDirectoryService

public void setUserDirectoryService(UserDirectoryService userDirectoryService)

Callback for setting the user directory service.

Parameters:

userDirectoryService - the userDirectoryService to set

setOrganizationDirectoryService

public void setOrganizationDirectoryService(OrganizationDirectoryService organizationDirectory)

Sets a reference to the organization directory service.

Parameters:

organizationDirectory - the organization directory

getSecurityService

protected SecurityService getSecurityService()

Returns a reference to the security service

Specified by:

getSecurityService in class AbstractJobProducer

Returns:

the security service

See Also:

• AbstractJobProducer.getSecurityService()

setSmilService

public void setSmilService(SmilService smilService)

getUserDirectoryService

protected UserDirectoryService getUserDirectoryService()

Returns a reference to the user directory service

Specified by:

getUserDirectoryService in class AbstractJobProducer

Returns:

the user directory service

See Also:

• AbstractJobProducer.getUserDirectoryService()

getOrganizationDirectoryService

protected OrganizationDirectoryService getOrganizationDirectoryService()

Returns a reference to the organization directory service.

Specified by:

getOrganizationDirectoryService in class AbstractJobProducer

Returns:

the organization directory service

See Also:

• AbstractJobProducer.getOrganizationDirectoryService()

setEncodingProfileReadinessIndicator

public void setEncodingProfileReadinessIndicator(ReadinessIndicator unused)

demux

public Job demux(Track sourceTrack,
 String profileId)
          throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Demux a multi-track source into 2 media as defined by the encoding profile, the results are flavored and tagged positionally. eg: One ffmpeg operation to produce presenter/work and presentation/work

Specified by:

demux in interface ComposerService

Parameters:

sourceTrack -

profileId -

Returns:

Receipt for this demux based on the profile

Throws:

EncoderException

MediaPackageException

modified

public void modified(Map<String,Object> config)
              throws org.osgi.service.cm.ConfigurationException

OSGI callback when the configuration is updated. This method is only here to prevent the configuration admin service from calling the service deactivate and activate methods for a config update. It does not have to do anything as the updates are handled by updated().

Throws:

org.osgi.service.cm.ConfigurationException

updated

public void updated(Dictionary<String,?> properties)
             throws org.osgi.service.cm.ConfigurationException

Specified by:

updated in interface org.osgi.service.cm.ManagedService

Throws:

org.osgi.service.cm.ConfigurationException

processSmil

public Job processSmil(Smil smil,
 String trackparamId,
 String mediaType,
 List<String> profileIds)
                throws EncoderException,
MediaPackageException

ProcessSmil processes editing of one source group (which may contain multiple source tracks) to one set of outputs (to one or more encoding profiles). Note that the source tracks are expected to have the same dimensions.

Specified by:

processSmil in interface ComposerService

Parameters:

smil - - smil containing with video names and clip sections from them

trackparamId - - group id

mediaType - - VIDEO_ONLY, AUDIO_ONLY, or "" if neither is true

profileIds - - list of encoding profile Ids

Returns:

Compose Job

Throws:

EncoderException - - if encoding fails

MediaPackageException - - if missing files or bad mp

processSmil

protected List<Track> processSmil(Job job,
 Smil smil,
 String trackParamGroupId,
 String mediaType,
 List<String> encodingProfiles)
                           throws EncoderException,
MediaPackageException,
URISyntaxException

Splice segments given by smil document for the given track to the new one. This function reads the smil file and reduce them to arguments to send to the encoder

Parameters:

job - processing job

smil - smil document with media segments description

trackParamGroupId - source track group

mediaType - VIDEO_ONLY or AUDIO_ONLY or "" if it has both

encodingProfiles - - profiles

Returns:

serialized array of processed tracks

Throws:

EncoderException - if an error occurred

MediaPackageException - - bad Mediapackage

URISyntaxException

multiEncode

public Job multiEncode(Track sourceTrack,
 List<String> profileIds)
                throws EncoderException,
MediaPackageException

Description copied from interface: ComposerService

Encodes a track to set of media targets as defined by a list of encoding profiles

Specified by:

multiEncode in interface ComposerService

Parameters:

sourceTrack - - video or audio track

profileIds - - a list of encoding profiles by name

Returns:

Receipt for this processing based on the inputs

Throws:

EncoderException - if it fails

MediaPackageException - if adding files to a mediapackage produces errors

multiEncode

protected List<Track> multiEncode(Job job,
 Track track,
 List<String> profileIds)
                           throws EncoderException,
IllegalArgumentException

A single encoding process that produces multiple outputs from a single track(s) using a list of encoding profiles. Each output can be tagged by the profile name. This supports adaptive bitrate outputs.

Parameters:

job - - encoding job

track - - source track

profileIds - - list of encoding profile Ids, can include one adaptive profile

Returns:

encoded files

Throws:

EncoderException - - if can't encode

IllegalArgumentException - - if missing arguments