AWS::MediaConvert::Preset - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::MediaConvert::Preset

AWS::MediaConvert::Preset 是一种 AWS Elemental MediaConvert 资源类型,您可以使用它为转码作业中的单个输出指定编码设置。

在 AWS CloudFormation 模板中声明此实体时,您将以 JSON 或 YAML 格式传入转码作业设置。此设置规范必须以符合 AWS Elemental MediaConvert 作业验证的特定方式构成。有关为 SettingsJson 属性创建输出预设模型的更多信息,请参阅本主题后面的“备注”部分。

有关输出 MediaConvert 预设的更多信息,请参阅 AWS Elemental MediaConvert 用户指南 中的使用 AWS Elemental MediaConvert 输出预设

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::MediaConvert::Preset", "Properties" : { "Category" : String, "Description" : String, "Name" : String, "SettingsJson" : Json, "Tags" : Json } }

YAML

Type: AWS::MediaConvert::Preset Properties: Category: String Description: String Name: String SettingsJson: Json Tags: Json

属性

Category

预设的新类别(如果您是在进行更改)。

必需:否

类型:字符串

Update requires: No interruption

Description

预设的新描述(如果您是在进行更改)。

必需:否

类型:字符串

Update requires: No interruption

Name

要修改的预设的名称。

必需:否

类型:字符串

Update requires: Replacement

SettingsJson

以 JSON 格式指定此输出预设的转码作业设置。此规范必须符合 AWS Elemental MediaConvert 作业验证。有关构成此规范的信息,请参阅本主题后面的“备注”部分。

有关 MediaConvert 输出预设的更多信息,请参阅 AWS Elemental MediaConvert 用户指南 中的使用 AWS Elemental MediaConvert 输出预设

必需:是

类型:Json

Update requires: No interruption

Tags

要应用于此资源的键值对的数组。

有关更多信息,请参阅标签

必需:否

类型:Json

Update requires: No interruption

返回值

Ref

在将 AWS::MediaConvert::Preset 资源的逻辑 ID 传递给内部 Ref 函数时,该函数将返回输出预设的名称,例如 HEVC high res

For more information about using the Ref function, see Ref.

Fn::GetAtt

Arn

输出预设的 Amazon 资源名称 (ARN),例如 arn:aws:mediaconvert:us-west-2:123456789012

Name

输出预设的名称,例如 HEVC high res

备注

为 SettingsJson 属性创建输出预设模型

当您在 AWS CloudFormation 模板中声明 AWS::MediaConvert::Preset 实体时,您可以传入转码作业设置作为属性 SettingsJson 的值。此设置规范必须采用 JSON 或 YAML 格式,并且必须符合 AWS Elemental MediaConvert 作业验证。

以下过程用于生成 JSON 格式的规范。如果您需要 YAML 格式,则可以使用 JSON 格式创建,然后使用转换实用程序。

SettingsJson 创建 JSON 作业模板模型

  1. 使用 MediaConvert https://console.amazonaws.cn/mediaconvert/ 创建输出预设。有关更多信息,请参阅使用 AWS Elemental MediaConvert 输出预设

  2. 使用 AWS CLI,通过以下命令仅获取设置结构:

    aws mediaconvert https://abcd1234.mediaconvert.region-name-1.amazonaws.com get-preset --name HEVC-high-res --query 'Preset.Settings'

  3. 将设置复制为属性 SettingsJson 的值。

有关 JSON 和 YAML 格式的输出预设模型示例,请参阅本主题的“示例”部分。

示例

针对 SettingsJson 的输出预设模型

有关为 SettingsJson 属性创建 JSON 或 YAML 格式的输出预设模型的更多信息,请参阅本主题后面的“备注”部分。

JSON

{ "AudioDescriptions": [ { "AudioType": 0, "AudioTypeControl": "FOLLOW_INPUT", "CodecSettings": { "AacSettings": { "AudioDescriptionBroadcasterMix": "NORMAL", "Bitrate": 160000, "CodecProfile": "LC", "CodingMode": "CODING_MODE_2_0", "RateControlMode": "CBR", "RawFormat": "NONE", "SampleRate": 48000, "Specification": "MPEG4" }, "Codec": "AAC" }, "LanguageCodeControl": "FOLLOW_INPUT" } ], "ContainerSettings": { "Container": "MP4", "Mp4Settings": { "CslgAtom": "EXCLUDE", "FreeSpaceBox": "EXCLUDE", "MoovPlacement": "NORMAL" } }, "VideoDescription": { "AfdSignaling": "NONE", "AntiAlias": "ENABLED", "CodecSettings": { "Codec": "H_265", "H265Settings": { "AdaptiveQuantization": "HIGH", "AlternateTransferFunctionSei": "DISABLED", "Bitrate": 10000000, "CodecLevel": "LEVEL_5", "CodecProfile": "MAIN_MAIN", "FlickerAdaptiveQuantization": "DISABLED", "FramerateControl": "SPECIFIED", "FramerateConversionAlgorithm": "DUPLICATE_DROP", "FramerateDenominator": 1001, "FramerateNumerator": 24000, "GopBReference": "ENABLED", "GopClosedCadence": 1, "GopSize": 48.0, "GopSizeUnits": "FRAMES", "HrdBufferInitialFillPercentage": 90, "HrdBufferSize": 20000000, "InterlaceMode": "PROGRESSIVE", "MinIInterval": 0, "NumberBFramesBetweenReferenceFrames": 3, "NumberReferenceFrames": 3, "ParControl": "SPECIFIED", "ParDenominator": 1, "ParNumerator": 1, "QualityTuningLevel": "SINGLE_PASS", "RateControlMode": "CBR", "SampleAdaptiveOffsetFilterMode": "ADAPTIVE", "SceneChangeDetect": "ENABLED", "Slices": 4, "SlowPal": "DISABLED", "SpatialAdaptiveQuantization": "ENABLED", "Telecine": "NONE", "TemporalAdaptiveQuantization": "ENABLED", "TemporalIds": "DISABLED", "Tiles": "ENABLED", "UnregisteredSeiTimecode": "DISABLED" } }, "ColorMetadata": "INSERT", "DropFrameTimecode": "ENABLED", "Height": 2160, "RespondToAfd": "NONE", "ScalingBehavior": "DEFAULT", "Sharpness": 50, "TimecodeInsertion": "DISABLED", "VideoPreprocessors": { "Deinterlacer": { "Algorithm": "INTERPOLATE", "Control": "NORMAL", "Mode": "DEINTERLACE" } }, "Width": 3840 } }

YAML

--- AudioDescriptions: - AudioType: 0 AudioTypeControl: FOLLOW_INPUT CodecSettings: AacSettings: AudioDescriptionBroadcasterMix: NORMAL Bitrate: 160000 CodecProfile: LC CodingMode: CODING_MODE_2_0 RateControlMode: CBR RawFormat: NONE SampleRate: 48000 Specification: MPEG4 Codec: AAC LanguageCodeControl: FOLLOW_INPUT ContainerSettings: Container: MP4 Mp4Settings: CslgAtom: EXCLUDE FreeSpaceBox: EXCLUDE MoovPlacement: NORMAL VideoDescription: AfdSignaling: NONE AntiAlias: ENABLED CodecSettings: Codec: H_265 H265Settings: AdaptiveQuantization: HIGH AlternateTransferFunctionSei: DISABLED Bitrate: 10000000 CodecLevel: LEVEL_5 CodecProfile: MAIN_MAIN FlickerAdaptiveQuantization: DISABLED FramerateControl: SPECIFIED FramerateConversionAlgorithm: DUPLICATE_DROP FramerateDenominator: 1001 FramerateNumerator: 24000 GopBReference: ENABLED GopClosedCadence: 1 GopSize: 48.0 GopSizeUnits: FRAMES HrdBufferInitialFillPercentage: 90 HrdBufferSize: 20000000 InterlaceMode: PROGRESSIVE MinIInterval: 0 NumberBFramesBetweenReferenceFrames: 3 NumberReferenceFrames: 3 ParControl: SPECIFIED ParDenominator: 1 ParNumerator: 1 QualityTuningLevel: SINGLE_PASS RateControlMode: CBR SampleAdaptiveOffsetFilterMode: ADAPTIVE SceneChangeDetect: ENABLED Slices: 4 SlowPal: DISABLED SpatialAdaptiveQuantization: ENABLED Telecine: NONE TemporalAdaptiveQuantization: ENABLED TemporalIds: DISABLED Tiles: ENABLED UnregisteredSeiTimecode: DISABLED ColorMetadata: INSERT DropFrameTimecode: ENABLED Height: 2160 RespondToAfd: NONE ScalingBehavior: DEFAULT Sharpness: 50 TimecodeInsertion: DISABLED VideoPreprocessors: Deinterlacer: Algorithm: INTERPOLATE Control: NORMAL Mode: DEINTERLACE Width: 384