list-presets

Описание

Операция ListPresets получает список предустановок по умолчанию, включённых с Elastic Transcoder, и предустановок, которые вы добавили в регионе AWS.

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

list-presets является постраничной операцией. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе, содержащем несколько страниц, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Presets

Синтаксис

  list-presets
[--ascending <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--max-items <value>]
[--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]

Параметры

--ascending (строка)

Для перечисления предустановок в хронологическом порядке по дате и времени их создания, введите true. Для перечисления предустановок в обратном хронологическом порядке, введите false.

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

--starting-token (строка)

Токен, определяющий, с какой точки начать постраничную обработку. Это NextToken из ранее усечённого ответа.

Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов, которые должны быть возвращены в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в руководстве пользователя AWS Command Line Interface.

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

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

включить
выключить
авто

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

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

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

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 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.

Получение списка предустановок ElasticTranscoder

В этом примере извлекается список предустановок ElasticTranscoder.

Команда:

aws elastictranscoder list-presets --max-items 2

Вывод:

{
  "Presets": [
      {
          "Container": "mp4",
          "Name": "KindleFireHD-preset",
          "Video": {
              "Resolution": "1280x720",
              "FrameRate": "30",
              "KeyframesMaxDist": "90",
              "FixedGOP": "false",
              "Codec": "H.264",
              "Watermarks": [],
              "CodecOptions": {
                  "Profile": "main",
                  "MaxReferenceFrames": "3",
                  "ColorSpaceConversionMode": "None",
                  "InterlacedMode": "Progressive",
                  "Level": "4"
              },
              "AspectRatio": "16:9",
              "BitRate": "2200"
          },
          "Audio": {
              "Channels": "2",
              "CodecOptions": {
                  "Profile": "AAC-LC"
              },
              "SampleRate": "48000",
              "Codec": "AAC",
              "BitRate": "160"
          },
          "Type": "Custom",
          "Id": "3333333333333-abcde2",
          "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/3333333333333-abcde2",
          "Thumbnails": {
              "AspectRatio": "16:9",
              "Interval": "60",
              "Resolution": "192x108",
              "Format": "png"
          }
      },
      {
          "Thumbnails": {
              "AspectRatio": "16:9",
              "Interval": "60",
              "Resolution": "192x108",
              "Format": "png"
          },
          "Container": "mp4",
          "Description": "Custom preset for transcoding jobs",
          "Video": {
              "Resolution": "1280x720",
              "FrameRate": "30",
              "KeyframesMaxDist": "90",
              "FixedGOP": "false",
              "Codec": "H.264",
              "Watermarks": [],
              "CodecOptions": {
                  "Profile": "main",
                  "MaxReferenceFrames": "3",
                  "ColorSpaceConversionMode": "None",
                  "InterlacedMode": "Progressive",
                  "Level": "3.1"
              },
              "AspectRatio": "16:9",
              "BitRate": "2200"
          },
          "Audio": {
              "Channels": "2",
              "CodecOptions": {
                  "Profile": "AAC-LC"
              },
              "SampleRate": "44100",
              "Codec": "AAC",
              "BitRate": "160"
          },
          "Type": "Custom",
          "Id": "3333333333333-abcde3",
          "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:preset/3333333333333-abcde3",
          "Name": "Roman's Preset"
      }
  ],
  "NextToken": "eyJQYWdlVG9rZW4iOiBudWxsLCAiYm90b190cnVuY2F0ZV9hbW91bnQiOiAyfQ=="
}

Вывод

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

Массив объектов Preset.

(структура)

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

Id -> (строка)

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

Arn -> (строка)

Amazon Resource Name (ARN) для настройки.

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

Название настройки.

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

Описание настройки.

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

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

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

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

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

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

BitDepth -> (строка)

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

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

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

Наиболее распространённая разрядность — 24 .

BitOrder -> (строка)

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

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

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

Signed -> (строка)

Вы можете выбрать, является ли аудиовыборка знаковым, только при указании 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, либо Разрешение. Максимальный буфер декодированных изображений в макроблоках зависит от значения объекта 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 до 62500. Вы можете уменьшить пропускную способность, необходимую для потоковой передачи видео, уменьшив максимальную скорость передачи данных, но это также снижает качество видео.

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

NextPageToken -> (строка)

Значение, используемое для доступа ко второй и последующим страницам результатов, если таковые имеются. Если пресеты помещаются на одной странице или если вы достигли последней страницы результатов, значение NextPageToken равно null.