Experimental
@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.
AudioSelector Class
An audio selector that identifies which audio to extract from the input.
| Stability | Experimental |
|---|---|
| Source | lib/audio-selector.ts |
Example
ts
declare const stack: Stack;
declare const input: medialive.IInput;
declare const bucket: s3.IBucket;
declare const video: medialive.EncodeConfiguration;
new medialive.Channel(stack, 'Channel', {
inputs: [{
input,
audioSelectors: [
medialive.AudioSelector.byLanguage('eng', 'eng', medialive.AudioLanguageSelectionPolicy.STRICT),
],
captionSelectors: [
medialive.CaptionSelector.embedded('embedded'),
],
videoSelector: {
colorSpace: medialive.VideoColorSpace.HDR10,
colorSpaceUsage: medialive.VideoColorSpaceUsage.FORCE,
selectBy: medialive.VideoSelection.byProgramId(1),
},
}],
outputGroups: [
medialive.OutputGroupConfiguration.hls({
name: 'hls',
destinations: [medialive.OutputDestination.toBucket(bucket, 'live/stream')],
outputs: [{ encodes: [video], outputName: 'hls_out' }],
}),
],
});
python
# stack: Stack
# input: medialive.IInput
# bucket: s3.IBucket
# video: medialive.EncodeConfiguration
medialive.Channel(stack, "Channel",
inputs=[medialive.InputAttachment(
input=input,
audio_selectors=[
medialive.AudioSelector.by_language("eng", "eng", medialive.AudioLanguageSelectionPolicy.STRICT)
],
caption_selectors=[
medialive.CaptionSelector.embedded("embedded")
],
video_selector=medialive.VideoSelectorSettings(
color_space=medialive.VideoColorSpace.HDR10,
color_space_usage=medialive.VideoColorSpaceUsage.FORCE,
select_by=medialive.VideoSelection.by_program_id(1)
)
)],
output_groups=[
medialive.OutputGroupConfiguration.hls(
name="hls",
destinations=[medialive.OutputDestination.to_bucket(bucket, "live/stream")],
outputs=[medialive.HlsOutputDefinition(encodes=[video], output_name="hls_out")]
)
]
)
java
Stack stack;
IInput input;
IBucket bucket;
EncodeConfiguration video;
Channel.Builder.create(stack, "Channel")
.inputs(List.of(InputAttachment.builder()
.input(input)
.audioSelectors(List.of(AudioSelector.byLanguage("eng", "eng", AudioLanguageSelectionPolicy.STRICT)))
.captionSelectors(List.of(CaptionSelector.embedded("embedded")))
.videoSelector(VideoSelectorSettings.builder()
.colorSpace(VideoColorSpace.HDR10)
.colorSpaceUsage(VideoColorSpaceUsage.FORCE)
.selectBy(VideoSelection.byProgramId(1))
.build())
.build()))
.outputGroups(List.of(OutputGroupConfiguration.hls(HlsOutputGroupProps.builder()
.name("hls")
.destinations(List.of(OutputDestination.toBucket(bucket, "live/stream")))
.outputs(List.of(HlsOutputDefinition.builder().encodes(List.of(video)).outputName("hls_out").build()))
.build())))
.build();
csharp
// Install: dotnet add package Amazon.CDK.AWS.MediaLive.Alpha
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" } }
}) }
});
go
// Install: go get github.com/aws/aws-cdk-go/awsmedialivealpha/v2
var stack Stack
var input IInput
var bucket IBucket
var video EncodeConfiguration
medialive.NewChannel(stack, jsii.String("Channel"), &ChannelProps{
Inputs: []InputAttachment{
&InputAttachment{
Input: *Input,
AudioSelectors: []AudioSelector{
medialive.AudioSelector_ByLanguage(jsii.String("eng"), jsii.String("eng"), medialive.AudioLanguageSelectionPolicy_STRICT()),
},
CaptionSelectors: []CaptionSelector{
medialive.CaptionSelector_Embedded(jsii.String("embedded")),
},
VideoSelector: &VideoSelectorSettings{
ColorSpace: medialive.VideoColorSpace_HDR10(),
ColorSpaceUsage: medialive.VideoColorSpaceUsage_FORCE(),
SelectBy: medialive.VideoSelection_ByProgramId(jsii.Number(1)),
},
},
},
OutputGroups: []OutputGroupConfiguration{
medialive.OutputGroupConfiguration_Hls(&HlsOutputGroupProps{
Name: jsii.String("hls"),
Destinations: []OutputDestination{
medialive.OutputDestination_ToBucket(bucket, jsii.String("live/stream")),
},
Outputs: []HlsOutputDefinition{
&HlsOutputDefinition{
Encodes: []EncodeConfiguration{
video,
},
OutputName: jsii.String("hls_out"),
},
},
}),
},
})
Properties
The name of this audio selector.
Reference it from features that monitor a specific selector, such as an audio-silence {@link FailoverCondition }.
Methods
byLanguage(name: string, languageCode: string, languageSelectionPolicy?: AudioLanguageSelectionPolicy): AudioSelector // chainable@staticmethod def by_language(name: str, language_code: str, language_selection_policy: typing.Optional[AudioLanguageSelectionPolicy] = None) -> AudioSelectorpublic static AudioSelector byLanguage(String name, String languageCode, AudioLanguageSelectionPolicy languageSelectionPolicy)public static AudioSelector ByLanguage(string name, string languageCode, AudioLanguageSelectionPolicy? languageSelectionPolicy = null)func ByLanguage(Name *string, LanguageCode *string, LanguageSelectionPolicy AudioLanguageSelectionPolicy) AudioSelector static #Select audio by language code.
3 parameters
Parameters
namenamenamenameName— a name for this selector.languageCodelanguage_codelanguageCodelanguageCodeLanguageCode— the three-letter (ISO 639-2) language code to select.languageSelectionPolicylanguage_selection_policylanguageSelectionPolicylanguageSelectionPolicyLanguageSelectionPolicy— how strictly to identify the stream by language on a PMT update.
byPid(name: string, pids: AudioPidConfig[]): AudioSelector // chainable@staticmethod def by_pid(name: str, pids: typing.List[AudioPidConfig]) -> AudioSelectorpublic static AudioSelector byPid(String name, List<AudioPidConfig> pids)public static AudioSelector ByPid(string name, AudioPidConfig[] pids)func ByPid(Name *string, Pids *[]AudioPidConfig) AudioSelector static #Select one or more audio PIDs from the source.
2 parameters
Parameters
namenamenamenameName— a name for this selector.pidspidspidspidsPids— the PID configurations (each with optional Dolby E decode and pre-mix settings).
byTrack(name: string, tracks: AudioTrackConfig[], dolbyEProgramSelection?: DolbyEProgramSelection): AudioSelector // chainable@staticmethod def by_track(name: str, tracks: typing.List[AudioTrackConfig], dolby_e_program_selection: typing.Optional[DolbyEProgramSelection] = None) -> AudioSelectorpublic static AudioSelector byTrack(String name, List<AudioTrackConfig> tracks, DolbyEProgramSelection dolbyEProgramSelection)public static AudioSelector ByTrack(string name, AudioTrackConfig[] tracks, DolbyEProgramSelection? dolbyEProgramSelection = null)func ByTrack(Name *string, Tracks *[]AudioTrackConfig, DolbyEProgramSelection DolbyEProgramSelection) AudioSelector static #Select one or more audio tracks (1-based) from the source.
3 parameters
Parameters
namenamenamenameName— a name for this selector.trackstrackstrackstracksTracks— the track configurations (each with optional pre-mix settings).dolbyEProgramSelectiondolby_e_program_selectiondolbyEProgramSelectiondolbyEProgramSelectionDolbyEProgramSelection— which Dolby E program to decode from the selected track(s).
default(name: string): AudioSelector // chainable@staticmethod def default(name: str) -> AudioSelectorpublic static AudioSelector default(String name)public static AudioSelector Default(string name)func Default(Name *string) AudioSelector static #Select the default audio track (no specific selector settings).
hlsRendition(name: string, options: HlsRenditionSelectionOptions): AudioSelector // chainable@staticmethod def hls_rendition(name: str, options: HlsRenditionSelectionOptions) -> AudioSelectorpublic static AudioSelector hlsRendition(String name, HlsRenditionSelectionOptions options)public static AudioSelector HlsRendition(string name, HlsRenditionSelectionOptions options)func HlsRendition(Name *string, Options HlsRenditionSelectionOptions) AudioSelector static #Select an HLS audio rendition by its `#EXT-X-MEDIA` `GROUP-ID` and `NAME`.
2 parameters
Parameters
namenamenamenameName— a name for this selector.optionsoptionsoptionsoptionsOptions— the target rendition's group id and name.