interface InputAttachment
| Language | Type name |
|---|---|
 .NET | Amazon.CDK.AWS.MediaLive.Alpha.InputAttachment |
 Go | github.com/aws/aws-cdk-go/awsmedialivealpha/v2#InputAttachment |
 Java | software.amazon.awscdk.services.medialive.alpha.InputAttachment |
 Python | aws_cdk.aws_medialive_alpha.InputAttachment |
 TypeScript (source) | @aws-cdk/aws-medialive-alpha » InputAttachment |
An input attachment definition for a channel.
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,
},
};
Properties
| Name | Type | Description |
|---|---|---|
| input | IInput | The input to attach. |
| audio | Audio[] | Audio selectors to extract specific audio tracks from the input. |
| automatic | Automatic | Automatic input failover to a secondary input. |
| caption | Caption[] | Caption selectors to extract specific caption tracks from the input. |
| deblock | boolean | Whether to enable the deblock filter. |
| denoise | boolean | Whether to enable the denoise filter. |
| filter | number | The filter strength (1-5). |
| input | string | A name for this input attachment, used to reference it in schedule actions. |
| input | Input | The input filter mode. |
| logical | string[] | The logical interface names (MediaLive Anywhere) this input is wired to. |
| network | Network | Network input settings (for URL pull inputs — HLS buffer, server validation). |
| scte35 | number | The SCTE-35 PID override for this input. |
| smpte2038 | Smpte2038 | SMPTE-2038 ancillary data preference. |
| source | Source | The source end behavior for file-based inputs. |
| video | Video | Video selector settings for the input (color space, PID selection). |
input
Type:
IInput
The input to attach.
[disable-awslint:prefer-ref-interface]
audioSelectors?
Type:
Audio[]
(optional, default: no audio selectors (uses default audio))
Audio selectors to extract specific audio tracks from the input.
automaticInputFailover?
Type:
Automatic
(optional, default: no automatic input failover)
Automatic input failover to a secondary input.
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?
Type:
Caption[]
(optional, default: no caption selectors)
Caption selectors to extract specific caption tracks from the input.
deblockFilter?
Type:
boolean
(optional, default: false)
Whether to enable the deblock filter.
denoiseFilter?
Type:
boolean
(optional, default: false)
Whether to enable the denoise filter.
filterStrength?
Type:
number
(optional, default: 1)
The filter strength (1-5).
1 is minimal, 5 is strongest.
inputAttachmentName?
Type:
string
(optional, default: auto-generated)
A name for this input attachment, used to reference it in schedule actions.
inputFilter?
Type:
Input
(optional, default: InputFilter.AUTO)
The input filter mode.
logicalInterfaceNames?
Type:
string[]
(optional, default: no logical interface names)
The logical interface names (MediaLive Anywhere) this input is wired to.
Each name maps the input to a network interface on the channel's nodes.
networkInputSettings?
Type:
Network
(optional, default: no network input settings)
Network input settings (for URL pull inputs — HLS buffer, server validation).
scte35Pid?
Type:
number
(optional, default: auto-detect)
The SCTE-35 PID override for this input.
smpte2038DataPreference?
Type:
Smpte2038
(optional, default: Smpte2038DataPreference.IGNORE)
SMPTE-2038 ancillary data preference.
sourceEndBehavior?
Type:
Source
(optional, default: SourceEndBehavior.LOOP for MP4 and TS file inputs, SourceEndBehavior.CONTINUE for all others)
The source end behavior for file-based inputs.
videoSelector?
Type:
Video
(optional, default: no video selector (use default video))
Video selector settings for the input (color space, PID selection).