read-preset

Описание

Операция ReadPreset получает подробную информацию о пресете.

См. также: Документация AWS API

Синтаксис

  read-preset
--id <value>
[--cli-input-json | --cli-input-yaml]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--id (строка)

Идентификатор пресета, для которого требуется получить подробную информацию.

--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной JSON-строки. JSON-строка следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные JSON. Невозможно передать произвольные двоичные значения, используя предоставленное JSON-значение, так как строка будет интерпретирована буквально. Это не может быть указано вместе с --cli-input-yaml.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если указано без значения или со значением input, выводит пример JSON-ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если указано yaml-input, он выведет пример YAML-ввода, который можно использовать с --cli-input-yaml. Если указано значение output, оно валидирует входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не стабилен между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (булево)

Включить отладку логирования.

--endpoint-url (строка)

Переопределить значение URL по умолчанию команды на заданный URL.

--no-verify-ssl (булево)

По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет стандартное поведение проверки SSL-сертификатов.

--no-paginate (булево)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использование определенного профиля из файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Отображение версии этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (булево)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.

--ca-bundle (строка)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и без таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. По умолчанию используется формат base64. Формат base64 ожидает, что двоичные блоки будут предоставлены как строка в кодировке base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет рассматриваться как двоичный и будет использовать содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (булево)

Отключить вывод AWS CLI.

--cli-auto-prompt (булево)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (булево)

Отключить автоматическое запроса параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Для получения пресета ElasticTranscoder

В этом примере показано получение указанного пресета ElasticTranscoder.

Команда:

aws elastictranscoder read-preset --id 1351620000001-500020

Вывод:

{
   "Preset": {
       "Thumbnails": {
           "SizingPolicy": "ShrinkToFit",
           "MaxWidth": "192",
           "Format": "png",
           "PaddingPolicy": "NoPad",
           "Interval": "300",
           "MaxHeight": "108"
       },
       "Container": "fmp4",
       "Description": "System preset: MPEG-Dash Video - 4.8M",
       "Video": {
           "SizingPolicy": "ShrinkToFit",
           "MaxWidth": "1280",
           "PaddingPolicy": "NoPad",
           "FrameRate": "30",
           "MaxHeight": "720",
           "KeyframesMaxDist": "60",
           "FixedGOP": "true",
           "Codec": "H.264",
           "Watermarks": [
               {
                   "SizingPolicy": "ShrinkToFit",
                   "VerticalOffset": "10%",
                   "VerticalAlign": "Top",
                   "Target": "Content",
                   "MaxWidth": "10%",
                   "MaxHeight": "10%",
                   "HorizontalAlign": "Left",
                   "HorizontalOffset": "10%",
                   "Opacity": "100",
                   "Id": "TopLeft"
               },
               {
                   "SizingPolicy": "ShrinkToFit",
                   "VerticalOffset": "10%",
                   "VerticalAlign": "Top",
                   "Target": "Content",
                   "MaxWidth": "10%",
                   "MaxHeight": "10%",
                   "HorizontalAlign": "Right",
                   "HorizontalOffset": "10%",
                   "Opacity": "100",
                   "Id": "TopRight"
               },
               {
                   "SizingPolicy": "ShrinkToFit",
                   "VerticalOffset": "10%",
                   "VerticalAlign": "Bottom",
                   "Target": "Content",
                   "MaxWidth": "10%",
                   "MaxHeight": "10%",
                   "HorizontalAlign": "Left",
                   "HorizontalOffset": "10%",
                   "Opacity": "100",
                   "Id": "BottomLeft"
               },
               {
                   "SizingPolicy": "ShrinkToFit",
                   "VerticalOffset": "10%",
                   "VerticalAlign": "Bottom",
                   "Target": "Content",
                   "MaxWidth": "10%",
                   "MaxHeight": "10%",
                   "HorizontalAlign": "Right",
                   "HorizontalOffset": "10%",
                   "Opacity": "100",
                   "Id": "BottomRight"
               }
           ],
           "CodecOptions": {
               "Profile": "main",
               "MaxBitRate": "4800",
               "InterlacedMode": "Progressive",
               "Level": "3.1",
               "ColorSpaceConversionMode": "None",
               "MaxReferenceFrames": "3",
               "BufferSize": "9600"
           },
           "BitRate": "4800",
           "DisplayAspectRatio": "auto"
       },
       "Type": "System",
       "Id": "1351620000001-500020",
       "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/1351620000001-500020",
       "Name": "System preset: MPEG-Dash Video - 4.8M"
   }
}

Вывод

Пресет -> (структура)

Раздел тела ответа, содержащий информацию о пресете.

Id -> (строка)

Идентификатор нового пресета. Используйте это значение для получения настроек пресета или для его удаления.

Arn -> (строка)

Amazon Resource Name (ARN) для пресета.

Имя -> (строка)

Имя пресета.

Описание -> (строка)

Описание пресета.

Контейнер -> (строка)

Тип контейнера для выходного файла. Допустимые значения включают flac , flv , fmp4 , gif , mp3 , mp4 , mpg , mxf , oga , ogg , ts и webm .

Аудио -> (структура)

Раздел тела ответа, содержащий информацию о значениях пресета аудио.

Кодек -> (строка)

Аудиокодек для выходного файла. Допустимые значения включают aac , flac , mp2 , mp3 , pcm и vorbis .

Частота дискретизации -> (строка)

Частота дискретизации аудиопотока в выходном файле в Герцах. Допустимые значения включают:

auto , 22050 , 32000 , 44100 , 48000 , 96000

Если вы укажете auto , Elastic Transcoder автоматически обнаруживает частоту дискретизации.

Битрейт -> (строка)

Битрейт аудиопотока в выходном файле в килобитах в секунду. Введите целое число от 64 до 320 включительно.

Каналы -> (строка)

Количество аудиоканалов в выходном файле. Допустимые значения:

auto , 0 , 1 , 2

Один канал передает информацию, воспроизводимую одним динамиком. Например, стереодорожка с двумя каналами отправляет один канал на левый динамик, а другой — на правый. Выходные каналы организованы в дорожки. Если вы хотите, чтобы Elastic Transcoder автоматически обнаружил количество аудиоканалов во входном файле и использовал это значение для выходного файла, выберите auto .

Вывод для определенного значения канала и входных данных:

auto Указанный канал с любым входом: Пропускает до восьми входных каналов.
0 Указанные каналы с любым входом: Аудио исключается из вывода.
1 Указанный канал с хотя бы одним входным каналом: Монозвук.
2 Указанные каналы с любым входом: Два идентичных моноканала или стерео. Дополнительную информацию о дорожках см. в Audio:AudioPackingMode.

Дополнительную информацию о том, как Elastic Transcoder организует каналы и дорожки, см. в Audio:AudioPackingMode .

AudioPackingMode -> (строка)

Метод организации аудиоканалов и дорожек. Используйте Audio:Channels для указания количества каналов на выходе и Audio:AudioPackingMode для указания количества дорожек и их связи с каналами. Если вы не указываете Audio:AudioPackingMode , Elastic Transcoder использует SingleTrack .

Допустимые значения:

SingleTrack , OneChannelPerTrack и OneChannelPerTrackWithMosTo8Tracks

При указании SingleTrack Elastic Transcoder создаёт одну дорожку для вывода. Дорожка может содержать до восьми каналов. Используйте SingleTrack для всех контейнеров, кроме mxf .

Выходные данные SingleTrack для определённого значения канала и входных данных:

0 каналы с любым входом: Аудио исключается из вывода
1, 2, or auto каналы без входного аудио: Аудио исключается из вывода
1 канал с любым входным аудио: Одна дорожка с одним каналом, если необходимо, микшируется вниз
2 каналы с одной дорожкой с одним каналом: Одна дорожка с двумя идентичными каналами
2 or auto каналы с двумя дорожками с одним каналом каждая: Одна дорожка с двумя каналами
2 or auto каналы с одной дорожкой с двумя каналами: Одна дорожка с двумя каналами
2 каналы с одной дорожкой с несколькими каналами: Одна дорожка с двумя каналами
auto каналы с одной дорожкой с одним каналом: Одна дорожка с одним каналом
auto каналы с одной дорожкой с несколькими каналами: Одна дорожка с несколькими каналами

При указании OneChannelPerTrack Elastic Transcoder создаёт новую дорожку для каждого канала на выходе. На выходе может быть до восьми одноканальных дорожек.

Выходные данные OneChannelPerTrack для определённого значения канала и входных данных:

0 каналы с любым входом: Аудио исключается из вывода
1, 2, or auto каналы без входного аудио: Аудио исключается из вывода
1 канал с любым входным аудио: Одна дорожка с одним каналом, если необходимо, микшируется вниз
2 каналы с одной дорожкой с одним каналом: Две дорожки с одним идентичным каналом каждая
2 or auto каналы с двумя дорожками с одним каналом каждая: Две дорожки с одним каналом каждая
2 or auto каналы с одной дорожкой с двумя каналами: Две дорожки с одним каналом каждая
2 каналы с одной дорожкой с несколькими каналами: Две дорожки с одним каналом каждая
auto каналы с одной дорожкой с одним каналом: Одна дорожка с одним каналом
auto каналы с одной дорожкой с несколькими каналами: До восьми дорожек с одним каналом каждая

При указании OneChannelPerTrackWithMosTo8Tracks Elastic Transcoder создаёт восемь одноканальных дорожек для вывода. Все дорожки, не содержащие аудиоданных из входного канала, являются дорожками MOS (Mit Out Sound).

Выходные данные OneChannelPerTrackWithMosTo8Tracks для определённого значения канала и входных данных:

0 каналы с любым входом: Аудио исключается из вывода
1, 2, or auto каналы без входного аудио: Аудио исключается из вывода
1 канал с любым входным аудио: Одна дорожка с одним каналом, если необходимо, микшируется вниз, плюс шесть дорожек MOS
2 каналы с одной дорожкой с одним каналом: Две дорожки с одним идентичным каналом каждая, плюс шесть дорожек MOS
2 or auto каналы с двумя дорожками с одним каналом каждая: Две дорожки с одним каналом каждая, плюс шесть дорожек MOS
2 or auto каналы с одной дорожкой с двумя каналами: Две дорожки с одним каналом каждая, плюс шесть дорожек MOS
2 каналы с одной дорожкой с несколькими каналами: Две дорожки с одним каналом каждая, плюс шесть дорожек MOS
auto каналы с одной дорожкой с одним каналом: Одна дорожка с одним каналом, плюс семь дорожек MOS
auto каналы с одной дорожкой с несколькими каналами: До восьми дорожек с одним каналом каждая, плюс дорожки MOS до тех пор, пока не будет восемь дорожек

CodecOptions -> (структура)

Если вы указали AAC для Audio:Codec , это профиль сжатия AAC для использования. Допустимые значения включают:

auto , AAC-LC , HE-AAC , HE-AACv2

Если вы укажете auto , Elastic Transcoder выберет профиль на основе битрейта выходного файла.

Профиль -> (строка)

Вы можете выбрать только аудиопрофиль, когда вы укажете AAC для значения Audio:Codec.

Укажите профиль AAC для выходного файла. Elastic Transcoder поддерживает следующие профили:

auto : Если вы укажете auto , Elastic Transcoder выбирает профиль на основе выбранного битрейта выходного файла.
AAC-LC : Наиболее распространённый профиль AAC. Используйте для битрейтов больше 64 кбит/с.
HE-AAC : Не поддерживается некоторыми старыми плеерами и устройствами. Используйте для битрейтов от 40 до 80 кбит/с.
HE-AACv2 : Не поддерживается некоторыми плеерами и устройствами. Используйте для битрейтов меньше 48 кбит/с.

Все выводы в плейлисте Smooth должны иметь одинаковое значение для Profile .

Примечание

Если вы создали какие-либо пресеты до добавления профилей AAC, Elastic Transcoder автоматически обновил ваши пресеты для использования AAC-LC. Вы можете изменить значение по мере необходимости.

Глубина бита -> (строка)

Вы можете выбрать глубину бита аудио только при указании flac или pcm для значения Audio:Codec.

Глубина бита выборки — это количество битов информации, включенных в аудиовыборки. Чем выше глубина бита, тем лучше качество звука, но тем больше файл.

Допустимые значения — 16 и 24 .

Наиболее распространённая глубина бита — 24 .

Порядок бит -> (строка)

Вы можете выбрать порядок бит аудио только при указании pcm для значения Audio:Codec.

Порядок хранения битов образца PCM.

Поддерживаемое значение — LittleEndian .

Подписано -> (строка)

Вы можете выбрать, является ли аудиовыборка подписанной, только если вы указали pcm для значения Audio:Codec.

Представляет ли аудиовыборка отрицательные и положительные числа (подписанная) или только положительные числа (неподписанная).

Поддерживаемое значение — Signed .

Видео -> (структура)

Раздел тела ответа, предоставляющий информацию о значениях параметров пресета видео.

Codec -> (строка)

Кодек видео для выходного файла. Допустимые значения включают gif , H.264 , mpeg2 , vp8 и vp9 . Вы можете указать только vp8 и vp9 при типе контейнера webm , gif при типе контейнера gif , и mpeg2 при типе контейнера mpg .

CodecOptions -> (словарь)

Профиль (Только H.264/VP8/VP9)

Профиль H.264, который вы хотите использовать для выходного файла. Elastic Transcoder поддерживает следующие профили:

baseline : Профиль, чаще всего используемый для видеоконференций и мобильных приложений.
main : Профиль, используемый для цифровых телевизионных трансляций стандартного разрешения.
high : Профиль, используемый для цифровых телевизионных трансляций высокого разрешения и для дисков Blu-ray.

Уровень (Только H.264)

Уровень H.264, который вы хотите использовать для выходного файла. Elastic Transcoder поддерживает следующие уровни:

1 , 1b , 1.1 , 1.2 , 1.3 , 2 , 2.1 , 2.2 , 3 , 3.1 , 3.2 , 4 , 4.1

MaxReferenceFrames (Только H.264)

Применимо только когда значение Video:Codec равно H.264. Максимальное количество ранее декодированных кадров, используемых в качестве ссылки для декодирования будущих кадров. Допустимые значения — целые числа от 0 до 16, но рекомендуется не использовать значение, большее, чем:

Min(Floor(Maximum decoded picture buffer in macroblocks * 256 / (Width in pixels * Height in pixels)), 16)

где Ширина в пикселях и Высота в пикселях представляют либо MaxWidth и MaxHeight, либо Resolution. Максимальный буфер декодированного изображения в макроблоках зависит от значения объекта Level. См. список ниже. (Макроблок — это блок пикселей размером 16x16.)

1 - 396
1b - 396
1.1 - 900
1.2 - 2376
1.3 - 2376
2 - 2376
2.1 - 4752
2.2 - 8100
3 - 8100
3.1 - 18000
3.2 - 20480
4 - 32768
4.1 - 32768

MaxBitRate (Необязательно, только H.264/MPEG2/VP8/VP9)

Максимальное количество бит в секунду в буфере видео; размер буфера задается параметром BufferSize . Укажите значение от 16 до 62 500. Вы можете снизить пропускную способность, необходимую для потоковой передачи видео, уменьшив максимальную скорость передачи данных, но это также снизит качество видео.

BufferSize (Необязательно, только H.264/MPEG2/VP8/VP9)

Максимальное количество бит в любых x секундах выходного видео. Этот интервал обычно составляет 10 секунд, стандартная продолжительность сегмента при использовании FMP4 или MPEG-TS для типа контейнера выходного видео. Укажите целое число больше 0. Если вы указываете MaxBitRate и опускаете BufferSize , Elastic Transcoder устанавливает BufferSize в 10 раз больше значения MaxBitRate .

InterlacedMode (Необязательно, только H.264/MPEG2)

Режим чередования для выходного видео.

Чередующееся видео используется для удвоения воспринимаемой частоты кадров видео путем чередования двух полей (одного поля на каждой второй строке, другого поля на остальных строках), чтобы человеческий глаз регистрировал несколько изображений за кадр. Чередование уменьшает пропускную способность, необходимую для передачи видео, но может привести к размытым изображениям и мерцанию.

Допустимые значения включают Progressive (без чередования, сверху вниз), TopFirst (первое поле сверху), BottomFirst (первое поле снизу) и Auto .

Если InterlaceMode не указан, Elastic Transcoder использует Progressive для вывода. Если Auto указан, Elastic Transcoder чередует вывод.

ColorSpaceConversionMode (Необязательно, только H.264/MPEG2)

Преобразование цветового пространства, применяемое Elastic Transcoder к выходному видео. Цветовые пространства — это алгоритмы, используемые компьютером для хранения информации о том, как отображать цвет. Bt.601 является стандартом для видео стандартного разрешения, а Bt.709 — стандартом для видео высокого разрешения.

Допустимые значения включают None , Bt709toBt601 , Bt601toBt709 и Auto .

Если вы выбрали Auto для ColorSpaceConversionMode , а ваш вывод чередуется, ваша частота кадров — одно из значений 23.97 , 24 , 25 , 29.97 , 50 или 60 , ваше SegmentDuration равно null, и вы используете одно из изменений разрешения из приведенного ниже списка, Elastic Transcoder применяет следующие преобразования цветового пространства:

Стандартное в HD, 720x480 в 1920x1080 - Elastic Transcoder применяет Bt601ToBt709
Стандартное в HD, 720x576 в 1920x1080 - Elastic Transcoder применяет Bt601ToBt709
HD в Стандартное, 1920x1080 в 720x480 - Elastic Transcoder применяет Bt709ToBt601
HD в Стандартное, 1920x1080 в 720x576 - Elastic Transcoder применяет Bt709ToBt601

Примечание

Elastic Transcoder может изменить поведение режима ColorspaceConversionMode Auto в будущем. Все выводы в списке воспроизведения должны использовать тот же ColorSpaceConversionMode .

Если вы не указываете ColorSpaceConversionMode , Elastic Transcoder не изменяет цветовое пространство файла. Если вы не уверены, какое ColorSpaceConversionMode было применено к вашему выходному файлу, вы можете проверить параметр AppliedColorSpaceConversion, включённый в ответ на запрос вашей задачи. Если в ответе на запрос задачи нет AppliedColorSpaceConversion , не было применено никакого ColorSpaceConversionMode.

ChromaSubsampling

Схема выборки цветовых каналов (хроматических каналов) выходного видео. Допустимые значения включают yuv420p и yuv422p .

yuv420p выбирает хроматическую информацию через одну горизонтальную и через одну вертикальную линию, yuv422p выбирает цветовую информацию каждой горизонтальной линии и через одну вертикальную линию.

LoopCount (Только Gif)

Количество повторов выходного gif. Допустимые значения — Infinite и целые числа от 0 до 100 включительно.

ключ -> (строка)

значение -> (строка)

KeyframesMaxDist -> (строка)

Применимо только когда значение Video:Codec — одно из значений H.264 , MPEG2 или VP8 .

Максимальное количество кадров между ключевыми кадрами. Ключевые кадры — это полностью закодированные кадры; кадры между ключевыми кадрами кодируются, частично, на основе содержимого ключевых кадров. Значение представляет собой целое число в формате строки; допустимые значения находятся в диапазоне от 1 (каждый кадр — ключевой) до 100 000 включительно. Большее значение приводит к большей степени сжатия, но может заметно снизить качество видео.

Для выводов Smooth , FrameRate должно иметь постоянное соотношение к KeyframesMaxDist . Это позволяет спискам воспроизведения Smooth переключаться между разными уровнями качества во время воспроизведения файла.

Например, входной файл может иметь FrameRate 30 и KeyframesMaxDist 90. Выходной файл должен иметь отношение 1:3. Допустимые выводы будут иметь FrameRate 30, 25 и 10, и KeyframesMaxDist 90, 75 и 30 соответственно.

Альтернативно, это можно достичь, установив FrameRate в auto и имея одинаковые значения для MaxFrameRate и KeyframesMaxDist .

FixedGOP -> (строка)

Применимо только когда значение Video:Codec — одно из значений H.264 , MPEG2 или VP8 .

Использовать ли фиксированное значение для FixedGOP . Допустимые значения — true и false :

true : Elastic Transcoder использует значение KeyframesMaxDist для расстояния между ключевыми кадрами (количество кадров в группе кадров, или GOP).
false : Расстояние между ключевыми кадрами может варьироваться.

Предупреждение

FixedGOP должен быть установлен на true для контейнеров fmp4.

BitRate -> (строка)

Скорость передачи данных видеопотока в выходном файле в килобитах в секунду. Допустимые значения зависят от значений Level и Profile . Если вы указываете auto , Elastic Transcoder использует обнаруженную скорость передачи данных входного источника. Если вы указываете значение, отличное от auto , мы рекомендуем указать значение, меньшее или равное максимальному значению, соответствующему стандарту H.264, перечисленному для вашего уровня и профиля:

Уровень - Максимальная скорость передачи видео в килобитах в секунду (профиль baseline и main) : максимальная скорость передачи видео в килобитах в секунду (профиль high)

1 - 64 : 80
1b - 128 : 160
1.1 - 192 : 240
1.2 - 384 : 480
1.3 - 768 : 960
2 - 2000 : 2500
3 - 10000 : 12500
3.1 - 14000 : 17500
3.2 - 20000 : 25000
4 - 20000 : 25000
4.1 - 50000 : 62500

FrameRate -> (строка)

Кадр в секунду для потока видео в выходном файле. Допустимые значения:

auto , 10 , 15 , 23.97 , 24 , 25 , 29.97 , 30 , 60

Если вы укажете auto, Elastic Transcoder использует обнаруженную частоту кадров входного источника. Если вы указываете частоту кадров, мы рекомендуем выполнить следующее вычисление:

Frame rate = maximum recommended decoding speed in luma samples/second / (width in pixels * height in pixels)

где:

ширина в пикселях и высота в пикселях представляют Разрешение выходного видео.
максимальная рекомендуемая скорость декодирования в образцах люма/секунду меньше или равна максимальному значению в следующей таблице, в зависимости от значения, указанного для Уровня.

Максимальная рекомендуемая скорость декодирования в образцах люма/секунду для каждого уровня описана в следующем списке (Уровень - Скорость декодирования ):

1 - 380160
1b - 380160
1.1 - 76800
1.2 - 1536000
1.3 - 3041280
2 - 3041280
2.1 - 5068800
2.2 - 5184000
3 - 10368000
3.1 - 27648000
3.2 - 55296000
4 - 62914560
4.1 - 62914560

MaxFrameRate -> (строка)

Если вы укажете auto для FrameRate, Elastic Transcoder использует частоту кадров входного видео для частоты кадров выходного видео. Укажите максимальную частоту кадров, которую вы хотите использовать Elastic Transcoder, когда частота кадров входного видео больше желаемой максимальной частоты кадров выходного видео. Допустимые значения включают: 10 , 15 , 23.97 , 24 , 25 , 29.97 , 30 , 60 .

Resolution -> (строка)

Предупреждение

Для лучшего управления разрешением и соотношением сторон выходного видео, мы рекомендуем использовать значения MaxWidth , MaxHeight , SizingPolicy , PaddingPolicy и DisplayAspectRatio вместо Resolution и AspectRatio . Эти два набора параметров взаимоисключают друг друга. Не используйте их вместе.

Ширина и высота видео в выходном файле в пикселях. Допустимые значения — auto и ширина x высота :

auto: Elastic Transcoder пытается сохранить ширину и высоту входного файла, подлежащие следующим правилам.
``ширина x высота `` : Ширина и высота выходного видео в пикселях.

Обратите внимание на следующее при указании ширины и высоты:

Ширина должна быть четным целым числом от 128 до 4096 включительно.
Высота должна быть четным целым числом от 96 до 3072 включительно.
Если вы укажете разрешение, меньшее, чем разрешение входного файла, Elastic Transcoder масштабирует выходной файл до меньшего разрешения.
Если вы укажете разрешение, большее, чем разрешение входного файла, Elastic Transcoder масштабирует выходной файл до большего разрешения.
Мы рекомендуем указать разрешение, для которого произведение ширины и высоты меньше или равно соответствующему значению в следующем списке (Список - Максимальное значение ширины x высоты ):
- 1 - 25344
- 1b - 25344
- 1.1 - 101376
- 1.2 - 101376
- 1.3 - 101376
- 2 - 101376
- 2.1 - 202752
- 2.2 - 404720
- 3 - 404720
- 3.1 - 921600
- 3.2 - 1310720
- 4 - 2097152
- 4.1 - 2097152

AspectRatio -> (строка)

Предупреждение

Соотношение сторон экрана видео в выходном файле. Допустимые значения:

auto , 1:1 , 4:3 , 3:2 , 16:9

Если вы укажете auto, Elastic Transcoder попытается сохранить соотношение сторон входного файла.

Если вы укажете соотношение сторон для выходного файла, отличное от соотношения сторон входного файла, Elastic Transcoder добавит черную рамку (черные полосы по бокам) или черную рамку (черные полосы в верхней и нижней части) для поддержания соотношения сторон активной области видео.

MaxWidth -> (строка)

Максимальная ширина выходного видео в пикселях. Если вы укажете auto, Elastic Transcoder использует 1920 (Full HD) в качестве значения по умолчанию. Если вы укажете числовое значение, введите четное целое число от 128 до 4096.

MaxHeight -> (строка)

Максимальная высота выходного видео в пикселях. Если вы укажете auto, Elastic Transcoder использует 1080 (Full HD) в качестве значения по умолчанию. Если вы укажете числовое значение, введите четное целое число от 96 до 3072.

DisplayAspectRatio -> (строка)

Значение, которое Elastic Transcoder добавляет в метаданные выходного файла.

SizingPolicy -> (строка)

Укажите одно из следующих значений для управления масштабированием выходного видео:

Fit : Elastic Transcoder масштабирует выходное видео так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, не превышая другое значение.
Fill : Elastic Transcoder масштабирует выходное видео так, чтобы оно соответствовало значению, указанному в MaxWidth или MaxHeight, и соответствовало или превышало другое значение. Elastic Transcoder центрирует выходное видео, а затем обрезает его в измерении (если таковое имеется), которое превышает максимальное значение.
Stretch : Elastic Transcoder растягивает выходное видео, чтобы оно соответствовало значениям, указанным для MaxWidth и MaxHeight . Если относительные пропорции входного и выходного видео разные, выходное видео будет искажено.
Keep : Elastic Transcoder не масштабирует выходное видео. Если любое измерение входного видео превышает значения, указанные для MaxWidth и MaxHeight, Elastic Transcoder обрезает выходное видео.
ShrinkToFit : Elastic Transcoder уменьшает масштаб выходного видео так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не превышая ни одного из значений. Если вы укажете этот параметр, Elastic Transcoder не будет увеличивать масштаб видео.
ShrinkToFill : Elastic Transcoder уменьшает масштаб выходного видео так, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не уменьшая ни одного из значений. Если вы укажете этот параметр, Elastic Transcoder не будет увеличивать масштаб видео.

PaddingPolicy -> (строка)

Когда вы устанавливаете PaddingPolicy в Pad, Elastic Transcoder может добавить черные полосы в верхнюю и нижнюю части и/или левую и правую стороны выходного видео, чтобы общий размер выходного видео соответствовал значениям, указанным для MaxWidth и MaxHeight .

Watermarks -> (список)

Настройки размера, расположения и непрозрачности графических элементов, которые Elastic Transcoder должен накладывать поверх видео при транскодировании с помощью этого пресета. Вы можете указать настройки для до четырёх водяных знаков. Водяные знаки отображаются указанного размера и расположения с указанной непрозрачностью в течение всего времени транскодирования видео.

Водяные знаки могут быть в формате .png или .jpg. Если вы хотите отобразить водяной знак непрямоугольной формы, используйте формат .png, который поддерживает прозрачность.

При создании задания, использующего этот пресет, вы указываете графические элементы .png или .jpg, которые Elastic Transcoder должен включить в транскодированные видео. Вы можете указать меньше графических элементов в задании, чем настроек водяных знаков в пресете, что позволяет использовать один и тот же пресет для до четырёх водяных знаков с различными размерами.

(структура)

Id -> (строка)

Уникальный идентификатор настроек для одного водяного знака. Значение Id может содержать до 40 символов.

MaxWidth -> (строка)

Максимальная ширина водяного знака в одном из следующих форматов:

количество пикселей (px): Минимальное значение равно 16 пикселям, а максимальное значение равно значению MaxWidth.
целое число в процентах (%): Диапазон допустимых значений от 0 до 100. Используйте значение Target для указания, хотите ли вы, чтобы Elastic Transcoder включал в расчёт чёрные полосы, добавленные Elastic Transcoder, если таковые имеются. Если вы указываете значение в пикселях, оно должно быть меньше или равно значению MaxWidth.

MaxHeight -> (строка)

Максимальная высота водяного знака в одном из следующих форматов:

количество пикселей (px): Минимальное значение равно 16 пикселям, а максимальное значение равно значению MaxHeight.
целое число в процентах (%): Диапазон допустимых значений от 0 до 100. Используйте значение Target для указания, хотите ли вы, чтобы Elastic Transcoder включал в расчёт чёрные полосы, добавленные Elastic Transcoder, если таковые имеются.

Если вы указываете значение в пикселях, оно должно быть меньше или равно значению MaxHeight.

SizingPolicy -> (строка)

Значение, управляющее масштабированием водяного знака:

Fit : Elastic Transcoder масштабирует водяной знак так, чтобы он соответствовал значению, указанному в MaxWidth или MaxHeight, не превышая другое значение.
Stretch : Elastic Transcoder растягивает водяной знак, чтобы соответствовать значениям, указанным для MaxWidth и MaxHeight. Если соотношение сторон водяного знака и значений MaxWidth и MaxHeight различаются, водяной знак будет искажён.
ShrinkToFit : Elastic Transcoder уменьшает масштаб водяного знака, чтобы его размеры соответствовали значениям, указанным для хотя бы одного из MaxWidth и MaxHeight, не превышая ни одного из них. Если вы указываете этот параметр, Elastic Transcoder не увеличивает масштаб водяного знака.

HorizontalAlign -> (строка)

Горизонтальное положение водяного знака, если вы не указали ненулевое значение для HorizontalOffset:

Left : Левый край водяного знака выравнивается с левой границей видео.
Right : Правый край водяного знака выравнивается с правой границей видео.
Center : Водяной знак центрирован между левыми и правыми границами.

HorizontalOffset -> (строка)

Величина смещения горизонтального положения водяного знака от позиции, указанной в HorizontalAlign:

количество пикселей (px): Минимальное значение равно 0 пикселям, а максимальное значение равно значению MaxWidth.
целое число в процентах (%): Диапазон допустимых значений от 0 до 100.

Например, если вы укажете Left для HorizontalAlign и 5px для HorizontalOffset, левый край водяного знака будет смещён на 5 пикселей от левой границы выходного видео.

HorizontalOffset допустимо только тогда, когда значение HorizontalAlign равно Left или Right. Если вы укажете смещение, приводящее к тому, что водяной знак выходит за левую или правую границу, а Elastic Transcoder не добавлял чёрные полосы, водяной знак будет обрезаться. Если Elastic Transcoder добавил чёрные полосы, водяной знак будет частично входить в эти полосы. Если водяной знак выходит за пределы чёрных полос, он будет обрезаться.

Используйте значение Target для указания, хотите ли вы включить чёрные полосы, добавленные Elastic Transcoder, в расчёт смещения.

VerticalAlign -> (строка)

Вертикальное положение водяного знака, если вы не указали ненулевое значение для VerticalOffset:

Top : Верхний край водяного знака выравнивается с верхней границей видео.
Bottom : Нижний край водяного знака выравнивается с нижней границей видео.
Center : Водяной знак центрирован между верхней и нижней границами.

VerticalOffset -> (строка)

VerticalOffset

Величина смещения вертикального положения водяного знака от позиции, указанной в VerticalAlign:

количество пикселей (px): Минимальное значение равно 0 пикселям, а максимальное значение равно значению MaxHeight.
целое число в процентах (%): Диапазон допустимых значений от 0 до 100.

Например, если вы укажете Top для VerticalAlign и 5px для VerticalOffset, верхний край водяного знака будет смещён на 5 пикселей от верхней границы выходного видео.

VerticalOffset допустимо только тогда, когда значение VerticalAlign равно Top или Bottom.

Если вы укажете смещение, приводящее к тому, что водяной знак выходит за верхнюю или нижнюю границу, а Elastic Transcoder не добавлял чёрные полосы, водяной знак будет обрезаться. Если Elastic Transcoder добавил чёрные полосы, водяной знак будет частично входить в эти полосы. Если водяной знак выходит за пределы чёрных полос, он будет обрезаться.

Opacity -> (строка)

Процентное значение, указывающее степень затемнения видео водяным знаком в месте его отображения. Допустимые значения от 0 (водяной знак невидим) до 100 (водяной знак полностью затемняет видео в указанном месте). Тип данных Opacity — float.

Elastic Transcoder поддерживает прозрачные графические элементы .png. Если вы используете прозрачный .png, прозрачная часть видео отображается так, как если бы вы задали значение 0 для Opacity. Формат .jpg не поддерживает прозрачность.

Target -> (строка)

Значение, определяющее, как Elastic Transcoder интерпретирует значения, которые вы указали для HorizontalOffset, VerticalOffset, MaxWidth и MaxHeight:

Content : Значения HorizontalOffset и VerticalOffset рассчитываются на основе границ видео без учёта чёрных полос, добавленных Elastic Transcoder, если таковые имеются. Кроме того, MaxWidth и MaxHeight, если указаны в процентах, рассчитываются на основе границ видео без учёта чёрных полос, добавленных Elastic Transcoder, если таковые имеются.
Frame : Значения HorizontalOffset и VerticalOffset рассчитываются на основе границ видео с учётом чёрных полос, добавленных Elastic Transcoder, если таковые имеются. Кроме того, MaxWidth и MaxHeight, если указаны в процентах, рассчитываются на основе границ видео с учётом чёрных полос, добавленных Elastic Transcoder, если таковые имеются.

Thumbnails -> (структура)

Раздел тела ответа, который предоставляет информацию о значениях предварительно настроенного миниатюрного изображения, если таковые имеются.

Формат -> (строка)

Формат миниатюр, если таковые имеются. Допустимые значения — jpg и png.

Вы указываете, хотите ли вы, чтобы Elastic Transcoder создавал миниатюры при создании задания.

Интервал -> (строка)

Приблизительное количество секунд между миниатюрами. Укажите целое число.

Разрешение -> (строка)

Предупреждение

Для лучшего управления разрешением и соотношением сторон миниатюр мы рекомендуем использовать значения MaxWidth , MaxHeight , SizingPolicy и PaddingPolicy вместо Resolution и AspectRatio. Эти два набора настроек взаимоисключающие. Не используйте их вместе.

Ширина и высота файлов миниатюр в пикселях. Укажите значение в формате « ширина » x « высота », где оба значения — четные целые числа. Значения не могут превышать ширину и высоту, указанные в объекте Video:Resolution.

Соотношение сторон -> (строка)

Предупреждение

Соотношение сторон миниатюр. Допустимые значения включают:

auto , 1:1 , 4:3 , 3:2 , 16:9

Если вы укажете auto, Elastic Transcoder попытается сохранить соотношение сторон видео в выходном файле.

MaxWidth -> (строка)

Максимальная ширина миниатюр в пикселях. Если вы укажете auto, Elastic Transcoder использует значение 1920 (Full HD) по умолчанию. Если вы укажете числовое значение, введите четное целое число от 32 до 4096.

MaxHeight -> (строка)

Максимальная высота миниатюр в пикселях. Если вы укажете auto, Elastic Transcoder использует значение 1080 (Full HD) по умолчанию. Если вы укажете числовое значение, введите четное целое число от 32 до 3072.

SizingPolicy -> (строка)

Укажите одно из следующих значений для управления масштабированием миниатюр:

Fit : Elastic Transcoder масштабирует миниатюры так, чтобы они соответствовали значению, которое вы указали в настройках MaxWidth или MaxHeight миниатюр, не превышая при этом другое значение.
Fill : Elastic Transcoder масштабирует миниатюры так, чтобы они соответствовали значению, которое вы указали в настройках MaxWidth или MaxHeight миниатюр, и соответствовали или превышали другое значение. Elastic Transcoder центрирует изображение в миниатюрах, а затем обрезает размерность (если таковая имеется), которая превышает максимальное значение.
Stretch : Elastic Transcoder растягивает миниатюры, чтобы они соответствовали значениям, которые вы указали для настроек MaxWidth и MaxHeight миниатюр. Если относительные пропорции входного видео и миниатюр отличаются, миниатюры будут искажены.
Keep : Elastic Transcoder не масштабирует миниатюры. Если любая из размерностей входного видео превышает значения, которые вы указали для настроек MaxWidth и MaxHeight миниатюр, Elastic Transcoder обрезает миниатюры.
ShrinkToFit : Elastic Transcoder уменьшает масштаб миниатюр, чтобы их размеры соответствовали значениям, которые вы указали хотя бы для одного из настроек миниатюр MaxWidth и MaxHeight, не превышая ни одно из них. Если вы укажете этот параметр, Elastic Transcoder не будет увеличивать масштаб миниатюр.
ShrinkToFill : Elastic Transcoder уменьшает масштаб миниатюр, чтобы их размеры соответствовали значениям, которые вы указали хотя бы для одного из MaxWidth и MaxHeight, не опускаясь ниже ни одного из них. Если вы укажете этот параметр, Elastic Transcoder не будет увеличивать масштаб миниатюр.

PaddingPolicy -> (строка)

Когда вы устанавливаете PaddingPolicy в значение Pad, Elastic Transcoder может добавлять черные полосы к верхнему и нижнему и/или левому и правому краям миниатюр, чтобы общий размер миниатюр соответствовал значениям, которые вы указали для настроек MaxWidth и MaxHeight миниатюр.

Тип -> (строка)

Является ли пресет предопределенным пресетом, предоставленным Elastic Transcoder (System), или пресетом, который вы определили (Custom).