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

Class VideoSelection

java.lang.Object
software.amazon.jsii.JsiiObject
software.amazon.awscdk.services.medialive.alpha.VideoSelection
All Implemented Interfaces:
software.amazon.jsii.JsiiSerializable
@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)", date="2026-09-02T11:03:41.401Z") @Stability(Experimental) public abstract class VideoSelection extends software.amazon.jsii.JsiiObject
(experimental) Selects the specific video to extract from the input — by PID or by program.

Create with the static factory methods; exactly one selection applies, enforced by the type.

Example: 

 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();

  • Nested Class Summary

    Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

    software.amazon.jsii.JsiiObject.InitializationMode

  • Constructor Summary

    Constructors
    Modifier
    Constructor
    Description
    protected
    VideoSelection()
     
    protected
    VideoSelection(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
     
    protected
    VideoSelection(software.amazon.jsii.JsiiObjectRef objRef)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    static VideoSelection
    byPid(Number pid)
    (experimental) Extract the video with this PID.
    static VideoSelection
    byProgramId(Number programId)
    (experimental) Extract the video from this program within a multi-program transport stream.

    Methods inherited from class software.amazon.jsii.JsiiObject

    jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

    Methods inherited from interface software.amazon.jsii.JsiiSerializable

    $jsii$toJson

  • Constructor Details

    • VideoSelection

      protected VideoSelection(software.amazon.jsii.JsiiObjectRef objRef)

    • VideoSelection

      protected VideoSelection(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • VideoSelection

      @Stability(Experimental) protected VideoSelection()

  • Method Details

    • byPid

      @Stability(Experimental) @NotNull public static VideoSelection byPid(@NotNull Number pid)
      (experimental) Extract the video with this PID.

      Parameters:
      pid - This parameter is required.

    • byProgramId

      @Stability(Experimental) @NotNull public static VideoSelection byProgramId(@NotNull Number programId)
      (experimental) Extract the video from this program within a multi-program transport stream.

      If the program doesn't exist, MediaLive selects the first program in the stream.

      Parameters:
      programId - This parameter is required.