@aws-cdk/aws-medialive-alpha.InputAttachment

Experimental

@aws-cdk/aws-medialive-alpha is an experimental (alpha) package: its API may change in any release, without a major version bump.

InputAttachment Struct

An input attachment definition for a channel.

Stability

Experimental

Source

lib/input-attachment.ts

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as medialive_alpha from '@aws-cdk/aws-medialive-alpha';
import * as cdk from 'aws-cdk-lib';

declare const audioSelector: medialive_alpha.AudioSelector;
declare const bitrate: cdk.Bitrate;
declare const captionSelector: medialive_alpha.CaptionSelector;
declare const failoverCondition: medialive_alpha.FailoverCondition;
declare const hlsScte35Source: medialive_alpha.HlsScte35Source;
declare const input: medialive_alpha.Input;
declare const inputFilter: medialive_alpha.InputFilter;
declare const inputPreference: medialive_alpha.InputPreference;
declare const serverValidation: medialive_alpha.ServerValidation;
declare const smpte2038DataPreference: medialive_alpha.Smpte2038DataPreference;
declare const sourceEndBehavior: medialive_alpha.SourceEndBehavior;
declare const videoColorSpace: medialive_alpha.VideoColorSpace;
declare const videoColorSpaceUsage: medialive_alpha.VideoColorSpaceUsage;
declare const videoSelection: medialive_alpha.VideoSelection;
const inputAttachment: medialive_alpha.InputAttachment = {
  input: input,

  // the properties below are optional
  audioSelectors: [audioSelector],
  automaticInputFailover: {
    secondaryInput: input,

    // the properties below are optional
    errorClearTime: cdk.Duration.minutes(30),
    failoverConditions: [failoverCondition],
    inputPreference: inputPreference,
  },
  captionSelectors: [captionSelector],
  deblockFilter: false,
  denoiseFilter: false,
  filterStrength: 123,
  inputAttachmentName: 'inputAttachmentName',
  inputFilter: inputFilter,
  logicalInterfaceNames: ['logicalInterfaceNames'],
  networkInputSettings: {
    hlsInputSettings: {
      bandwidth: bitrate,
      bufferSegments: 123,
      retries: 123,
      retryInterval: cdk.Duration.minutes(30),
      scte35Source: hlsScte35Source,
    },
    multicastSourceIp: 'multicastSourceIp',
    serverValidation: serverValidation,
  },
  scte35Pid: 123,
  smpte2038DataPreference: smpte2038DataPreference,
  sourceEndBehavior: sourceEndBehavior,
  videoSelector: {
    colorSpace: videoColorSpace,
    colorSpaceUsage: videoColorSpaceUsage,
    hdr10: {
      maxContentLightLevel: 123,
      maxFrameAverageLightLevel: 123,
    },
    selectBy: videoSelection,
  },
};

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_medialive_alpha as medialive_alpha
import aws_cdk as cdk

# audio_selector: medialive_alpha.AudioSelector
# bitrate: cdk.Bitrate
# caption_selector: medialive_alpha.CaptionSelector
# failover_condition: medialive_alpha.FailoverCondition
# hls_scte35_source: medialive_alpha.HlsScte35Source
# input: medialive_alpha.Input
# input_filter: medialive_alpha.InputFilter
# input_preference: medialive_alpha.InputPreference
# server_validation: medialive_alpha.ServerValidation
# smpte2038_data_preference: medialive_alpha.Smpte2038DataPreference
# source_end_behavior: medialive_alpha.SourceEndBehavior
# video_color_space: medialive_alpha.VideoColorSpace
# video_color_space_usage: medialive_alpha.VideoColorSpaceUsage
# video_selection: medialive_alpha.VideoSelection

input_attachment = medialive_alpha.InputAttachment(
    input=input,

    # the properties below are optional
    audio_selectors=[audio_selector],
    automatic_input_failover=medialive_alpha.AutomaticInputFailover(
        secondary_input=input,

        # the properties below are optional
        error_clear_time=cdk.Duration.minutes(30),
        failover_conditions=[failover_condition],
        input_preference=input_preference
    ),
    caption_selectors=[caption_selector],
    deblock_filter=False,
    denoise_filter=False,
    filter_strength=123,
    input_attachment_name="inputAttachmentName",
    input_filter=input_filter,
    logical_interface_names=["logicalInterfaceNames"],
    network_input_settings=medialive_alpha.NetworkInputSettings(
        hls_input_settings=medialive_alpha.HlsInputSettings(
            bandwidth=bitrate,
            buffer_segments=123,
            retries=123,
            retry_interval=cdk.Duration.minutes(30),
            scte35_source=hls_scte35_source
        ),
        multicast_source_ip="multicastSourceIp",
        server_validation=server_validation
    ),
    scte35_pid=123,
    smpte2038_data_preference=smpte2038_data_preference,
    source_end_behavior=source_end_behavior,
    video_selector=medialive_alpha.VideoSelectorSettings(
        color_space=video_color_space,
        color_space_usage=video_color_space_usage,
        hdr10=medialive_alpha.Hdr10Settings(
            max_content_light_level=123,
            max_frame_average_light_level=123
        ),
        select_by=video_selection
    )
)

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.medialive.alpha.*;
import software.amazon.awscdk.*;

AudioSelector audioSelector;
Bitrate bitrate;
CaptionSelector captionSelector;
FailoverCondition failoverCondition;
HlsScte35Source hlsScte35Source;
Input input;
InputFilter inputFilter;
InputPreference inputPreference;
ServerValidation serverValidation;
Smpte2038DataPreference smpte2038DataPreference;
SourceEndBehavior sourceEndBehavior;
VideoColorSpace videoColorSpace;
VideoColorSpaceUsage videoColorSpaceUsage;
VideoSelection videoSelection;

InputAttachment inputAttachment = InputAttachment.builder()
        .input(input)

        // the properties below are optional
        .audioSelectors(List.of(audioSelector))
        .automaticInputFailover(AutomaticInputFailover.builder()
                .secondaryInput(input)

                // the properties below are optional
                .errorClearTime(Duration.minutes(30))
                .failoverConditions(List.of(failoverCondition))
                .inputPreference(inputPreference)
                .build())
        .captionSelectors(List.of(captionSelector))
        .deblockFilter(false)
        .denoiseFilter(false)
        .filterStrength(123)
        .inputAttachmentName("inputAttachmentName")
        .inputFilter(inputFilter)
        .logicalInterfaceNames(List.of("logicalInterfaceNames"))
        .networkInputSettings(NetworkInputSettings.builder()
                .hlsInputSettings(HlsInputSettings.builder()
                        .bandwidth(bitrate)
                        .bufferSegments(123)
                        .retries(123)
                        .retryInterval(Duration.minutes(30))
                        .scte35Source(hlsScte35Source)
                        .build())
                .multicastSourceIp("multicastSourceIp")
                .serverValidation(serverValidation)
                .build())
        .scte35Pid(123)
        .smpte2038DataPreference(smpte2038DataPreference)
        .sourceEndBehavior(sourceEndBehavior)
        .videoSelector(VideoSelectorSettings.builder()
                .colorSpace(videoColorSpace)
                .colorSpaceUsage(videoColorSpaceUsage)
                .hdr10(Hdr10Settings.builder()
                        .maxContentLightLevel(123)
                        .maxFrameAverageLightLevel(123)
                        .build())
                .selectBy(videoSelection)
                .build())
        .build();

// Install: dotnet add package Amazon.CDK.AWS.MediaLive.Alpha
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.MediaLive.Alpha;
using Amazon.CDK;

AudioSelector audioSelector;
Bitrate bitrate;
CaptionSelector captionSelector;
FailoverCondition failoverCondition;
HlsScte35Source hlsScte35Source;
Input input;
InputFilter inputFilter;
InputPreference inputPreference;
ServerValidation serverValidation;
Smpte2038DataPreference smpte2038DataPreference;
SourceEndBehavior sourceEndBehavior;
VideoColorSpace videoColorSpace;
VideoColorSpaceUsage videoColorSpaceUsage;
VideoSelection videoSelection;

var inputAttachment = new InputAttachment {
    Input = input,

    // the properties below are optional
    AudioSelectors = new [] { audioSelector },
    AutomaticInputFailover = new AutomaticInputFailover {
        SecondaryInput = input,

        // the properties below are optional
        ErrorClearTime = Duration.Minutes(30),
        FailoverConditions = new [] { failoverCondition },
        InputPreference = inputPreference
    },
    CaptionSelectors = new [] { captionSelector },
    DeblockFilter = false,
    DenoiseFilter = false,
    FilterStrength = 123,
    InputAttachmentName = "inputAttachmentName",
    InputFilter = inputFilter,
    LogicalInterfaceNames = new [] { "logicalInterfaceNames" },
    NetworkInputSettings = new NetworkInputSettings {
        HlsInputSettings = new HlsInputSettings {
            Bandwidth = bitrate,
            BufferSegments = 123,
            Retries = 123,
            RetryInterval = Duration.Minutes(30),
            Scte35Source = hlsScte35Source
        },
        MulticastSourceIp = "multicastSourceIp",
        ServerValidation = serverValidation
    },
    Scte35Pid = 123,
    Smpte2038DataPreference = smpte2038DataPreference,
    SourceEndBehavior = sourceEndBehavior,
    VideoSelector = new VideoSelectorSettings {
        ColorSpace = videoColorSpace,
        ColorSpaceUsage = videoColorSpaceUsage,
        Hdr10 = new Hdr10Settings {
            MaxContentLightLevel = 123,
            MaxFrameAverageLightLevel = 123
        },
        SelectBy = videoSelection
    }
};

// Install: go get github.com/aws/aws-cdk-go/awsmedialivealpha/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import medialive_alpha "github.com/aws/aws-cdk-go/awsmedialivealpha"
import "github.com/aws/aws-cdk-go/awscdk"

var audioSelector AudioSelector
var bitrate Bitrate
var captionSelector CaptionSelector
var failoverCondition FailoverCondition
var hlsScte35Source HlsScte35Source
var input Input
var inputFilter InputFilter
var inputPreference InputPreference
var serverValidation ServerValidation
var smpte2038DataPreference Smpte2038DataPreference
var sourceEndBehavior SourceEndBehavior
var videoColorSpace VideoColorSpace
var videoColorSpaceUsage VideoColorSpaceUsage
var videoSelection VideoSelection

inputAttachment := &InputAttachment{
	Input: input,

	// the properties below are optional
	AudioSelectors: []AudioSelector{
		audioSelector,
	},
	AutomaticInputFailover: &AutomaticInputFailover{
		SecondaryInput: input,

		// the properties below are optional
		ErrorClearTime: cdk.Duration_Minutes(jsii.Number(30)),
		FailoverConditions: []FailoverCondition{
			failoverCondition,
		},
		InputPreference: inputPreference,
	},
	CaptionSelectors: []CaptionSelector{
		captionSelector,
	},
	DeblockFilter: jsii.Boolean(false),
	DenoiseFilter: jsii.Boolean(false),
	FilterStrength: jsii.Number(123),
	InputAttachmentName: jsii.String("inputAttachmentName"),
	InputFilter: inputFilter,
	LogicalInterfaceNames: []*string{
		jsii.String("logicalInterfaceNames"),
	},
	NetworkInputSettings: &NetworkInputSettings{
		HlsInputSettings: &HlsInputSettings{
			Bandwidth: bitrate,
			BufferSegments: jsii.Number(123),
			Retries: jsii.Number(123),
			RetryInterval: cdk.Duration_*Minutes(jsii.Number(30)),
			Scte35Source: hlsScte35Source,
		},
		MulticastSourceIp: jsii.String("multicastSourceIp"),
		ServerValidation: serverValidation,
	},
	Scte35Pid: jsii.Number(123),
	Smpte2038DataPreference: smpte2038DataPreference,
	SourceEndBehavior: sourceEndBehavior,
	VideoSelector: &VideoSelectorSettings{
		ColorSpace: videoColorSpace,
		ColorSpaceUsage: videoColorSpaceUsage,
		Hdr10: &Hdr10Settings{
			MaxContentLightLevel: jsii.Number(123),
			MaxFrameAverageLightLevel: jsii.Number(123),
		},
		SelectBy: videoSelection,
	},
}

Properties

audioSelectors?optionalAudioSelector[]audio_selectors?optionaltyping.List[AudioSelector]audioSelectors?optionalList<AudioSelector>AudioSelectors?optionalAudioSelector[]AudioSelectors?optional*[]AudioSelector#

Audio selectors to extract specific audio tracks from the input.

Default: no audio selectors (uses default audio)

automaticInputFailover?optionalAutomaticInputFailoverautomatic_input_failover?optionalAutomaticInputFailoverautomaticInputFailover?optionalAutomaticInputFailoverAutomaticInputFailover?optionalAutomaticInputFailoverAutomaticInputFailover?optionalAutomaticInputFailover#

Automatic input failover to a secondary input.

Default: no automatic input failover

When the active input meets any of the failover conditions, MediaLive switches to the secondary input without restarting the channel. This is input-source redundancy, distinct from the pipeline redundancy of ChannelClass.STANDARD.

captionSelectors?optionalCaptionSelector[]caption_selectors?optionaltyping.List[CaptionSelector]captionSelectors?optionalList<CaptionSelector>CaptionSelectors?optionalCaptionSelector[]CaptionSelectors?optional*[]CaptionSelector#

Caption selectors to extract specific caption tracks from the input.

Default: no caption selectors

deblockFilter?optionalbooleandeblock_filter?optionalbooldeblockFilter?optionalBooleanDeblockFilter?optionalboolDeblockFilter?optional*bool= false#

Whether to enable the deblock filter.

denoiseFilter?optionalbooleandenoise_filter?optionalbooldenoiseFilter?optionalBooleanDenoiseFilter?optionalboolDenoiseFilter?optional*bool= false#

Whether to enable the denoise filter.

filterStrength?optionalnumberfilter_strength?optionalint | floatfilterStrength?optionalNumberFilterStrength?optionaldoubleFilterStrength?optional*float64= 1#

The filter strength (1-5).

1 is minimal, 5 is strongest.

inputIInputinputIInputinputIInputInputIInputInputIInputrequired#

The input to attach.

[disable-awslint:prefer-ref-interface]

inputAttachmentName?optionalstringinput_attachment_name?optionalstrinputAttachmentName?optionalStringInputAttachmentName?optionalstringInputAttachmentName?optional*string= auto-generated#

A name for this input attachment, used to reference it in schedule actions.

inputFilter?optionalInputFilterinput_filter?optionalInputFilterinputFilter?optionalInputFilterInputFilter?optionalInputFilterInputFilter?optionalInputFilter= InputFilter.AUTO#

The input filter mode.

logicalInterfaceNames?optionalstring[]logical_interface_names?optionaltyping.List[str]logicalInterfaceNames?optionalList<String>LogicalInterfaceNames?optionalstring[]LogicalInterfaceNames?optional*[]*string#

The logical interface names (MediaLive Anywhere) this input is wired to.

Default: no logical interface names

Each name maps the input to a network interface on the channel's nodes.

networkInputSettings?optionalNetworkInputSettingsnetwork_input_settings?optionalNetworkInputSettingsnetworkInputSettings?optionalNetworkInputSettingsNetworkInputSettings?optionalNetworkInputSettingsNetworkInputSettings?optionalNetworkInputSettings#

Network input settings (for URL pull inputs — HLS buffer, server validation).

Default: no network input settings

scte35Pid?optionalnumberscte35_pid?optionalint | floatscte35Pid?optionalNumberScte35Pid?optionaldoubleScte35Pid?optional*float64= auto-detect#

The SCTE-35 PID override for this input.

smpte2038DataPreference?optionalSmpte2038DataPreferencesmpte2038_data_preference?optionalSmpte2038DataPreferencesmpte2038DataPreference?optionalSmpte2038DataPreferenceSmpte2038DataPreference?optionalSmpte2038DataPreferenceSmpte2038DataPreference?optionalSmpte2038DataPreference= Smpte2038DataPreference.IGNORE#

SMPTE-2038 ancillary data preference.

sourceEndBehavior?optionalSourceEndBehaviorsource_end_behavior?optionalSourceEndBehaviorsourceEndBehavior?optionalSourceEndBehaviorSourceEndBehavior?optionalSourceEndBehaviorSourceEndBehavior?optionalSourceEndBehavior#

The source end behavior for file-based inputs.

Default: SourceEndBehavior.LOOP for MP4 and TS file inputs, SourceEndBehavior.CONTINUE for all others

videoSelector?optionalVideoSelectorSettingsvideo_selector?optionalVideoSelectorSettingsvideoSelector?optionalVideoSelectorSettingsVideoSelector?optionalVideoSelectorSettingsVideoSelector?optionalVideoSelectorSettings#

Video selector settings for the input (color space, PID selection).

Default: no video selector (use default video)