InputAttachment

class aws_cdk.aws_medialive_alpha.InputAttachment(*, input, audio_selectors=None, automatic_input_failover=None, caption_selectors=None, deblock_filter=None, denoise_filter=None, filter_strength=None, input_attachment_name=None, input_filter=None, logical_interface_names=None, network_input_settings=None, scte35_pid=None, smpte2038_data_preference=None, source_end_behavior=None, video_selector=None)

Bases: object

(experimental) An input attachment definition for a channel.

Parameters:

input (IInput) – (experimental) The input to attach. [disable-awslint:prefer-ref-interface]
audio_selectors (Optional[Sequence[AudioSelector]]) – (experimental) Audio selectors to extract specific audio tracks from the input. Default: - no audio selectors (uses default audio)
automatic_input_failover (Union[AutomaticInputFailover, Dict[str, Any], None]) – (experimental) 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. Default: - no automatic input failover
caption_selectors (Optional[Sequence[CaptionSelector]]) – (experimental) Caption selectors to extract specific caption tracks from the input. Default: - no caption selectors
deblock_filter (Optional[bool]) – (experimental) Whether to enable the deblock filter. Default: false
denoise_filter (Optional[bool]) – (experimental) Whether to enable the denoise filter. Default: false
filter_strength (Union[int, float, None]) – (experimental) The filter strength (1-5). 1 is minimal, 5 is strongest. Default: 1
input_attachment_name (Optional[str]) – (experimental) A name for this input attachment, used to reference it in schedule actions. Default: - auto-generated
input_filter (Optional[InputFilter]) – (experimental) The input filter mode. Default: InputFilter.AUTO
logical_interface_names (Optional[Sequence[str]]) – (experimental) 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. Default: - no logical interface names
network_input_settings (Union[NetworkInputSettings, Dict[str, Any], None]) – (experimental) Network input settings (for URL pull inputs — HLS buffer, server validation). Default: - no network input settings
scte35_pid (Union[int, float, None]) – (experimental) The SCTE-35 PID override for this input. Default: - auto-detect
smpte2038_data_preference (Optional[Smpte2038DataPreference]) – (experimental) SMPTE-2038 ancillary data preference. Default: Smpte2038DataPreference.IGNORE
source_end_behavior (Optional[SourceEndBehavior]) – (experimental) The source end behavior for file-based inputs. Default: SourceEndBehavior.LOOP for MP4 and TS file inputs, SourceEndBehavior.CONTINUE for all others
video_selector (Union[VideoSelectorSettings, Dict[str, Any], None]) – (experimental) Video selector settings for the input (color space, PID selection). Default: - no video selector (use default video)

Stability:

experimental

ExampleMetadata:

fixture=_generated

Example:

# 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
    )
)

Attributes

audio_selectors

(experimental) Audio selectors to extract specific audio tracks from the input.

Default:

no audio selectors (uses default audio)

Stability:

experimental

automatic_input_failover

(experimental) 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.

Default:

no automatic input failover

Stability:

experimental

caption_selectors

(experimental) Caption selectors to extract specific caption tracks from the input.

Default:

no caption selectors

Stability:

experimental

deblock_filter

(experimental) Whether to enable the deblock filter.

Default:: false
Stability:: experimental

denoise_filter

(experimental) Whether to enable the denoise filter.

Default:: false
Stability:: experimental

filter_strength

(experimental) The filter strength (1-5).

1 is minimal, 5 is strongest.

Default:: 1
Stability:: experimental

input

(experimental) The input to attach.

[disable-awslint:prefer-ref-interface]

Stability:: experimental

input_attachment_name

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

Default:

auto-generated

Stability:

experimental

input_filter

(experimental) The input filter mode.

Default:: InputFilter.AUTO
Stability:: experimental

logical_interface_names

(experimental) 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.

Default:

no logical interface names

Stability:

experimental

network_input_settings

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

Default:

no network input settings

Stability:

experimental

scte35_pid

(experimental) The SCTE-35 PID override for this input.

Default:

auto-detect

Stability:

experimental

smpte2038_data_preference

(experimental) SMPTE-2038 ancillary data preference.

Default:: Smpte2038DataPreference.IGNORE
Stability:: experimental

source_end_behavior

(experimental) The source end behavior for file-based inputs.

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

video_selector

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

Default:

no video selector (use default video)

Stability:

experimental