Package software.amazon.awscdk.services.medialive.alpha

Interface InputAttachment

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
InputAttachment.Jsii$Proxy
@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)", date="2026-09-02T11:03:41.186Z") @Stability(Experimental) public interface InputAttachment extends software.amazon.jsii.JsiiSerializable
(experimental) 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 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();

  • Method Details

    • getInput

      @Stability(Experimental) @NotNull IInput getInput()
      (experimental) The input to attach.

      [disable-awslint:prefer-ref-interface]

    • getAudioSelectors

      @Stability(Experimental) @Nullable default List<AudioSelector> getAudioSelectors()
      (experimental) Audio selectors to extract specific audio tracks from the input.

      Default: - no audio selectors (uses default audio)

    • getAutomaticInputFailover

      @Stability(Experimental) @Nullable default AutomaticInputFailover getAutomaticInputFailover()
      (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

    • getCaptionSelectors

      @Stability(Experimental) @Nullable default List<CaptionSelector> getCaptionSelectors()
      (experimental) Caption selectors to extract specific caption tracks from the input.

      Default: - no caption selectors

    • getDeblockFilter

      @Stability(Experimental) @Nullable default Boolean getDeblockFilter()
      (experimental) Whether to enable the deblock filter.

      Default: false

    • getDenoiseFilter

      @Stability(Experimental) @Nullable default Boolean getDenoiseFilter()
      (experimental) Whether to enable the denoise filter.

      Default: false

    • getFilterStrength

      @Stability(Experimental) @Nullable default Number getFilterStrength()
      (experimental) The filter strength (1-5).

      1 is minimal, 5 is strongest.

      Default: 1

    • getInputAttachmentName

      @Stability(Experimental) @Nullable default String getInputAttachmentName()
      (experimental) A name for this input attachment, used to reference it in schedule actions.

      Default: - auto-generated

    • getInputFilter

      @Stability(Experimental) @Nullable default InputFilter getInputFilter()
      (experimental) The input filter mode.

      Default: InputFilter.AUTO

    • getLogicalInterfaceNames

      @Stability(Experimental) @Nullable default List<String> getLogicalInterfaceNames()
      (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

    • getNetworkInputSettings

      @Stability(Experimental) @Nullable default NetworkInputSettings getNetworkInputSettings()
      (experimental) Network input settings (for URL pull inputs — HLS buffer, server validation).

      Default: - no network input settings

    • getScte35Pid

      @Stability(Experimental) @Nullable default Number getScte35Pid()
      (experimental) The SCTE-35 PID override for this input.

      Default: - auto-detect

    • getSmpte2038DataPreference

      @Stability(Experimental) @Nullable default Smpte2038DataPreference getSmpte2038DataPreference()
      (experimental) SMPTE-2038 ancillary data preference.

      Default: Smpte2038DataPreference.IGNORE

    • getSourceEndBehavior

      @Stability(Experimental) @Nullable default SourceEndBehavior getSourceEndBehavior()
      (experimental) The source end behavior for file-based inputs.

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

    • getVideoSelector

      @Stability(Experimental) @Nullable default VideoSelectorSettings getVideoSelector()
      (experimental) Video selector settings for the input (color space, PID selection).

      Default: - no video selector (use default video)

    • builder

      @Stability(Experimental) static InputAttachment.Builder builder()
      Returns:
      a InputAttachment.Builder of InputAttachment