Class AudioSelector

(experimental) An audio selector that identifies which audio to extract from the input.

Inheritance

AudioSelector

Namespace: Amazon.CDK.AWS.MediaLive.Alpha

Assembly: Amazon.CDK.AWS.MediaLive.Alpha.dll

Syntax (csharp)

public abstract class AudioSelector : DeputyBase

Syntax (vb)

Public MustInherit Class AudioSelector Inherits DeputyBase

Remarks

Stability: Experimental

ExampleMetadata: infused

Examples

Stack stack;
             IInput input;
             IBucket bucket;
             EncodeConfiguration video;


             new Channel(stack, "Channel", new ChannelProps {
                 Inputs = new [] { new InputAttachment {
                     Input = input,
                     AudioSelectors = new [] { AudioSelector.ByLanguage("eng", "eng", AudioLanguageSelectionPolicy.STRICT) },
                     CaptionSelectors = new [] { CaptionSelector.Embedded("embedded") },
                     VideoSelector = new VideoSelectorSettings {
                         ColorSpace = VideoColorSpace.HDR10,
                         ColorSpaceUsage = VideoColorSpaceUsage.FORCE,
                         SelectBy = VideoSelection.ByProgramId(1)
                     }
                 } },
                 OutputGroups = new [] { OutputGroupConfiguration.Hls(new HlsOutputGroupProps {
                     Name = "hls",
                     Destinations = new [] { OutputDestination.ToBucket(bucket, "live/stream") },
                     Outputs = new [] { new HlsOutputDefinition { Encodes = new [] { video }, OutputName = "hls_out" } }
                 }) }
             });

Synopsis

Constructors

AudioSelector(string)

(experimental) An audio selector that identifies which audio to extract from the input.

Properties

Name	(experimental) The name of this audio selector.

Methods

ByLanguage(string, string, AudioLanguageSelectionPolicy?)	(experimental) Select audio by language code.
ByPid(string, IAudioPidConfig[])	(experimental) Select one or more audio PIDs from the source.
ByTrack(string, IAudioTrackConfig[], DolbyEProgramSelection?)	(experimental) Select one or more audio tracks (1-based) from the source.
Default(string)	(experimental) Select the default audio track (no specific selector settings).
HlsRendition(string, IHlsRenditionSelectionOptions)	(experimental) Select an HLS audio rendition by its `#EXT-X-MEDIA` `GROUP-ID` and `NAME`.

Constructors

AudioSelector(string)

(experimental) An audio selector that identifies which audio to extract from the input.

protected AudioSelector(string name)

Parameters

name string

Remarks

Stability: Experimental

Properties

Name

(experimental) The name of this audio selector.

public virtual string Name { get; }

Property Value

string

Remarks

Reference it from features that monitor a specific selector, such as an audio-silence {@link FailoverCondition }.

Stability: Experimental

Methods

ByLanguage(string, string, AudioLanguageSelectionPolicy?)

(experimental) Select audio by language code.

public static AudioSelector ByLanguage(string name, string languageCode, AudioLanguageSelectionPolicy? languageSelectionPolicy = null)

Parameters

name string: a name for this selector.
languageCode string: the three-letter (ISO 639-2) language code to select.
languageSelectionPolicy AudioLanguageSelectionPolicy: how strictly to identify the stream by language on a PMT update.

Returns

AudioSelector

Remarks

Stability: Experimental

ByPid(string, IAudioPidConfig[])

(experimental) Select one or more audio PIDs from the source.

public static AudioSelector ByPid(string name, IAudioPidConfig[] pids)

Parameters

name string: a name for this selector.
pids IAudioPidConfig[]: the PID configurations (each with optional Dolby E decode and pre-mix settings).

Returns

AudioSelector

Remarks

Stability: Experimental

ByTrack(string, IAudioTrackConfig[], DolbyEProgramSelection?)

(experimental) Select one or more audio tracks (1-based) from the source.

public static AudioSelector ByTrack(string name, IAudioTrackConfig[] tracks, DolbyEProgramSelection? dolbyEProgramSelection = null)

Parameters

name string: a name for this selector.
tracks IAudioTrackConfig[]: the track configurations (each with optional pre-mix settings).
dolbyEProgramSelection DolbyEProgramSelection: which Dolby E program to decode from the selected track(s).

Returns

AudioSelector

Remarks

Stability: Experimental

Default(string)

(experimental) Select the default audio track (no specific selector settings).

public static AudioSelector Default(string name)

Parameters

name string

Returns

AudioSelector

Remarks

Stability: Experimental

HlsRendition(string, IHlsRenditionSelectionOptions)

(experimental) Select an HLS audio rendition by its #EXT-X-MEDIA GROUP-ID and NAME.

public static AudioSelector HlsRendition(string name, IHlsRenditionSelectionOptions options)

Parameters

name string: a name for this selector.
options IHlsRenditionSelectionOptions: the target rendition's group id and name.

Returns

AudioSelector

Remarks

Stability: Experimental