Class M3u8Settings
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<M3u8Settings.Builder,
M3u8Settings>
- See Also:
-
Nested Class Summary
-
Method Summary
Modifier and TypeMethodDescriptionfinal M3u8AudioDuration
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio.final String
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio.final Integer
The number of audio frames to insert for each PES packet.Packet Identifier (PID) of the elementary audio stream(s) in the transport stream.static M3u8Settings.Builder
builder()
final M3u8DataPtsControl
If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values).final String
If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values).final boolean
final boolean
equalsBySdkFields
(Object obj) Indicates whether some other object is "equal to" this one by SDK fields.final <T> Optional
<T> getValueForField
(String fieldName, Class<T> clazz) final boolean
For responses, this returns true if the service returned a value for the AudioPids property.final int
hashCode()
final Integer
Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.final M3u8NielsenId3
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.final String
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.final Integer
The number of milliseconds between instances of this table in the output transport stream.final M3u8PcrControl
When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header.final String
When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header.final Integer
pcrPid()
Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream.final Integer
The number of milliseconds between instances of this table in the output transport stream.final Integer
pmtPid()
Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.final Integer
Packet Identifier (PID) of the private metadata stream in the transport stream.final Integer
The value of the program number field in the Program Map Table.final Integer
Manually specify the initial PTS offset, in seconds, when you set PTS offset to Seconds.final TsPtsOffset
Specify the initial presentation timestamp (PTS) offset for your transport stream output.final String
Specify the initial presentation timestamp (PTS) offset for your transport stream output.final Integer
Packet Identifier (PID) of the SCTE-35 stream in the transport stream.final M3u8Scte35Source
For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output.final String
For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output.static Class
<? extends M3u8Settings.Builder> final TimedMetadata
Set ID3 metadata to Passthrough to include ID3 metadata in this output.final String
Set ID3 metadata to Passthrough to include ID3 metadata in this output.final Integer
Packet Identifier (PID) of the ID3 metadata stream in the transport stream.Take this object and create a builder that contains all of the current property values of this object.final String
toString()
Returns a string representation of this object.final Integer
The value of the transport stream ID field in the Program Map Table.final Integer
videoPid()
Packet Identifier (PID) of the elementary video stream in the transport stream.Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
Method Details
-
audioDuration
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.If the service returns an enum value that is not available in the current SDK version,
audioDuration
will returnM3u8AudioDuration.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromaudioDurationAsString()
.- Returns:
- Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.
- See Also:
-
audioDurationAsString
Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.If the service returns an enum value that is not available in the current SDK version,
audioDuration
will returnM3u8AudioDuration.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromaudioDurationAsString()
.- Returns:
- Specify this setting only when your output will be consumed by a downstream repackaging workflow that is sensitive to very small duration differences between video and audio. For this situation, choose Match video duration. In all other cases, keep the default value, Default codec duration. When you choose Match video duration, MediaConvert pads the output audio streams with silence or trims them to ensure that the total duration of each audio stream is at least as long as the total duration of the video stream. After padding or trimming, the audio stream duration is no more than one frame longer than the video stream. MediaConvert applies audio padding or trimming only to the end of the last segment of the output. For unsegmented outputs, MediaConvert adds padding only to the end of the file. When you keep the default value, any minor discrepancies between audio and video duration will depend on your output audio codec.
- See Also:
-
audioFramesPerPes
The number of audio frames to insert for each PES packet.- Returns:
- The number of audio frames to insert for each PES packet.
-
hasAudioPids
public final boolean hasAudioPids()For responses, this returns true if the service returned a value for the AudioPids property. This DOES NOT check that the value is non-empty (for which, you should check theisEmpty()
method on the property). This is useful because the SDK will never return a null collection or map, but you may need to differentiate between the service returning nothing (or null) and the service returning an empty collection or map. For requests, this returns true if a value for the property was specified in the request builder, and false if a value was not specified. -
audioPids
Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.Attempts to modify the collection returned by this method will result in an UnsupportedOperationException.
This method will never return null. If you would like to know whether the service returned this field (so that you can differentiate between null and empty), you can use the
hasAudioPids()
method.- Returns:
- Packet Identifier (PID) of the elementary audio stream(s) in the transport stream. Multiple values are accepted, and can be entered in ranges and/or by comma separation.
-
dataPTSControl
If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value AUTO to allow all PTS values.If the service returns an enum value that is not available in the current SDK version,
dataPTSControl
will returnM3u8DataPtsControl.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdataPTSControlAsString()
.- Returns:
- If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value AUTO to allow all PTS values.
- See Also:
-
dataPTSControlAsString
If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value AUTO to allow all PTS values.If the service returns an enum value that is not available in the current SDK version,
dataPTSControl
will returnM3u8DataPtsControl.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromdataPTSControlAsString()
.- Returns:
- If you select ALIGN_TO_VIDEO, MediaConvert writes captions and data packets with Presentation Timestamp (PTS) values greater than or equal to the first video packet PTS (MediaConvert drops captions and data packets with lesser PTS values). Keep the default value AUTO to allow all PTS values.
- See Also:
-
maxPcrInterval
Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.- Returns:
- Specify the maximum time, in milliseconds, between Program Clock References (PCRs) inserted into the transport stream.
-
nielsenId3
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.If the service returns an enum value that is not available in the current SDK version,
nielsenId3
will returnM3u8NielsenId3.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromnielsenId3AsString()
.- Returns:
- If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.
- See Also:
-
nielsenId3AsString
If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.If the service returns an enum value that is not available in the current SDK version,
nielsenId3
will returnM3u8NielsenId3.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromnielsenId3AsString()
.- Returns:
- If INSERT, Nielsen inaudible tones for media tracking will be detected in the input audio and an equivalent ID3 tag will be inserted in the output.
- See Also:
-
patInterval
The number of milliseconds between instances of this table in the output transport stream.- Returns:
- The number of milliseconds between instances of this table in the output transport stream.
-
pcrControl
When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.If the service returns an enum value that is not available in the current SDK version,
pcrControl
will returnM3u8PcrControl.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available frompcrControlAsString()
.- Returns:
- When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.
- See Also:
-
pcrControlAsString
When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.If the service returns an enum value that is not available in the current SDK version,
pcrControl
will returnM3u8PcrControl.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available frompcrControlAsString()
.- Returns:
- When set to PCR_EVERY_PES_PACKET a Program Clock Reference value is inserted for every Packetized Elementary Stream (PES) header. This parameter is effective only when the PCR PID is the same as the video or audio elementary stream.
- See Also:
-
pcrPid
Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.- Returns:
- Packet Identifier (PID) of the Program Clock Reference (PCR) in the transport stream. When no value is given, the encoder will assign the same value as the Video PID.
-
pmtInterval
The number of milliseconds between instances of this table in the output transport stream.- Returns:
- The number of milliseconds between instances of this table in the output transport stream.
-
pmtPid
Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.- Returns:
- Packet Identifier (PID) for the Program Map Table (PMT) in the transport stream.
-
privateMetadataPid
Packet Identifier (PID) of the private metadata stream in the transport stream.- Returns:
- Packet Identifier (PID) of the private metadata stream in the transport stream.
-
programNumber
The value of the program number field in the Program Map Table.- Returns:
- The value of the program number field in the Program Map Table.
-
ptsOffset
Manually specify the initial PTS offset, in seconds, when you set PTS offset to Seconds. Enter an integer from 0 to 3600. Leave blank to keep the default value 2.- Returns:
- Manually specify the initial PTS offset, in seconds, when you set PTS offset to Seconds. Enter an integer from 0 to 3600. Leave blank to keep the default value 2.
-
ptsOffsetMode
Specify the initial presentation timestamp (PTS) offset for your transport stream output. To let MediaConvert automatically determine the initial PTS offset: Keep the default value, Auto. We recommend that you choose Auto for the widest player compatibility. The initial PTS will be at least two seconds and vary depending on your output's bitrate, HRD buffer size and HRD buffer initial fill percentage. To manually specify an initial PTS offset: Choose Seconds. Then specify the number of seconds with PTS offset.If the service returns an enum value that is not available in the current SDK version,
ptsOffsetMode
will returnTsPtsOffset.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromptsOffsetModeAsString()
.- Returns:
- Specify the initial presentation timestamp (PTS) offset for your transport stream output. To let MediaConvert automatically determine the initial PTS offset: Keep the default value, Auto. We recommend that you choose Auto for the widest player compatibility. The initial PTS will be at least two seconds and vary depending on your output's bitrate, HRD buffer size and HRD buffer initial fill percentage. To manually specify an initial PTS offset: Choose Seconds. Then specify the number of seconds with PTS offset.
- See Also:
-
ptsOffsetModeAsString
Specify the initial presentation timestamp (PTS) offset for your transport stream output. To let MediaConvert automatically determine the initial PTS offset: Keep the default value, Auto. We recommend that you choose Auto for the widest player compatibility. The initial PTS will be at least two seconds and vary depending on your output's bitrate, HRD buffer size and HRD buffer initial fill percentage. To manually specify an initial PTS offset: Choose Seconds. Then specify the number of seconds with PTS offset.If the service returns an enum value that is not available in the current SDK version,
ptsOffsetMode
will returnTsPtsOffset.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromptsOffsetModeAsString()
.- Returns:
- Specify the initial presentation timestamp (PTS) offset for your transport stream output. To let MediaConvert automatically determine the initial PTS offset: Keep the default value, Auto. We recommend that you choose Auto for the widest player compatibility. The initial PTS will be at least two seconds and vary depending on your output's bitrate, HRD buffer size and HRD buffer initial fill percentage. To manually specify an initial PTS offset: Choose Seconds. Then specify the number of seconds with PTS offset.
- See Also:
-
scte35Pid
Packet Identifier (PID) of the SCTE-35 stream in the transport stream.- Returns:
- Packet Identifier (PID) of the SCTE-35 stream in the transport stream.
-
scte35Source
For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None if you don't want manifest conditioning. Choose Passthrough and choose Ad markers if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML.If the service returns an enum value that is not available in the current SDK version,
scte35Source
will returnM3u8Scte35Source.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromscte35SourceAsString()
.- Returns:
- For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None if you don't want manifest conditioning. Choose Passthrough and choose Ad markers if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML.
- See Also:
-
scte35SourceAsString
For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None if you don't want manifest conditioning. Choose Passthrough and choose Ad markers if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML.If the service returns an enum value that is not available in the current SDK version,
scte35Source
will returnM3u8Scte35Source.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromscte35SourceAsString()
.- Returns:
- For SCTE-35 markers from your input-- Choose Passthrough if you want SCTE-35 markers that appear in your input to also appear in this output. Choose None if you don't want SCTE-35 markers in this output. For SCTE-35 markers from an ESAM XML document-- Choose None if you don't want manifest conditioning. Choose Passthrough and choose Ad markers if you do want manifest conditioning. In both cases, also provide the ESAM XML as a string in the setting Signal processing notification XML.
- See Also:
-
timedMetadata
Set ID3 metadata to Passthrough to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period, and Custom ID3 metadata inserter. To exclude this ID3 metadata in this output: set ID3 metadata to None or leave blank.If the service returns an enum value that is not available in the current SDK version,
timedMetadata
will returnTimedMetadata.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromtimedMetadataAsString()
.- Returns:
- Set ID3 metadata to Passthrough to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period, and Custom ID3 metadata inserter. To exclude this ID3 metadata in this output: set ID3 metadata to None or leave blank.
- See Also:
-
timedMetadataAsString
Set ID3 metadata to Passthrough to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period, and Custom ID3 metadata inserter. To exclude this ID3 metadata in this output: set ID3 metadata to None or leave blank.If the service returns an enum value that is not available in the current SDK version,
timedMetadata
will returnTimedMetadata.UNKNOWN_TO_SDK_VERSION
. The raw value returned by the service is available fromtimedMetadataAsString()
.- Returns:
- Set ID3 metadata to Passthrough to include ID3 metadata in this output. This includes ID3 metadata from the following features: ID3 timestamp period, and Custom ID3 metadata inserter. To exclude this ID3 metadata in this output: set ID3 metadata to None or leave blank.
- See Also:
-
timedMetadataPid
Packet Identifier (PID) of the ID3 metadata stream in the transport stream.- Returns:
- Packet Identifier (PID) of the ID3 metadata stream in the transport stream.
-
transportStreamId
The value of the transport stream ID field in the Program Map Table.- Returns:
- The value of the transport stream ID field in the Program Map Table.
-
videoPid
Packet Identifier (PID) of the elementary video stream in the transport stream.- Returns:
- Packet Identifier (PID) of the elementary video stream in the transport stream.
-
toBuilder
Description copied from interface:ToCopyableBuilder
Take this object and create a builder that contains all of the current property values of this object.- Specified by:
toBuilder
in interfaceToCopyableBuilder<M3u8Settings.Builder,
M3u8Settings> - Returns:
- a builder for type T
-
builder
-
serializableBuilderClass
-
hashCode
public final int hashCode() -
equals
-
equalsBySdkFields
Description copied from interface:SdkPojo
Indicates whether some other object is "equal to" this one by SDK fields. An SDK field is a modeled, non-inherited field in anSdkPojo
class, and is generated based on a service model.If an
SdkPojo
class does not have any inherited fields,equalsBySdkFields
andequals
are essentially the same.- Specified by:
equalsBySdkFields
in interfaceSdkPojo
- Parameters:
obj
- the object to be compared with- Returns:
- true if the other object equals to this object by sdk fields, false otherwise.
-
toString
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value. -
getValueForField
-
sdkFields
-