create-preset

Описание

Операция CreatePreset создает предустановку с заданными вами параметрами.

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

Elastic Transcoder проверяет параметры CreatePreset, чтобы убедиться, что они соответствуют требованиям Elastic Transcoder и стандартам H.264. Если ваши параметры недействительны для Elastic Transcoder, Elastic Transcoder возвращает HTTP-ответ 400 (ValidationException) и не создает предустановку. Если параметры действительны для Elastic Transcoder, но не строго соответствуют стандарту H.264, Elastic Transcoder создает предустановку и возвращает сообщение об ошибке в ответе. Это поможет вам определить, соответствуют ли ваши параметры стандарту H.264, предоставляя большую гибкость в отношении видео, которое создает Elastic Transcoder.

Elastic Transcoder использует формат сжатия видео H.264. Более подробная информация доступна в публикации Международного союза электросвязи Рекомендация МСЭ-Т H.264: Расширенное кодирование видео для универсальных аудиовизуальных служб.

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

Синтаксис

  create-preset
--name <value>
[--description <value>]
--container <value>
[--video <value>]
[--audio <value>]
[--thumbnails <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]

Параметры

--name (строка)

Название пресета. Рекомендуется, чтобы имя было уникальным в рамках учетной записи AWS, но уникальность не проверяется.

--description (строка)

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

--container (строка)

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

--video (структура)

Раздел тела запроса, определяющий параметры видео.

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 (каждый кадр — ключевой) до 100000 включительно. Более высокое значение приводит к большей степени сжатия, но также может заметно снизить качество видео.

Для вывода 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.

Например, если для HorizontalAlign указано Left, а для HorizontalOffset — 5px, левый край водяного знака будет смещён на 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 указано Top, а для VerticalAlign — 5px, верхний край водяного знака будет смещён на 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, если таковые есть.

Краткая запись:

Codec=string,CodecOptions={KeyName1=string,KeyName2=string},KeyframesMaxDist=string,FixedGOP=string,BitRate=string,FrameRate=string,MaxFrameRate=string,Resolution=string,AspectRatio=string,MaxWidth=string,MaxHeight=string,DisplayAspectRatio=string,SizingPolicy=string,PaddingPolicy=string,Watermarks=[{Id=string,MaxWidth=string,MaxHeight=string,SizingPolicy=string,HorizontalAlign=string,HorizontalOffset=string,VerticalAlign=string,VerticalOffset=string,Opacity=string,Target=string},{Id=string,MaxWidth=string,MaxHeight=string,SizingPolicy=string,HorizontalAlign=string,HorizontalOffset=string,VerticalAlign=string,VerticalOffset=string,Opacity=string,Target=string}]

Синтаксис JSON:

{
  "Codec": "string",
  "CodecOptions": {"string": "string"
    ...},
  "KeyframesMaxDist": "string",
  "FixedGOP": "string",
  "BitRate": "string",
  "FrameRate": "string",
  "MaxFrameRate": "string",
  "Resolution": "string",
  "AspectRatio": "string",
  "MaxWidth": "string",
  "MaxHeight": "string",
  "DisplayAspectRatio": "string",
  "SizingPolicy": "string",
  "PaddingPolicy": "string",
  "Watermarks": [
    {
      "Id": "string",
      "MaxWidth": "string",
      "MaxHeight": "string",
      "SizingPolicy": "string",
      "HorizontalAlign": "string",
      "HorizontalOffset": "string",
      "VerticalAlign": "string",
      "VerticalOffset": "string",
      "Opacity": "string",
      "Target": "string"
    }
    ...
  ]
}

--audio (структура)

Раздел тела запроса, определяющий параметры аудио.

Codec -> (строка)

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

SampleRate -> (строка)

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

auto , 22050 , 32000 , 44100 , 48000 , 96000

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

BitRate -> (строка)

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

Channels -> (строка)

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

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, или дорожками без звука.

Выходные значения 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 выберет профиль на основе битрейта выходного файла.

Profile -> (строка)

Вы можете выбрать аудиопрофиль только при указании 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. Вы можете изменить значение по мере необходимости.

BitDepth -> (строка)

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

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

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

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

BitOrder -> (строка)

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

Порядок, в котором хранятся биты PCM-выборки.

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

Signed -> (строка)

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

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

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

Синтаксис сокращённой записи:

Codec=string,SampleRate=string,BitRate=string,Channels=string,AudioPackingMode=string,CodecOptions={Profile=string,BitDepth=string,BitOrder=string,Signed=string}

Синтаксис JSON:

{
  "Codec": "string",
  "SampleRate": "string",
  "BitRate": "string",
  "Channels": "string",
  "AudioPackingMode": "string",
  "CodecOptions": {
    "Profile": "string",
    "BitDepth": "string",
    "BitOrder": "string",
    "Signed": "string"
  }
}

--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.

Сокращенная синтаксическая запись:

Format=string,Interval=string,Resolution=string,AspectRatio=string,MaxWidth=string,MaxHeight=string,SizingPolicy=string,PaddingPolicy=string

Синтаксис JSON:

{
  "Format": "string",
  "Interval": "string",
  "Resolution": "string",
  "AspectRatio": "string",
  "MaxWidth": "string",
  "MaxHeight": "string",
  "SizingPolicy": "string",
  "PaddingPolicy": "string"
}

--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 V1, а двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, отображаемого как двоичный блок, fileb:// всегда будет обрабатываться как двоичный и будет использовать содержимое файла непосредственно независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

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

Отключить вывод пейджера CLI.

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

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

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

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

Примеры

Примечание

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

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

Для создания пресета для Elastic Transcoder

Следующий пример create-preset создаёт пресет для Elastic Transcoder.

aws elastictranscoder create-preset \
    --name DefaultPreset \
    --description "Use for published videos" \
    --container mp4 \
    --video file://video.json \
    --audio file://audio.json \
    --thumbnails file://thumbnails.json

Содержимое video.json:

{
    "Codec":"H.264",
    "CodecOptions":{
        "Profile":"main",
        "Level":"2.2",
        "MaxReferenceFrames":"3",
        "MaxBitRate":"",
        "BufferSize":"",
        "InterlacedMode":"Progressive",
        "ColorSpaceConversionMode":"None"
    },
    "KeyframesMaxDist":"240",
    "FixedGOP":"false",
    "BitRate":"1600",
    "FrameRate":"auto",
    "MaxFrameRate":"30",
    "MaxWidth":"auto",
    "MaxHeight":"auto",
    "SizingPolicy":"Fit",
    "PaddingPolicy":"Pad",
    "DisplayAspectRatio":"auto",
    "Watermarks":[
        {
            "Id":"company logo",
            "MaxWidth":"20%",
            "MaxHeight":"20%",
            "SizingPolicy":"ShrinkToFit",
            "HorizontalAlign":"Right",
            "HorizontalOffset":"10px",
            "VerticalAlign":"Bottom",
            "VerticalOffset":"10px",
            "Opacity":"55.5",
            "Target":"Content"
        }
    ]
}

Содержимое audio.json:

{
    "Codec":"AAC",
    "CodecOptions":{
        "Profile":"AAC-LC"
    },
    "SampleRate":"44100",
    "BitRate":"96",
    "Channels":"2"
}

Содержимое thumbnails.json:

{
    "Format":"png",
    "Interval":"120",
    "MaxWidth":"auto",
    "MaxHeight":"auto",
    "SizingPolicy":"Fit",
    "PaddingPolicy":"Pad"
}

Вывод:

{
    "Preset": {
        "Thumbnails": {
            "SizingPolicy": "Fit",
            "MaxWidth": "auto",
            "Format": "png",
            "PaddingPolicy": "Pad",
            "Interval": "120",
            "MaxHeight": "auto"
        },
        "Container": "mp4",
        "Description": "Use for published videos",
        "Video": {
            "SizingPolicy": "Fit",
            "MaxWidth": "auto",
            "PaddingPolicy": "Pad",
            "MaxFrameRate": "30",
            "FrameRate": "auto",
            "MaxHeight": "auto",
            "KeyframesMaxDist": "240",
            "FixedGOP": "false",
            "Codec": "H.264",
            "Watermarks": [
                {
                    "SizingPolicy": "ShrinkToFit",
                    "VerticalOffset": "10px",
                    "VerticalAlign": "Bottom",
                    "Target": "Content",
                    "MaxWidth": "20%",
                    "MaxHeight": "20%",
                    "HorizontalAlign": "Right",
                    "HorizontalOffset": "10px",
                    "Opacity": "55.5",
                    "Id": "company logo"
                }
            ],
            "CodecOptions": {
                "Profile": "main",
                "MaxBitRate": "32",
                "InterlacedMode": "Progressive",
                "Level": "2.2",
                "ColorSpaceConversionMode": "None",
                "MaxReferenceFrames": "3",
                "BufferSize": "5"
            },
            "BitRate": "1600",
            "DisplayAspectRatio": "auto"
        },
        "Audio": {
            "Channels": "2",
            "CodecOptions": {
                "Profile": "AAC-LC"
            },
            "SampleRate": "44100",
            "Codec": "AAC",
            "BitRate": "96"
        },
        "Type": "Custom",
        "Id": "1533765290724-example"
        "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/1533765290724-example",
        "Name": "DefaultPreset"
    },
    "Warning": ""
}

Вывод

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

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

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 .

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

Метод организации аудиоканалов и дорожек. Используйте 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, пока не будет восемь дорожек.

Параметры кодека -> (структура)

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

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

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

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

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

Укажите профиль 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 для значения Аудио:Кодек.

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

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

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

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

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

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

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

С знаком -> (строка)

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

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

Поддерживаемое значение — 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)

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 включительно.

key -> (строка)

value -> (строка)

KeyframesMaxDist -> (строка)

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

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

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

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

Альтернативно, это можно достичь, установив FrameRate в авто и имея одинаковые значения для 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 -> (строка)

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 -> (строка)

MaxHeight -> (строка)

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).

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

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