create-job

Описание

При создании задания Elastic Transcoder возвращает данные JSON, содержащие указанные вами значения и информацию о созданном задании.

Если для задания указано несколько выходов (например, один выход для Kindle Fire и другой для Apple iPhone 4s), вам необходимо использовать API Elastic Transcoder для отображения заданий (вместо консоли AWS).

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

Синтаксис

  create-job
--pipeline-id <value>
[--input <value>]
[--inputs <value>]
[--outputs <value>]
[--output-key-prefix <value>]
[--playlists <value>]
[--user-metadata <value>]
[--job-output <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]

Параметры

--pipeline-id (строка)

Идентификатор (pipeline) потока, который вы хотите использовать Elastic Transcoder для транскодирования. Поток определяет несколько настроек, включая Amazon S3-ведро, из которого Elastic Transcoder получает файлы для транскодирования, и ведро, в которое Elastic Transcoder помещает транскодированные файлы.

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

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

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

Имя файла для транскодирования. В другом месте тела блока JSON находится идентификатор используемого потока для обработки задания. Объект InputBucket в этом потоке сообщает Elastic Transcoder, из какого Amazon S3-ведра получить файл.

Если имя файла содержит префикс, например, cooking/lasagna.mpg, включите префикс в ключ. Если файла нет в указанном ведре, Elastic Transcoder возвращает ошибку.

FrameRate -> (строка)

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

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

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

Resolution -> (строка)

Это значение должно быть auto, что заставляет Elastic Transcoder автоматически определять разрешение входного файла.

AspectRatio -> (строка)

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

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

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

Interlaced -> (строка)

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

true , false

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

Container -> (строка)

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

3gp , aac , asf , avi , divx , flv , m4a , mkv , mov , mp3 , mp4 , mpeg , mpeg-ps , mpeg-ts , mxf , ogg , vob , wav , webm

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

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

Mode -> (строка)

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

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить желаемый ключ AWS-KMS в свой поток.
aes-cbc-pkcs7: Заполненная схема шифрования блоков, изначально использовавшаяся для файлов HLS.
aes-ctr: AES режим подсчета.
aes-gcm: AES режим подсчета с галоисом, режим работы, представляющий собой аутентифицированный формат шифрования, означающий, что файл, ключ или вектор инициализации, которые были изменены, не пройдут процесс расшифровки.

Для всех трех режимов AES вам необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши закрытые ключи шифрования и ваши незашифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите использовать Elastic Transcoder для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах должна быть одной из следующих:

128 , 192 , или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64, и его длина должна составлять ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

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

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

Настройки для обрезки входных данных. У каждого входа могут быть разные настройки обрезки.

StartTime -> (строка)

Место в входном файле, где вы хотите начать обрезку. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если значение не указано, Elastic Transcoder начинает с начала входного файла.

Duration -> (строка)

Продолжительность обрезки. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если значение не указано, Elastic Transcoder создает выходной файл от StartTime до конца файла.

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

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

Вы можете настроить Elastic Transcoder для транскодирования субтитров из одного формата в другой. Все субтитры должны быть в формате UTF-8. Elastic Transcoder поддерживает два типа субтитров:

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
В отдельных файлах: Субтитры в отдельных файлах хранятся в отдельном файле метаданных от аудио и видео данных. Для субтитров в отдельных файлах необходим плеер, способный понимать взаимосвязь между видеофайлом и файлом субтитров. Elastic Transcoder поддерживает только один субтитр в отдельных файлах на язык, максимум 20 субтитров в отдельных файлах на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого ввода для субтитров и не доступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить субтитры пустыми, установите Captions в значение null. Чтобы оставить существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию о файлах в отдельных файлах см. на страницах Wikipedia о платформе расширяемых метаданных и файлах в отдельных файлах.

MergePolicy -> (строка)

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

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и субтитры в отдельных файлах в выходы. Если субтитры на языке введены в файле и также присутствуют в файле субтитров в отдельных файлах, Elastic Transcoder использует субтитры из файла в отдельных файлах и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и субтитры в отдельных файлах в выходы. Если субтитры на языке введены в файле и также присутствуют в файле субтитров в отдельных файлах, Elastic Transcoder использует встроенные субтитры и игнорирует субтитры из файла в отдельных файлах для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все субтитры из файла в отдельных файлах из выходных файлов.
Override: Elastic Transcoder транскодирует только субтитры из файла в отдельных файлах, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для субтитров в отдельных файлах, используемые в процессе транскодирования. Чтобы пропустить все субтитры в отдельных файлах, оставьте CaptionSources пустым.

(структура)

Исходный файл для субтитров в отдельных файлах, используемый в процессе транскодирования.

Key -> (строка)

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

Language -> (строка)

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

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и именах языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

Для создания фрагментов или субтитров, которые не начинаются в то же время, что и соответствующий видеофайл, TimeOffset указывает Elastic Transcoder, сколько видео нужно закодировать до включения субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

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

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

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

Mode -> (строка)

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

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать стандартный ключ, вы должны добавить ключ AWS-KMS, который хотите использовать в свою pipeline.
aes-cbc-pkcs7: Метод шифрования в режиме блоков с заполнением, изначально использовавшийся для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES в режиме Galois/Counter Mode — это режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, в которых обнаружены изменения, не пройдут процесс дешифрования.

Для всех трёх вариантов AES вам необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

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

128 , 192 , или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (длинное целое число)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (длинное целое число)

Обнаруженная длительность входного файла в миллисекундах.

Синтаксис JSON:

{
  "Key": "string",
  "FrameRate": "string",
  "Resolution": "string",
  "AspectRatio": "string",
  "Interlaced": "string",
  "Container": "string",
  "Encryption": {
    "Mode": "string",
    "Key": "string",
    "KeyMd5": "string",
    "InitializationVector": "string"
  },
  "TimeSpan": {
    "StartTime": "string",
    "Duration": "string"
  },
  "InputCaptions": {
    "MergePolicy": "string",
    "CaptionSources": [
      {
        "Key": "string",
        "Language": "string",
        "TimeOffset": "string",
        "Label": "string",
        "Encryption": {
          "Mode": "string",
          "Key": "string",
          "KeyMd5": "string",
          "InitializationVector": "string"
        }
      }
      ...
    ]
  },
  "DetectedProperties": {
    "Width": integer,
    "Height": integer,
    "FrameRate": "string",
    "FileSize": long,
    "DurationMillis": long
  }
}

--inputs (список)

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

(структура)

Информация о файле, который вы транскодируете.

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

Имя файла для транскодирования. В другом месте тела блока JSON указан идентификатор используемой для обработки задания конвейерной линии. Объект InputBucket в этой конвейерной линии указывает Elastic Transcoder, из какого Amazon S3-бакета получить файл.

Если имя файла включает префикс, например, cooking/lasagna.mpg , включите префикс в ключ. Если файла нет в указанном бакете, Elastic Transcoder возвращает ошибку.

FrameRate -> (строка)

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

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

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

Resolution -> (строка)

Это значение должно быть auto, что заставляет Elastic Transcoder автоматически определять разрешение входного файла.

AspectRatio -> (строка)

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

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

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

Interlaced -> (строка)

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

true , false

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

Container -> (строка)

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

3gp , aac , asf , avi , divx , flv , m4a , mkv , mov , mp3 , mp4 , mpeg , mpeg-ps , mpeg-ts , mxf , ogg , vob , wav , webm

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

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

Mode -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите, чтобы Elastic Transcoder использовал при дешифровании входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS-ключ в свою конвейерную линию.
aes-cbc-pkcs7: Режим блочного шифрования с заполнением, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим подсчета AES.
aes-gcm: Режим подсчета AES Galois, режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, подвергнутые изменениям, не проходят процесс дешифровки.

Для всех трех вариантов AES необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Key -> (строка)

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байтов до кодирования в base64.

InitializationVector -> (строка)

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

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

Настройки для обрезки входного файла. Каждый входной файл может иметь разные настройки обрезки.

StartTime -> (строка)

Место в входном файле, с которого должна начаться обрезка. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнет с начала входного файла.

Duration -> (строка)

Продолжительность обрезки. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

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

Вы можете настроить Elastic Transcoder для транскодирования субтитров или титров из одного формата в другой. Все субтитры должны быть в формате UTF-8. Elastic Transcoder поддерживает два типа субтитров:

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на языке, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видео данных. Внешние субтитры требуют проигрывателя, способного понимать связь между видеофайлом и внешним файлом. Elastic Transcoder поддерживает только один внешний субтитр на язык, максимум 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вы хотите субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения как допустимый вход для субтитров и не доступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы оставить существующие субтитры без изменений, установите MergePolicy в значение MergeRetain и передайте в CaptionSources массив null.

Для получения дополнительной информации об встроенных файлах, см. страницу Wikipedia по субтитрам.

Для получения дополнительной информации о внешних файлах, см. страницы Wikipedia по Extensible Metadata Platform и внешним файлам.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает существование нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, которые вы указали в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для внешних субтитров, используемые во время процесса транскодирования. Чтобы опустить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для внешних субтитров, используемый во время процесса транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

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

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Для получения дополнительной информации о кодах ISO для языков и именах языков, см. список кодов ISO 639-1.

TimeOffset -> (строка)

Для генерации клипов или субтитров, которые не начинаются одновременно с соответствующим видеофайлом, TimeOffset сообщает Elastic Transcoder, сколько видео кодировать до включения субтитров.

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Рекомендуется указывать здесь название языка субтитров на том же языке.

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

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в свою конвейерную линию.
aes-cbc-pkcs7: Защищенная схема блочного шифрования, изначально использовавшаяся для файлов HLS.
aes-ctr: AES режим счетчика.
aes-gcm: AES режим галоисовского счетчика, режим, являющийся аутентифицированным режимом шифрования, означающим, что поврежденный файл, ключ или начальный вектор не проходят процесс дешифрования.

Для всех трех вариантов AES необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши приватные ключи шифрования и нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать ваши данные.

Key -> (строка)

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

128 , 192 , или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

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

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

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (длинное целое число)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (длинное целое число)

Обнаруженная продолжительность входного файла в миллисекундах.

Синтаксис JSON:

[
  {
    "Key": "string",
    "FrameRate": "string",
    "Resolution": "string",
    "AspectRatio": "string",
    "Interlaced": "string",
    "Container": "string",
    "Encryption": {
      "Mode": "string",
      "Key": "string",
      "KeyMd5": "string",
      "InitializationVector": "string"
    },
    "TimeSpan": {
      "StartTime": "string",
      "Duration": "string"
    },
    "InputCaptions": {
      "MergePolicy": "string",
      "CaptionSources": [
        {
          "Key": "string",
          "Language": "string",
          "TimeOffset": "string",
          "Label": "string",
          "Encryption": {
            "Mode": "string",
            "Key": "string",
            "KeyMd5": "string",
            "InitializationVector": "string"
          }
        }
        ...
      ]
    },
    "DetectedProperties": {
      "Width": integer,
      "Height": integer,
      "FrameRate": "string",
      "FileSize": long,
      "DurationMillis": long
    }
  }
  ...
]

--outputs (список)

Раздел тела запроса, который предоставляет информацию о транскодированных (целевых) файлах. Рекомендуется использовать синтаксис Outputs вместо синтаксиса Output.

(структура)

Структура CreateJobOutput.

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

Имя, которое нужно назначить закодированному файлу. Elastic Transcoder сохраняет файл в ведре Amazon S3, указанном объектом OutputBucket в конвейере, который задан идентификатором конвейера. Если файл с указанным именем уже существует в выходном ведре, работа завершается ошибкой.

Шаблон миниатюры -> (строка)

Указывает, хотите ли вы, чтобы Elastic Transcoder создавал миниатюры для ваших видео и, если да, как вы хотите, чтобы Elastic Transcoder называл файлы.

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

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

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объект ThumbnailPattern. В любом месте, где вы указываете {count}, Elastic Transcoder добавляет пятизначный порядковый номер (начиная с 00001) к именам файлов миниатюр. Номер указывает местоположение данной миниатюры в последовательности миниатюр для закодированного файла.

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

Если вы указываете буквальное значение и/или {resolution}, но пропускаете {count}, Elastic Transcoder возвращает ошибку валидации и не создает задачу.

Буквальные значения (Необязательно) : Вы можете указать буквальные значения в любом месте объекта ThumbnailPattern. Например, вы можете включить их в качестве префикса имени файла или разделителя между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объект ThumbnailPattern.

При создании миниатюр Elastic Transcoder автоматически сохраняет файлы в формате (.jpg или .png), который отображается в предустановке, указанной в значении PresetID объекта CreateJobOutput. Elastic Transcoder также добавляет соответствующее расширение имени файла.

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

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

Режим -> (строка)

Конкретный режим шифрования на стороне сервера, который вы хотите, чтобы Elastic Transcoder использовал при расшифровке входных файлов или шифровании выходных файлов. Elastic Transcoder поддерживает следующие варианты:

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим работы блочного шифра, первоначально использовавшийся для файлов HLS.
aes-ctr: AES режим счётчика.
aes-gcm: AES Galois Counter Mode, режим работы, представляющий собой формат аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся взлому, не проходят процесс расшифровки.

Для всех трёх вариантов AES необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

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

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

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

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

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

Поворот -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите, чтобы Elastic Transcoder повернул выходной файл относительно входного. Введите одно из следующих значений: auto , 0 , 90 , 180 , 270. Значение auto обычно работает только в том случае, если файл, который вы транскодируете, содержит метаданные поворота.

PresetId -> (строка)

Идентификатор Id предустановки, которую нужно использовать для этой задачи. Предустановка определяет настройки аудио, видео и миниатюр, которые Elastic Transcoder использует для транскодирования.

SegmentDuration -> (строка)

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

(Только для вывода в формате Fragmented MP4 или MPEG-TS)

Если вы указываете предустановку в PresetId, для которой значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration — это максимальная длительность каждого сегмента в секундах. Для плейлистов формата HLSv3 каждый сегмент медиа хранится в отдельном файле .ts. Для плейлистов HLSv4 и Smooth все сегменты медиа для вывода сохраняются в одном файле. Каждый сегмент имеет примерно длину SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений — от 1 до 60 секунд. Если продолжительность видео не делится на SegmentDuration без остатка, продолжительность последнего сегмента составляет остаток от деления общей длительности на SegmentDuration.

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

Watermarks -> (список)

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

(структура)

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

PresetWatermarkId -> (строка)

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

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать для водяного знака. Чтобы определить, в каком ведре Amazon S3 содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный в Pipeline; объект Input Bucket в этом конвейере определяет ведро.

Если имя файла включает префикс, например, logos/128x64.png, включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

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

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

Режим -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим работы блочного шифра, первоначально использовавшийся для файлов HLS.
aes-ctr: AES режим счётчика.
aes-gcm: AES Galois Counter Mode, режим работы, представляющий собой формат аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся взлому, не проходят процесс расшифровки.

Ключ
MD5 ключа
Вектор инициализации

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

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

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

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

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

MergePolicy -> (строка)

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

Replace: Указанная обложка заменяет любую существующую обложку.
Prepend: Указанная обложка помещается перед любой существующей обложкой.
Append: Указанная обложка помещается после любой существующей обложки.
Fallback: Если исходный входной файл содержит обложку, Elastic Transcoder использует эту обложку для выходного файла. Если исходный входной файл не содержит обложки, Elastic Transcoder использует указанный файл обложки.

Artwork -> (список)

Файл, который будет использоваться как обложка альбома. Может быть несколько обложек, связанных с аудиофайлом, максимум 20. Допустимые форматы — .jpg и .png

(структура)

Файл, который будет использоваться как обложка альбома. Может быть несколько обложек, связанных с аудиофайлом, максимум 20.

Чтобы удалить обложку или оставить ее пустой, можно установить Artwork в значение null или установить Merge Policy в «Replace» и использовать пустой массив Artwork.

Чтобы сохранить существующую обложку без изменений, установите Merge Policy в «Prepend», «Append» или «Fallback» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, который будет использоваться как обложка альбома. Для определения того, в каком ведре Amazon S3 находится указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId; объект InputBucket в этом конвейере определяет ведро.

Если имя файла включает префикс, например, cooking/pie.jpg, включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder вернёт ошибку.

MaxWidth -> (строка)

Максимальная ширина выходной обложки в пикселях. Если вы указываете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы указываете числовое значение, введите чётное целое число от 32 до 4096 включительно.

MaxHeight -> (строка)

Максимальная высота выходной обложки в пикселях. Если вы указываете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы указываете числовое значение, введите чётное целое число от 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.

AlbumArtFormat -> (строка)

Формат обложки альбома, если таковой имеется. Допустимые форматы — .jpg и .png.

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

Настройки шифрования, если таковые имеются, которые вы хотите, чтобы Elastic Transcoder применил к вашим изображениям обложек.

Mode -> (строка)

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

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить нужный ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Зашифрованный режим с заливкой блока, первоначально использовавшийся для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES-режим Galois/Counter Mode, режим, представляющий собой формат аутентифицированного шифрования, то есть файл, ключ или вектор инициализации, которые были изменены, не пройдут процесс дешифрования.

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

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

128 , 192 или 256 .

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Composition -> (список)

Вы можете создать выходной файл, содержащий фрагмент входного файла. Этот фрагмент, называемый клипом, может быть из начала, середины или конца файла. Объект Composition содержит настройки клипов, из которых состоит выходной файл. В текущей версии вы можете указать настройки только для одного клипа на выходной файл. Объект Composition не может быть null.

(структура)

Настройки одного клипа в композиции. Все задания в плейлисте должны иметь одинаковые настройки клипов.

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

Настройки, определяющие, когда начинается клип и как долго он длится.

StartTime -> (строка)

Место в входном файле, где вы хотите начать клип. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Длительность клипа. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

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

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитры для каждого языка, до максимального количества 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый ненулевой канал), CEA-708 (EIA-708 , только первый ненулевой канал), и mov-text Допустимые выходные значения включают: mov-text Elastic Transcoder поддерживает максимум один встроенный формат на вывод.
В виде отдельного файла: Субтитры в виде отдельного файла хранятся в отдельном метаданных файле от аудио и видео данных. Субтитры в виде отдельного файла требуют проигрывателя, способного понимать взаимосвязь между видеофайлом и файлом отдельного файла. Elastic Transcoder поддерживает только один субтитр в виде отдельного файла для каждого языка, до максимального количества 20 субтитров в виде отдельного файла на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt .

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения как допустимый ввод для субтитров и недоступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы передать существующие субтитры без изменений, установите MergePolicy в значение MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию о файлах в виде отдельного файла см. на страницах Wikipedia о расширяемой платформе метаданных и файлах в виде отдельного файла.

MergePolicy -> (строка)

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

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и субтитры в виде отдельного файла в выводы. Если субтитры для языка встроены в входной файл и также присутствуют в файле в виде отдельного файла, Elastic Transcoder использует субтитры в виде отдельного файла и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и субтитры в виде отдельного файла в выводы. Если субтитры для языка встроены в входной файл и также присутствуют в файле в виде отдельного файла, Elastic Transcoder использует встроенные субтитры и игнорирует субтитры в виде отдельного файла для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все субтитры в виде отдельного файла из выходных файлов.
Override: Elastic Transcoder транскодирует только субтитры в виде отдельного файла, указанные в CaptionSources .

MergePolicy не может быть null.

CaptionSources -> (список)

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

(структура)

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

Key -> (строка)

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

Language -> (строка)

Строка, указывающая язык субтитров. Если вы указали несколько входных данных с субтитрами, язык субтитров должен совпадать, чтобы они были включены в вывод. Укажите это как один из:

2-х символьный код ISO 639-1
3-х символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Мы рекомендуем поместить здесь название языка субтитров на языке самих субтитров.

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

Mode -> (строка)

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

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить желаемый ключ AWS-KMS в вашу конвейерную линию.
aes-cbc-pkcs7: Паддинг шифрование в блочном режиме, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся несанкционированному изменению, не пройдут процесс дешифрования.

Для всех трех вариантов AES вы должны предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши приватные ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать данные.

Key -> (строка)

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных бит, созданных генератором случайных чисел, уникальных для каждой операции шифрования, которые вы использовали для шифрования входных файлов или которые вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь ровно 16 байт перед кодированием в base64.

CaptionFormats -> (список)

```

Массив форматов файлов для выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

(структура)

Формат файла выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

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

Указанный вами формат определяет, генерирует ли Elastic Transcoder встроенные или отдельные субтитры для этого вывода.

Допустимые форматы встроенных субтитров:
- для FLAC : Нет
- Для MP3 : Нет
- Для MP4 : mov-text
- Для MPEG-TS : Нет
- Для ogg : Нет
- Для webm : Нет
Допустимые форматы отдельных субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры, совместимые с ttml или smpte-tt, укажите dfxp в качестве формата вывода.
- Для FMP4 : dfxp
- Выходы, не являющиеся FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров в формате описание -{language} , где:

описание - описание видео.
{language} - это литеральное значение, которое Elastic Transcoder заменяет двух- или трёхбуквенным кодом языка субтитров в именах выходных файлов.

Если вы не включите {language} в шаблон имени файла, Elastic Transcoder автоматически добавляет «{language} » к значению, которое вы указали для описания. Кроме того, Elastic Transcoder автоматически добавляет номер к концам файлов сегментов.

Например, предположим, что вы транскодируете в формат srt. Когда вы вводите «Sydney-{язык}-восход», а язык субтитров — английский (en), имя первого файла субтитров будет Sydney-en-восход00000.srt.

Шифрование -> (структура)

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

Режим -> (строка)

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

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить требуемый ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим шифрования блоков с набиванием, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, которые были изменены, не пройдут процесс расшифровки.

Для всех трёх режимов AES необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши личные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

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

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Шифрование -> (структура)

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

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить требуемый ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим шифрования блоков с набиванием, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, которые были изменены, не пройдут процесс расшифровки.

Ключ
MD5 ключа
Вектор инициализации

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

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

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Синтаксис JSON:

[
  {
    "Key": "string",
    "ThumbnailPattern": "string",
    "ThumbnailEncryption": {
      "Mode": "string",
      "Key": "string",
      "KeyMd5": "string",
      "InitializationVector": "string"
    },
    "Rotate": "string",
    "PresetId": "string",
    "SegmentDuration": "string",
    "Watermarks": [
      {
        "PresetWatermarkId": "string",
        "InputKey": "string",
        "Encryption": {
          "Mode": "string",
          "Key": "string",
          "KeyMd5": "string",
          "InitializationVector": "string"
        }
      }
      ...
    ],
    "AlbumArt": {
      "MergePolicy": "string",
      "Artwork": [
        {
          "InputKey": "string",
          "MaxWidth": "string",
          "MaxHeight": "string",
          "SizingPolicy": "string",
          "PaddingPolicy": "string",
          "AlbumArtFormat": "string",
          "Encryption": {
            "Mode": "string",
            "Key": "string",
            "KeyMd5": "string",
            "InitializationVector": "string"
          }
        }
        ...
      ]
    },
    "Composition": [
      {
        "TimeSpan": {
          "StartTime": "string",
          "Duration": "string"
        }
      }
      ...
    ],
    "Captions": {
      "MergePolicy": "string",
      "CaptionSources": [
        {
          "Key": "string",
          "Language": "string",
          "TimeOffset": "string",
          "Label": "string",
          "Encryption": {
            "Mode": "string",
            "Key": "string",
            "KeyMd5": "string",
            "InitializationVector": "string"
          }
        }
        ...
      ],
      "CaptionFormats": [
        {
          "Format": "string",
          "Pattern": "string",
          "Encryption": {
            "Mode": "string",
            "Key": "string",
            "KeyMd5": "string",
            "InitializationVector": "string"
          }
        }
        ...
      ]
    },
    "Encryption": {
      "Mode": "string",
      "Key": "string",
      "KeyMd5": "string",
      "InitializationVector": "string"
    }
  }
  ...
]

--output-key-prefix (строка)

Значение (при наличии), которое вы хотите, чтобы Elastic Transcoder добавлял в начало имён всех файлов, созданных этим заданием, включая выходные файлы, миниатюры и плейлисты.

--playlists (список)

Если вы указали пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), Playlists содержит информацию о мастер-плейлистах, которые вы хотите создать с помощью Elastic Transcoder.

Максимальное количество мастер-плейлистов в задании составляет 30.

(структура)

Информация о мастер-плейлисте.

Name -> (строка)

Имя, которое вы хотите назначить мастер-плейлисту, например, nyc-vacation.m3u8. Если имя содержит / символ, то часть имени до последнего / должна быть идентична для всех Name объектов. Если вы создаёте более одного мастер-плейлиста, значения всех Name объектов должны быть уникальными.

Примечание

Elastic Transcoder автоматически добавляет соответствующее расширение файла к имени файла (.m3u8 для HLSv3 и HLSv4 плейлистов, и .ism и .ismc для Smooth плейлистов). Если вы включаете расширение файла в Name, имя файла будет иметь два расширения.

Format -> (строка)

Формат выходного плейлиста. Допустимые форматы включают HLSv3 , HLSv4 и Smooth .

OutputKeys -> (список)

Для каждого вывода в этом задании, который вы хотите включить в мастер-плейлист, значение объекта Outputs:Key.

Если ваш вывод не HLS или не имеет установленной длительности сегмента, имя выходного файла представляет собой конкатенацию OutputKeyPrefix и Outputs:Key: OutputKeyPrefix``Outputs:Key``
Если ваш вывод является HLSv3 и имеет установленную длительность сегмента или не включён в плейлист, Elastic Transcoder создаёт файл выходного плейлиста с расширением .m3u8 и серию файлов .ts, которые включают пятизначный порядковый счётчик, начинающийся с 00000: OutputKeyPrefix``Outputs:Key`` .m3u8 OutputKeyPrefix``Outputs:Key`` 00000.ts
Если ваш вывод является HLSv4, имеет установленную длительность сегмента и включён в HLSv4 плейлист, Elastic Transcoder создаёт файл выходного плейлиста с расширением _v4.m3u8. Если вывод является видео, Elastic Transcoder также создаёт выходной файл с расширением _iframe.m3u8: OutputKeyPrefix``Outputs:Key`` _v4.m3u8 OutputKeyPrefix``Outputs:Key`` _iframe.m3u8 OutputKeyPrefix``Outputs:Key`` .ts

Elastic Transcoder автоматически добавляет соответствующее расширение файла к имени файла. Если вы включаете расширение файла в ключ вывода, имя файла будет иметь два расширения.

Если вы включаете более одного вывода в плейлист, любые настройки длительности сегмента, настройки клипа или настройки субтитров должны быть одинаковыми для всех выводов в плейлисте. Для Smooth плейлистов Audio:Profile , Video:Profile и Video:FrameRate по Video:KeyframesMaxDist отношению должны быть одинаковыми для всех выводов.

(строка)

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

Настройки защиты контента HLS, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Method -> (строка)

Метод защиты контента для вашего вывода. Единственное допустимое значение: aes-128 .

Это значение записывается в атрибут method тега метаданных EXT-X-KEY в выходном плейлисте.

Key -> (строка)

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

Если вы решите предоставить свой собственный ключ, вы должны зашифровать его с помощью AWS KMS. Ключ должен быть закодирован в base64, и он должен иметь один из следующих битовых длин до кодирования в base64:

128 , 192 или 256 .

KeyMd5 -> (строка)

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

MD5-хеш ключа, который вы хотите использовать для шифрования выходного файла и который вы хотите использовать в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64, и он должен быть ровно 16 байтами до кодирования в base64.

InitializationVector -> (строка)

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

Последовательность случайных битов, созданная генератором случайных битов, уникальная для каждой операции шифрования, которую вы хотите использовать для шифрования выходных файлов. Инициализирующий вектор должен быть закодирован в base64, и он должен быть ровно 16 байтами до кодирования в base64.

LicenseAcquisitionUrl -> (строка)

Расположение ключа лицензии, необходимого для расшифровки вашего HLS плейлиста. URL-адрес должен быть абсолютным путем и упоминается в атрибуте URI тега EXT-X-KEY в файле плейлиста.

KeyStoragePolicy -> (строка)

Укажите, хотите ли вы, чтобы Elastic Transcoder записал ваш ключ лицензии HLS в ведро Amazon S3. Если вы выберите WithVariantPlaylists, LicenseAcquisitionUrl должно быть оставлено пустым, и Elastic Transcoder запишет ваш ключ в то же ведро, что и ассоциированный плейлист.

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

Настройки DRM, если таковые имеются, которые вы хотите применить к выходным файлам, связанным с этим плейлистом.

Format -> (строка)

Тип DRM, если таковой имеется, который вы хотите применить к выходным файлам, связанным с этим плейлистом.

Key -> (строка)

Ключ DRM для вашего файла, предоставленный вашим поставщиком лицензии DRM. Ключ должен быть закодирован в base64, и он должен иметь один из следующих битовых длин до кодирования в base64:

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью AWS KMS.

KeyMd5 -> (строка)

MD5-хеш ключа, используемого для DRM вашего файла, который вы хотите использовать в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64, и он должен быть ровно 16 байтами до кодирования в base64.

KeyId -> (строка)

Идентификатор вашего ключа DRM, чтобы ваш поставщик лицензий DRM знал, какой ключ предоставить.

Идентификатор ключа должен быть предоставлен в формате big endian, и Elastic Transcoder преобразует его в little endian перед вставкой в заголовки PlayReady DRM. Если вы не уверены, предоставляет ли ваш сервер лицензий идентификатор ключа в формате big или little endian, уточните у вашего поставщика DRM.

InitializationVector -> (строка)

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

LicenseAcquisitionUrl -> (строка)

Расположение ключа лицензии, необходимый для воспроизведения контента DRM. URL-адрес должен быть абсолютным путем и упоминается в заголовке PlayReady. Заголовок PlayReady упоминается в заголовке защиты клиентского манифеста для вывода Smooth Streaming и в тегах EXT-X-DXDRM и EXT-XDXDRMINFO метаданных для выходных плейлистов HLS. Пример URL-адреса: https://www.example.com/exampleKey/

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

Name=string,Format=string,OutputKeys=string,string,HlsContentProtection={Method=string,Key=string,KeyMd5=string,InitializationVector=string,LicenseAcquisitionUrl=string,KeyStoragePolicy=string},PlayReadyDrm={Format=string,Key=string,KeyMd5=string,KeyId=string,InitializationVector=string,LicenseAcquisitionUrl=string} ...

JSON синтаксис:

[
  {
    "Name": "string",
    "Format": "string",
    "OutputKeys": ["string", ...],
    "HlsContentProtection": {
      "Method": "string",
      "Key": "string",
      "KeyMd5": "string",
      "InitializationVector": "string",
      "LicenseAcquisitionUrl": "string",
      "KeyStoragePolicy": "string"
    },
    "PlayReadyDrm": {
      "Format": "string",
      "Key": "string",
      "KeyMd5": "string",
      "KeyId": "string",
      "InitializationVector": "string",
      "LicenseAcquisitionUrl": "string"
    }
  }
  ...
]

--user-metadata (карта)

Пользовательские метаданные, которые вы хотите связать с заданием Elastic Transcoder. Вы указываете метаданные в key/value парах и можете добавить до 10 key/value пар на задание. Elastic Transcoder не гарантирует, что key/value пары возвращаются в том же порядке, в котором вы их указали.

key -> (строка)

value -> (строка)

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

KeyName1=string,KeyName2=string

JSON синтаксис:

{"string": "string"
  ...}

--job-output (структура)

Раздел тела запроса, содержащий информацию о транскодированном (целевом) файле. Сильно рекомендуем использовать синтаксис Outputs вместо синтаксиса Output.

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

Имя, которое нужно присвоить транскодированному файлу. Elastic Transcoder сохраняет файл в указанном в объекте OutputBucket в конвейере с указанным идентификатором конвейера Amazon S3-бакете. Если в выходном бакете уже существует файл с указанным именем, задача завершается неудачно.

Шаблон миниатюры -> (строка)

Укажите, хотите ли вы, чтобы Elastic Transcoder создавал миниатюры для видео и, если да, как вы хотите, чтобы Elastic Transcoder назначал имена файлам.

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

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объект ThumbnailPattern. В любом месте, где вы указываете {count}, Elastic Transcoder добавляет пятизначный порядковый номер (начиная с 00001) к именам файлов миниатюр. Число указывает, где конкретная миниатюра находится в последовательности миниатюр для транскодированного файла.

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

Если вы указываете литеральные значения и/или {resolution}, но пропускаете {count}, Elastic Transcoder возвращает ошибку валидации и не создает задачу.

Литеральные значения (Необязательно) : Вы можете указать литеральные значения где угодно в объекте ThumbnailPattern. Например, вы можете включить их как префикс имени файла или как разделитель между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объект ThumbnailPattern.

При создании миниатюр Elastic Transcoder автоматически сохраняет файлы в формате (.jpg или .png), который указан в пресете, который вы указали в значении PresetID объекта CreateJobOutput. Elastic Transcoder также добавляет соответствующее расширение имени файла.

Шифрование миниатюры -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к вашей миниатюре.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами AWS-KMS ключ в конвейер.
aes-cbc-pkcs7: Режим работы с блоками шифра с заполнением, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или начальный вектор, подвергшиеся модификации, не пройдут процесс расшифровки.

Для всех трёх вариантов AES вам нужно предоставить следующие настройки, которые должны быть закодированы в формате base64:

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

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

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

128, 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был повреждён во время передачи. Key MD5 должен быть закодирован в формате base64 и должен иметь ровно 16 байт длины перед кодированием в base64.

InitializationVector -> (строка)

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

Поворот -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите повернуть Elastic Transcoder выходной файл относительно входного. Введите одно из следующих значений: auto, 0, 90, 180, 270. Значение auto обычно работает только если файл, который вы транскодируете, содержит метаданные о повороте.

Идентификатор пресета -> (строка)

Идентификатор пресета, который нужно использовать для этой задачи. Пресет определяет настройки аудио, видео и миниатюр, которые Elastic Transcoder использует для транскодирования.

Продолжительность сегмента -> (строка)

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

(Выходные данные только в формате Fragmented MP4 или MPEG-TS)

Если вы указываете пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration является максимальной целевой длительностью каждого сегмента в секундах. Для плейлистов формата HLSv3 каждый сегмент медиа хранится в отдельном файле .ts. Для плейлистов HLSv4 и Smooth все сегменты медиа для вывода хранятся в одном файле. Каждый сегмент примерно длится SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений составляет от 1 до 60 секунд. Если длительность видео не делится на SegmentDuration без остатка, длительность последнего сегмента является остатком от деления общей длины на SegmentDuration.

Водяные знаки -> (список)

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

(структура)

PresetWatermarkId -> (строка)

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

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать для водяного знака. Чтобы определить, в каком ведре Amazon S3 содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный параметром Pipeline; объект Input Bucket в этом конвейере определяет ведро.

Если имя файла включает префикс, например, logos/128x64.png , включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

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

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

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить требуемый ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Режим работы блочного шифра с заливкой, первоначально использовавшийся для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES Galois Counter Mode, режим работы, который является аутентифицированным режимом шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не проходят процесс расшифровки.

Ключ
MD5 ключа
Начальный вектор

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

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла или который был использован для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах до кодирования в base64 должна быть одной из следующих:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

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

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает наличие нескольких файлов обложек альбомов.

Replace: Указанная обложка альбома заменяет любую существующую обложку альбома.
Prepend: Указанная обложка альбома размещается перед любой существующей обложкой альбома.
Append: Указанная обложка альбома размещается после любой существующей обложки альбома.
Fallback: Если исходный входной файл содержит обложку, Elastic Transcoder использует эту обложку для вывода. Если исходный входной файл не содержит обложки, Elastic Transcoder использует указанный файл обложки альбома.

Artwork -> (список)

Файл, который будет использоваться в качестве обложки альбома. Может быть несколько обложек, связанных с аудиофайлом, максимум 20. Допустимые форматы — .jpg и .png

(структура)

Файл, который будет использоваться в качестве обложки альбома. Может быть несколько обложек, связанных с аудиофайлом, максимум 20.

Чтобы удалить обложку или оставить обложку пустой, вы можете установить Artwork в значение null или установить Merge Policy в «Заменить» и использовать пустой массив Artwork.

Чтобы сохранить существующую обложку без изменений, установите Merge Policy в «Префикс», «Добавить» или «Падение» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, который будет использоваться в качестве обложки альбома. Чтобы определить, в каком Amazon S3-ведре содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId; объект InputBucket в этом конвейере идентифицирует ведро.

Если имя файла включает префикс, например, cooking/pie.jpg, включите префикс в ключ. Если файла нет в указанном ведре, Elastic Transcoder вернёт ошибку.

MaxWidth -> (строка)

Максимальная ширина выходной обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите чётное целое число от 32 до 4096 включительно.

MaxHeight -> (строка)

Максимальная высота выходной обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите чётное целое число от 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.

AlbumArtFormat -> (строка)

Формат обложки альбома, если таковой имеется. Допустимые форматы — .jpg и .png.

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

Настройки шифрования, если таковые имеются, которые вы хотите, чтобы Elastic Transcoder применял к вашей обложке.

Mode -> (строка)

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

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально используемый для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим шифрования с аутентификацией, означающий, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс расшифровки.

Для всех трёх вариантов AES вам необходимо предоставить следующие параметры, которые должны быть закодированы в формате base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши частные ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

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

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальных для каждой операции шифрования, которые вы использовали для шифрования входных файлов или которые вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Вектор инициализации должен быть закодирован в формате base64 и должен иметь длину ровно 16 байт до кодирования в base64.

Composition -> (список)

Вы можете создать выходной файл, содержащий фрагмент входного файла. Этот фрагмент, называемый клипом, может быть из начала, середины или конца файла. Объект Composition содержит настройки для клипов, из которых состоит выходной файл. В текущей версии вы можете указать настройки только для одного клипа на выходной файл. Объект Composition не может быть null.

(структура)

Настройки одного клипа в составе. Все задания в списке воспроизведения должны иметь одинаковые настройки клипов.

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

Настройки, определяющие, когда начинается клип и как долго он длится.

StartTime -> (строка)

Место в входном файле, где вы хотите, чтобы начинался клип. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Продолжительность клипа. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, до максимума 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text . Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на вывод.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видеоданных. Внешние субтитры требуют плеера, способного понимать связь между файлом видео и файлом внешних субтитров. Elastic Transcoder поддерживает только один внешний субтитр на язык, до максимума 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt . Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt .

Если вам нужны субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения как допустимый ввод для субтитров и не доступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы передать существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию об внешних файлах см. на страницах Wikipedia «Расширяемая платформа метаданных» и «Файлы внешних субтитров».

MergePolicy -> (строка)

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

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, указанные в CaptionSources .

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для внешних субтитров, используемые во время процесса транскодирования. Чтобы исключить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

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

Key -> (строка)

Имя файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

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

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

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который хотите использовать в свою конвейерную линию.
aes-cbc-pkcs7: Метод шифрования с блоками и заполнением, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим счетчика AES.
aes-gcm: Режим счетчика AES с галоисовой функцией, режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES вы должны предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши личные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать данные.

Key -> (строка)

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

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

CaptionFormats -> (список)

(структура)

Формат файла выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

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

Указанный вами формат определяет, сгенерирует ли Elastic Transcoder встроенные или отдельные субтитры для этого вывода.

Допустимые встроенные форматы субтитров:
- для FLAC : Нет
- Для MP3 : Нет
- Для MP4 : mov-text
- Для MPEG-TS : Нет
- Для ogg : Нет
- Для webm : Нет
Допустимые форматы отдельных субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры, совместимые с ttml или smpte-tt, укажите dfxp в качестве формата вывода.
- Для FMP4 : dfxp
- Выходы, отличные от FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров в формате описание -{language} , где:

описание — описание видео.
{language} — буквальное значение, которое Elastic Transcoder заменяет двух- или трёхбуквенным кодом языка субтитров в именах выходных файлов.

Если вы не включите {language} в шаблон имени файла, Elastic Transcoder автоматически добавит «{language} » к значению, которое вы указали для описания. Кроме того, Elastic Transcoder автоматически добавляет счётчик в конце файлов сегментов.

Например, предположим, что вы кодируете в формате srt. Когда вы введёте «Sydney-{язык}-sunrise», а язык субтитров — английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров Elastic Transcoder.

Режим -> (строка)

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

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим работы с блоком шифра, дополненный, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или начальный вектор, подвергшиеся вмешательству, не проходят процесс расшифровки.

Для всех трёх вариантов AES необходимо предоставить следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

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

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

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Шифрование -> (структура)

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

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Режим работы с блоком шифра, дополненный, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим работы, являющийся аутентифицированным форматом шифрования, что означает, что файл, ключ или начальный вектор, подвергшиеся вмешательству, не проходят процесс расшифровки.

Ключ
MD5 ключа
Начальный вектор

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

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

InitializationVector -> (строка)

Синтаксис JSON:

{
  "Key": "string",
  "ThumbnailPattern": "string",
  "ThumbnailEncryption": {
    "Mode": "string",
    "Key": "string",
    "KeyMd5": "string",
    "InitializationVector": "string"
  },
  "Rotate": "string",
  "PresetId": "string",
  "SegmentDuration": "string",
  "Watermarks": [
    {
      "PresetWatermarkId": "string",
      "InputKey": "string",
      "Encryption": {
        "Mode": "string",
        "Key": "string",
        "KeyMd5": "string",
        "InitializationVector": "string"
      }
    }
    ...
  ],
  "AlbumArt": {
    "MergePolicy": "string",
    "Artwork": [
      {
        "InputKey": "string",
        "MaxWidth": "string",
        "MaxHeight": "string",
        "SizingPolicy": "string",
        "PaddingPolicy": "string",
        "AlbumArtFormat": "string",
        "Encryption": {
          "Mode": "string",
          "Key": "string",
          "KeyMd5": "string",
          "InitializationVector": "string"
        }
      }
      ...
    ]
  },
  "Composition": [
    {
      "TimeSpan": {
        "StartTime": "string",
        "Duration": "string"
      }
    }
    ...
  ],
  "Captions": {
    "MergePolicy": "string",
    "CaptionSources": [
      {
        "Key": "string",
        "Language": "string",
        "TimeOffset": "string",
        "Label": "string",
        "Encryption": {
          "Mode": "string",
          "Key": "string",
          "KeyMd5": "string",
          "InitializationVector": "string"
        }
      }
      ...
    ],
    "CaptionFormats": [
      {
        "Format": "string",
        "Pattern": "string",
        "Encryption": {
          "Mode": "string",
          "Key": "string",
          "KeyMd5": "string",
          "InitializationVector": "string"
        }
      }
      ...
    ]
  },
  "Encryption": {
    "Mode": "string",
    "Key": "string",
    "KeyMd5": "string",
    "InitializationVector": "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 (boolean)

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

--endpoint-url (string)

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

--no-verify-ssl (boolean)

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

--no-paginate (boolean)

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

--output (string)

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

json
text
table
yaml
yaml-stream

--query (string)

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

--profile (string)

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

--region (string)

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

--version (string)

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

--color (string)

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

on
off
auto

--no-sign-request (boolean)

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

--ca-bundle (string)

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

--cli-read-timeout (int)

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

--cli-connect-timeout (int)

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

--cli-binary-format (string)

Стиль форматирования, используемый для бинарных блоков. По умолчанию используется формат 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 (boolean)

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

--cli-auto-prompt (boolean)

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

--no-cli-auto-prompt (boolean)

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

Примеры

Примечание

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

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

Создание задания для ElasticTranscoder

Следующий create-job пример создает задание для ElasticTranscoder.

aws elastictranscoder create-job \
    --pipeline-id 1111111111111-abcde1 \
    --inputs file://inputs.json \
    --outputs file://outputs.json \
    --output-key-prefix "recipes/" \
    --user-metadata file://user-metadata.json

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

[{
    "Key":"ETS_example_file.mp4",
    "FrameRate":"auto",
    "Resolution":"auto",
    "AspectRatio":"auto",
    "Interlaced":"auto",
    "Container":"mp4"
}]

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

[
    {
        "Key":"webm/ETS_example_file-kindlefirehd.webm",
        "Rotate":"0",
        "PresetId":"1351620000001-100250"
    }
]

Содержимое user-metadata.json:

{
    "Food type":"Italian",
    "Cook book":"recipe notebook"
}

Вывод:

{
    "Job": {
        "Status": "Submitted",
        "Inputs": [
            {
                "Container": "mp4",
                "FrameRate": "auto",
                "Key": "ETS_example_file.mp4",
                "AspectRatio": "auto",
                "Resolution": "auto",
                "Interlaced": "auto"
            }
        ],
        "Playlists": [],
        "Outputs": [
            {
                "Status": "Submitted",
                "Rotate": "0",
                "PresetId": "1351620000001-100250",
                "Watermarks": [],
                "Key": "webm/ETS_example_file-kindlefirehd.webm",
                "Id": "1"
            }
        ],
        "PipelineId": "3333333333333-abcde3",
        "OutputKeyPrefix": "recipes/",
        "UserMetadata": {
            "Cook book": "recipe notebook",
            "Food type": "Italian"
        },
        "Output": {
            "Status": "Submitted",
            "Rotate": "0",
            "PresetId": "1351620000001-100250",
            "Watermarks": [],
            "Key": "webm/ETS_example_file-kindlefirehd.webm",
            "Id": "1"
        },
        "Timing": {
            "SubmitTimeMillis": 1533838012298
        },
        "Input": {
            "Container": "mp4",
            "FrameRate": "auto",
            "Key": "ETS_example_file.mp4",
            "AspectRatio": "auto",
            "Resolution": "auto",
            "Interlaced": "auto"
        },
        "Id": "1533838012294-example",
        "Arn": "arn:aws:elastictranscoder:us-west-2:123456789012:job/1533838012294-example"
    }
}

Вывод

Задача -> (структура)

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

Id -> (строка)

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

Arn -> (строка)

Amazon Resource Name (ARN) для задачи.

PipelineId -> (строка)

Идентификатор используемой вами Id транскодирования. Трубопровод определяет несколько параметров, включая Amazon S3-хранилище, из которого Elastic Transcoder получает файлы для транскодирования, и хранилище, в которое Elastic Transcoder помещает транскодированные файлы.

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

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

Key -> (строка)

Имя файла для транскодирования. В другом месте блока JSON указан идентификатор используемого трубопровода для обработки задачи. Объект InputBucket в этом трубопроводе указывает Elastic Transcoder, из какого Amazon S3-хранилища получить файл.

Если имя файла включает префикс, например, cooking/lasagna.mpg, включите префикс в ключ. Если файла нет в указанном хранилище, Elastic Transcoder возвращает ошибку.

FrameRate -> (строка)

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

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

Resolution -> (строка)

Это значение должно быть auto, что заставит Elastic Transcoder автоматически определять разрешение входного файла.

AspectRatio -> (строка)

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

Interlaced -> (строка)

true, false

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

Container -> (строка)

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

3gp, aac, asf, avi, divx, flv, m4a, mkv, mov, mp3, mp4, mpeg, mpeg-ps, mpeg-ts, mxf, ogg, vob, wav, webm

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

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

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами AWS-KMS-ключ в свой трубопровод.
aes-cbc-pkcs7: Режим шифрования блоками с заливкой, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим подсчета AES.
aes-gcm: Режим подсчета AES Galois, режим, представляющий собой аутентифицированный формат шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не пройдут процесс дешифрования.

Для всех трёх режимов AES вам необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши личные ключи шифрования и незашифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

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

128, 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите использовать Elastic Transcoder для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5-хеш ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байтов до кодирования в base64.

InitializationVector -> (строка)

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

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

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

StartTime -> (строка)

Место в входном файле, где вы хотите начать обрезку. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - это тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Продолжительность обрезки. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS - это тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

Встроенные: Встроенные субтитры включаются в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый ненулевой канал), CEA-708 (EIA-708 , только первый ненулевой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио- и видеоданных. Внешние субтитры требуют проигрывателя, способного понимать взаимосвязь между видеофайлом и внешним файлом. Elastic Transcoder поддерживает только один внешний субтитр на язык, максимум 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вы хотите субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого ввода для субтитров и недоступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы пропустить существующие субтитры без изменений, установите MergePolicy в значение MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia по субтитрам.

Дополнительную информацию о внешних файлах см. на страницах Wikipedia по Extensible Metadata Platform и внешним файлам.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает существование нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходе. Если субтитры для языка встроенны во входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходе. Если субтитры для языка встроенны во входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, указанные в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для внешних субтитров, используемые во время процесса транскодирования. Чтобы пропустить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для внешних субтитров, используемый во время процесса транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

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

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах ISO языков и названиях языков см. на странице Список кодов ISO 639-1.

TimeOffset -> (строка)

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Рекомендуется указать здесь название языка субтитров, на языке самих субтитров.

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

Настройки шифрования, если таковые имеются, необходимые Elastic Transcoder для расшифровки ваших исходных файлов субтитров или для применения вами к исходным файлам субтитров.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, первоначально использовавшийся для файлов HLS.
aes-ctr: AES режим счётчика.
aes-gcm: AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс расшифровки.

Для всех трёх режимов AES вам необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Key
Key MD5
Initialization Vector

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

Key -> (строка)

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

128 , 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, используемого для шифрования входного файла или для шифрования выходного файла Elastic Transcoder. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был повреждён во время передачи. Ключ MD5 должен быть закодирован в base64 и должен иметь длину ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальная для каждой операции шифрования, используемая для шифрования входных файлов или используемая Elastic Transcoder для шифрования выходных файлов. Вектор инициализации должен быть закодирован в base64 и должен иметь длину ровно 16 байт перед кодированием в base64.

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

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (целое число большого размера)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (целое число большого размера)

Обнаруженная продолжительность входного файла в миллисекундах.

Inputs -> (список)

Информация о файлах, которые вы транскодируете. Если вы указали несколько файлов для этой задачи, Elastic Transcoder объединит их в один выходной файл.

(структура)

Информация о файле, который вы транскодируете.

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

Имя файла для транскодирования. В другом месте блока JSON указан идентификатор конвейера для обработки задачи. Объект InputBucket в этом конвейере указывает Elastic Transcoder, из какой корзины Amazon S3 получить файл.

Если имя файла включает префикс, например cooking/lasagna.mpg , добавьте префикс в ключ. Если файла нет в указанной корзине, Elastic Transcoder возвращает ошибку.

Частота кадров -> (строка)

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

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

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

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

Это значение должно быть auto, что заставит Elastic Transcoder автоматически определить разрешение входного файла.

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

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

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

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

Интерлейсинг -> (строка)

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

true , false

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

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

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

3gp , aac , asf , avi , divx , flv , m4a , mkv , mov , mp3 , mp4 , mpeg , mpeg-ps , mpeg-ts , mxf , ogg , vob , wav , webm

Шифрование -> (структура)

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

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить нужный ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Режим шифрования блоков с заливкой, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter Mode.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, что означает, что файл, ключ или вектор инициализации, в котором произошли изменения, не пройдёт процесс расшифровки.

Для всех трёх вариантов AES необходимо указать следующие параметры, которые должны быть закодированы в формате base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши закрытые ключи шифрования и нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать данные.

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

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. Key MD5 должен быть закодирован в формате base64 и должен иметь длину ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

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

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

Настройки для обрезки входного файла. Каждый входной файл может иметь разные настройки обрезки.

StartTime -> (строка)

Место в входном файле, с которого вы хотите начать обрезку. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

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

Продолжительность обрезки. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

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

Вы можете настроить Elastic Transcoder для транскодирования субтитров или текстов от одного формата к другому. Все субтитры должны быть в формате UTF-8. Elastic Transcoder поддерживает два типа субтитров:

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, до максимум 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимум один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видео данных. Внешние субтитры требуют плеера, способного понимать взаимосвязь между видеофайлом и внешним файлом. Elastic Transcoder поддерживает только один внешний субтитр на язык, до максимум 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вы хотите субтитры в формате ttml или smpte-tt, укажите dfxp в качестве выходного формата.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы оставить существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

Дополнительную информацию об встроенных файлах см. на странице Wikipedia о субтитрах.

Дополнительную информацию о внешних файлах см. на страницах Wikipedia о платформе расширяемых метаданных и внешних файлах.

MergePolicy -> (строка)

Политика, определяющая, как Elastic Transcoder обрабатывает существование нескольких субтитров.

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроенны в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходные данные. Если субтитры для языка встроенны в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, которые вы указали в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для входных внешних субтитров, используемых во время процесса транскодирования. Чтобы опустить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для входных внешних субтитров, используемых во время процесса транскодирования.

Key -> (строка)

Название файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

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

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]ЧЧ:мм:СС.сс.

Label -> (строка)

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

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

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

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать в свой конвейер.
aes-cbc-pkcs7: Запаролированный режим шифрования блоков, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, что означает, что файл, ключ или начальный вектор, подвергшиеся изменениям, не могут быть расшифрованы.

Для всех трёх режимов AES вы должны предоставить следующие настройки, которые должны быть закодированы в base64:

Key
Key MD5
Initialization Vector

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

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

Key -> (строка)

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

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальных для каждой операции шифрования, которые вы использовали для шифрования входных файлов или которые вы хотите использовать Elastic Transcoder для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и должен иметь длину ровно 16 байтов до кодирования в base64.

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

Обнаруженные свойства входного файла.

Width -> (целое число)

Обнаруженная ширина входного файла в пикселях.

Height -> (целое число)

Обнаруженная высота входного файла в пикселях.

FrameRate -> (строка)

Обнаруженная частота кадров входного файла в кадрах в секунду.

FileSize -> (длинное целое число)

Обнаруженный размер входного файла в байтах.

DurationMillis -> (длинное целое число)

Обнаруженная продолжительность входного файла в миллисекундах.

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

Если вы указали один вывод для задания, информация об этом выводе. Если вы указали несколько выводов для задания, объект Output содержит информацию о первом выводе. Это дублирует информацию, которая указана для первого вывода в объекте Outputs.

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

Рекомендуется использовать Outputs.

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

Id -> (строка)

Последовательный счётчик, начинающийся с 1, который идентифицирует вывод среди выводов текущего задания. В синтаксисе Output это значение всегда равно 1.

Key -> (строка)

Имя, которое нужно присвоить транскодированному файлу. Elastic Transcoder сохраняет файл в заданном ведре Amazon S3, указанном объектом OutputBucket в конвейере, который задан идентификатором конвейера.

ThumbnailPattern -> (строка)

Хотите ли вы, чтобы Elastic Transcoder создавал миниатюры для ваших видео и, если да, то как вы хотите, чтобы Elastic Transcoder называл эти файлы.

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

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

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объекте ThumbnailPattern. В каждом месте, где вы указываете {count}, Elastic Transcoder добавляет пятизначный порядковый номер (начиная с 00001 ) к именам файлов миниатюр. Число указывает, где конкретная миниатюра находится в последовательности миниатюр для транскодированного файла.

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

Если вы указываете буквальное значение и/или {resolution}, но опускаете {count}, Elastic Transcoder возвращает ошибку проверки и не создаёт задание.

Буквальные значения (Необязательно) : Вы можете указать буквальные значения в любом месте объекта ThumbnailPattern. Например, вы можете включить их в качестве префикса имени файла или в качестве разделителя между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объекте ThumbnailPattern.

При создании миниатюр Elastic Transcoder автоматически сохраняет файлы в формате (.jpg или .png), который отображается в пресете, который вы указали в значении PresetID объекта CreateJobOutput. Elastic Transcoder также добавляет соответствующее расширение имени файла.

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к миниатюрам с помощью Elastic Transcoder.

Mode -> (строка)

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

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Режим шифрования блоков с заливкой, первоначально использовавшийся для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES-режим Galois-счётчика, режим, представляющий собой формат аутентифицированного шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не проходят процесс дешифрования.

Для всех трёх режимов AES необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

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

Key -> (строка)

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Rotate -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите повернуть вывод относительно входа. Введите одно из следующих значений:

auto , 0 , 90 , 180 , 270

Значение auto обычно работает только в том случае, если файл, который вы транскодируете, содержит метаданные о повороте.

PresetId -> (строка)

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

SegmentDuration -> (строка)

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

(Только для выводов в формате Fragmented MP4 или MPEG-TS)

Если вы указываете пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration является максимальной длительностью каждого сегмента в секундах. Для плейлистов в формате HLSv3 каждый сегмент медиа хранится в отдельном файле .ts. Для плейлистов HLSv4 , MPEG-DASH и Smooth все сегменты медиа для вывода хранятся в одном файле. Каждый сегмент приблизительно равен длительности SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений составляет от 1 до 60 секунд. Если продолжительность видео не делится нацело на SegmentDuration, продолжительность последнего сегмента составляет остаток от деления общей длительности на SegmentDuration.

Elastic Transcoder создаёт плейлист, специфичный для вывода, для каждого вывода HLS, который вы указываете в OutputKeys. Чтобы добавить вывод в главный плейлист для этого задания, включите его в OutputKeys связанного плейлиста.

Status -> (строка)

Статус одного вывода в задании. Если вы указали только один вывод для задания, Outputs:Status всегда совпадает с Job:Status. Если вы указали более одного вывода:

Job:Status и Outputs:Status для всех выводов — Submitted, пока Elastic Transcoder не начнёт обработку первого вывода.
Когда Elastic Transcoder начнёт обработку первого вывода, Outputs:Status для этого вывода и Job:Status оба изменятся на Progressing. Для каждого вывода значение Outputs:Status остаётся Submitted, пока Elastic Transcoder не начнёт обработку вывода.
Статус задания остаётся Progressing, пока все выводы не достигнут конечного состояния, либо Complete, либо Error.
Когда все выводы достигнут конечного состояния, Job:Status изменяется на Complete только если Outputs:Status для всех выводов — Complete. Если Outputs:Status для одного или нескольких выводов — Error, конечный статус для Job:Status также будет Error.

Значение Status — одно из следующих: Submitted , Progressing , Complete , Canceled или Error.

StatusDetail -> (строка)

Дополнительная информация, которая поясняет Status.

Duration -> (целое число)

Продолжительность выходного файла в секундах.

Width -> (целое число)

Указывает ширину выходного файла в пикселях.

Height -> (целое число)

Высота выходного файла в пикселях.

FrameRate -> (строка)

Частота кадров выходного файла в кадрах в секунду.

FileSize -> (целое число)

Размер выходного файла в байтах.

DurationMillis -> (целое число)

Продолжительность выходного файла в миллисекундах.

Watermarks -> (список)

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

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

(структура)

PresetWatermarkId -> (строка)

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

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать для водяного знака. Чтобы определить, в каком ведре Amazon S3 находится указанный файл, Elastic Transcoder проверяет конвейер, указанный в Pipeline; объект Input Bucket в этом конвейере идентифицирует ведро.

Если имя файла включает префикс, например, logos/128x64.png , включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к вашим водяным знакам.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами AWS-KMS ключ в свой конвейер.
aes-cbc-pkcs7: Заполненная схема шифрования блоков, первоначально использовавшаяся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим шифрования, который является аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не проходят процесс дешифрования.

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать ваши данные.

Key -> (строка)

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

Изображение обложки альбома, которое должно быть связано с выходным файлом, если таковое имеется.

MergePolicy -> (строка)

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

Replace: Указанное изображение обложки заменяет любое существующее изображение обложки.
Prepend: Указанное изображение обложки помещается перед любым существующим изображением обложки.
Append: Указанное изображение обложки помещается после любого существующего изображения обложки.
Fallback: Если исходный входной файл содержит изображение обложки, Elastic Transcoder использует это изображение для вывода. Если исходный входной файл не содержит изображение обложки, Elastic Transcoder использует указанный файл изображения обложки.

Artwork -> (список)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, максимум 20. Допустимые форматы — .jpg и .png

(структура)

Файл, используемый в качестве изображения обложки альбома. Может быть несколько изображений обложки, связанных с аудиофайлом, максимум 20.

Чтобы удалить изображение обложки или оставить изображение обложки пустым, можно либо установить Artwork в null, либо установить Merge Policy в «Replace» и использовать пустой массив Artwork.

Чтобы сохранить существующее изображение обложки без изменений, установите Merge Policy в «Prepend», «Append» или «Fallback» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, используемого в качестве изображения обложки альбома. Для определения того, в каком ведре Amazon S3 находится указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId; объект InputBucket в этом конвейере идентифицирует ведро.

Если имя файла включает префикс, например, cooking/pie.jpg, включите префикс в ключ. Если файла нет в указанном ведре, Elastic Transcoder возвращает ошибку.

MaxWidth -> (строка)

Максимальная ширина выходного изображения обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите чётное целое число от 32 до 4096 включительно.

MaxHeight -> (строка)

Максимальная высота выходного изображения обложки альбома в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите чётное целое число от 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.

AlbumArtFormat -> (строка)

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

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к изображению обложки с помощью Elastic Transcoder.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим работы с блоками шифрования, изначально использовавшийся для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES-режим счётчика Galois, режим работы, являющийся аутентифицированной формой шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши закрытые ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять вашими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать свои данные.

Key -> (строка)

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

128 , 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Composition -> (список)

Вы можете создать выходной файл, содержащий фрагмент входного файла. Этот фрагмент, называемый фрагментом, может быть из начала, середины или конца файла. Объект Composition содержит настройки для фрагментов, составляющих выходной файл. В текущей версии вы можете указать настройки только для одного фрагмента на выходной файл. Объект Composition не может быть null.

(структура)

Настройки одного фрагмента в композиции. Все задания в плейлисте должны иметь одинаковые настройки фрагментов.

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

Настройки, определяющие, когда фрагмент начинается и сколько он длится.

StartTime -> (строка)

Место в входном файле, с которого вы хотите начать фрагмент. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнёт с начала входного файла.

Duration -> (строка)

Продолжительность фрагмента. Формат может быть либо HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды), либо sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создаст выходной файл от StartTime до конца файла.

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

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

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, до максимального количества 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text. Допустимые выходные значения включают: mov-text. Elastic Transcoder поддерживает максимальное количество один встроенный формат на выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видеоданных. Внешние субтитры требуют игрока, который способен понимать взаимосвязь между файлом видео и файлом внешних субтитров. Elastic Transcoder поддерживает только один внешний субтитр на язык, до максимального количества 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt. Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt.

Если вы хотите ttml или smpte-tt совместимые субтитры, укажите dfxp в качестве выходного формата.

Чтобы удалить субтитры или оставить их пустыми, установите Captions в значение null. Чтобы сохранить существующие субтитры без изменений, установите MergePolicy в значение MergeRetain и передайте массив CaptionSources со значением null.

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

Дополнительную информацию о внешних файлах см. на страницах Википедии о расширяемой платформе метаданных и файлах внешних субтитров.

MergePolicy -> (строка)

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

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходы. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходы. Если субтитры для языка встроены в входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder опускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, которые вы указали в CaptionSources.

MergePolicy не может быть null.

CaptionSources -> (список)

(структура)

Исходный файл для внешних субтитров, используемый во время процесса транскодирования.

Key -> (строка)

Название файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

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

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах ISO языков и названиях языков см. в списке кодов ISO 639-1.

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в плеере при выборе языка. Рекомендуется указывать здесь имя языка субтитров, на языке этих субтитров.

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

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

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить нужный ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter, режим аутентифицированного шифрования, означающий, что файл, ключ или начальный вектор, подвергнутые изменениям, не пройдут процесс расшифровки.

Для всех трех вариантов AES вам необходимо предоставить следующие настройки, которые должны быть закодированы в base64:

Key
Key MD5
Initialization Vector

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

Key -> (строка)

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

128 , 192 или 256.

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден при передаче. Ключ MD5 должен быть закодирован в base64 и иметь длину ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

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

CaptionFormats -> (список)

END_OF_DOCUMENT_MARKER

(структура)

Формат файла выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

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

Поддерживаемые встроенные форматы субтитров:
- для FLAC : Нет
- для MP3 : Нет
- для MP4 : mov-text
- для MPEG-TS : Нет
- для ogg : Нет
- для webm : Нет
Поддерживаемые отдельные форматы субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры в формате ttml или smpte-tt, укажите dfxp в качестве формата вывода.
- для FMP4 : dfxp
- Выходы, отличные от FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров в формате описание -{language}, где:

описание — описание видео.
{language} — буквальное значение, которое Elastic Transcoder заменяет на двух- или трёхбуквенный код языка субтитров в именах выходных файлов.

Если вы не включите {language} в шаблон имени файла, Elastic Transcoder автоматически добавляет «{language}» к значению, которое вы указали для описания. Кроме того, Elastic Transcoder автоматически добавляет счётчик в конце файлов сегментов.

Например, предположим, что вы транс кодируете в формате srt. Когда вы введёте «Sydney-{язык}-sunrise», а язык субтитров — английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим работы блочного шифра, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим счётчика AES.
aes-gcm: Режим счётчика AES Galois, режим работы, который является аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

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

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла Elastic Transcoder или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах до кодирования в base64 должна быть одной из следующих:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Шифрование -> (структура)

Настройки шифрования, если таковые имеются, которые вы хотите применить к выходным файлам. Если вы выберите шифрование, вы должны указать используемый режим. Если вы выберите отказ от шифрования, Elastic Transcoder запишет незашифрованный файл в ваш Amazon S3-bucket.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, которая создаёт и управляет ключами, используемыми для шифрования файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим работы блочного шифра, первоначально использовавшийся для файлов HLS.
aes-ctr: Режим счётчика AES.
aes-gcm: Режим счётчика AES Galois, режим работы, который является аутентифицированным форматом шифрования, что означает, что файл, ключ или вектор инициализации, подвергшиеся изменениям, не пройдут процесс дешифрования.

Для всех трёх вариантов AES необходимо указать следующие настройки, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

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

Ключ шифрования данных, который вы хотите использовать для шифрования выходного файла Elastic Transcoder или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах до кодирования в base64 должна быть одной из следующих:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

AppliedColorSpaceConversion -> (строка)

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

Outputs -> (список)

Информация о выходных файлах. Рекомендуется использовать синтаксис Outputs для всех заданий, даже когда вы хотите, чтобы Elastic Transcoder транскодировал файл только в один формат. Не используйте оба синтаксиса Outputs и Output в одном запросе. Вы можете создать максимум 30 выходов на задание.

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

(структура)

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

Рекомендуются выходы.

Если вы указали один выход для задания, информация об этом выходе. Если вы указали несколько выходов для задания, объект Output содержит информацию о первом выходе. Это дублирует информацию, которая указана для первого выхода в объекте Outputs.

Id -> (строка)

Последовательный счётчик, начинающийся с 1, который идентифицирует выход среди выходов текущего задания. В синтаксисе вывода это значение всегда 1.

Key -> (строка)

Имя, которое нужно присвоить транскодированному файлу. Elastic Transcoder сохраняет файл в ведре Amazon S3, указанном объектом OutputBucket в конвейере, который задан идентификатором конвейера.

ThumbnailPattern -> (строка)

Хотите ли вы, чтобы Elastic Transcoder создавал миниатюры для ваших видео и, если да, как вы хотите, чтобы Elastic Transcoder называл файлы.

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

``{count}`` (Обязательно) : Если вы хотите создать миниатюры, вы должны включить {count} в объект ThumbnailPattern. В любом месте, где вы укажете {count}, Elastic Transcoder добавит пятизначный порядковый номер (начинающийся с 00001 ) к именам файлов миниатюр. Число указывает, где конкретная миниатюра находится в последовательности миниатюр для транскодированного файла.

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

Если вы укажете буквенное значение и/или {resolution}, но пропустите {count}, Elastic Transcoder вернёт ошибку валидации и не создаст задание.

Буквенные значения (Необязательно) : Вы можете указать буквенные значения в любом месте объекта ThumbnailPattern. Например, вы можете включить их как префикс имени файла или как разделитель между {resolution} и {count}.
``{resolution}`` (Необязательно) : Если вы хотите, чтобы Elastic Transcoder включал разрешение в имя файла, включите {resolution} в объект ThumbnailPattern.

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к миниатюре.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально использовавшийся для файлов HLS.
aes-ctr: Режим AES Counter.
aes-gcm: Режим AES Galois Counter Mode, режим, представляющий собой аутентифицированный формат шифрования, что означает, что файл, ключ или начальный вектор, в котором были внесены изменения, не пройдут процесс расшифровки.

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши личные ключи шифрования и ваши нешифрованные данные никогда не хранятся в AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла или который был использован для шифрования входного файла. Ключ должен быть закодирован в base64, и он должен быть одной из следующих длин в битах до кодирования в base64:

128, 192 или 256.

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Rotate -> (строка)

Количество градусов по часовой стрелке, на которое вы хотите, чтобы Elastic Transcoder повернул выходной файл относительно входного. Введите одно из следующих значений:

auto, 0, 90, 180, 270

Значение auto, как правило, работает только если файл, который вы транскодируете, содержит метаданные о повороте.

PresetId -> (строка)

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

SegmentDuration -> (строка)

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

(Выходы только в формате Fragmented MP4 или MPEG-TS)

Если вы указали пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), SegmentDuration является максимальной целевой продолжительностью каждого сегмента в секундах. Для плейлистов формата HLSv3 каждый сегмент медиа хранится в отдельном файле .ts. Для плейлистов HLSv4, MPEG-DASH и Smooth все сегменты медиа для выхода хранятся в одном файле. Каждый сегмент имеет примерно длину SegmentDuration, хотя отдельные сегменты могут быть короче или длиннее.

Диапазон допустимых значений от 1 до 60 секунд. Если продолжительность видео не делится на SegmentDuration без остатка, продолжительность последнего сегмента равна остатку от деления общей длины на SegmentDuration.

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

Status -> (строка)

Статус одного выхода в задании. Если вы указали только один выход для задания, Outputs:Status всегда совпадает с Job:Status. Если вы указали несколько выходов:

Job:Status и Outputs:Status для всех выходов — Submitted до тех пор, пока Elastic Transcoder не начнёт обработку первого выхода.
Когда Elastic Transcoder начнёт обработку первого выхода, Outputs:Status для этого выхода и Job:Status изменяются на Progressing. Для каждого выхода значение Outputs:Status остаётся Submitted до тех пор, пока Elastic Transcoder не начнёт обработку выхода.
Статус задания остаётся Progressing до тех пор, пока все выходы не достигнут конечного состояния, Complete или Error.
Когда все выходы достигнут конечного состояния, Job:Status изменяется на Complete только если Outputs:Status для всех выходов равно Complete. Если Outputs:Status для одного или нескольких выходов равно Error, конечный статус для Job:Status также будет Error.

Значение Status — одно из следующих: Submitted, Progressing, Complete, Canceled или Error.

StatusDetail -> (строка)

Дополнительная информация, объясняющая Status.

Duration -> (целое число)

Продолжительность выходного файла в секундах.

Width -> (целое число)

Указывает ширину выходного файла в пикселях.

Height -> (целое число)

Высота выходного файла в пикселях.

FrameRate -> (строка)

Частота кадров выходного файла в кадрах в секунду.

FileSize -> (целое число)

Размер выходного файла в байтах.

DurationMillis -> (целое число)

Продолжительность выходного файла в миллисекундах.

Watermarks -> (список)

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

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

(структура)

PresetWatermarkId -> (строка)

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

InputKey -> (строка)

Имя файла .png или .jpg, который вы хотите использовать в качестве водяного знака. Чтобы определить, в каком ведре Amazon S3 находится указанный файл, Elastic Transcoder проверяет конвейер, указанный параметром Pipeline; объект Input Bucket в этом конвейере определяет ведро.

Если имя файла содержит префикс, например, logos/128x64.png , включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к водяным знакам с помощью Elastic Transcoder.

Mode -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы указываете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить ключ AWS-KMS, который вы хотите использовать, в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально используемый для файлов HLS.
aes-ctr: AES-режим счётчика.
aes-gcm: AES-режим Galois/Counter Mode, режим, представляющий собой аутентифицированный формат шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не проходят процесс расшифровки.

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши частные ключи шифрования и ваши нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

Ключ шифрования данных, который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла или который использовался для шифрования входного файла. Ключ должен быть закодирован в base64, и его длина в битах до кодирования в base64 должна быть одной из следующих:

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

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

Изображение обложки альбома, которое должно быть связано с выходным файлом, если таковое имеется.

MergePolicy -> (строка)

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

Replace: Указанное изображение обложки заменяет любое существующее изображение обложки.
Prepend: Указанное изображение обложки добавляется перед любым существующим изображением обложки.
Append: Указанное изображение обложки добавляется после любого существующего изображения обложки.
Fallback: Если исходный входной файл содержит изображение, Elastic Transcoder использует это изображение для выходного файла. Если исходный входной файл не содержит изображения, Elastic Transcoder использует указанный файл изображения обложки.

Artwork -> (список)

Файл, который будет использоваться в качестве изображения обложки альбома. С аудиофайлом может быть связано несколько изображений обложки, максимум 20. Допустимые форматы — .jpg и .png

(структура)

Файл, который будет использоваться в качестве изображения обложки альбома. С аудиофайлом может быть связано несколько изображений обложки, максимум 20.

Чтобы удалить изображение обложки или оставить его пустым, можно установить Artwork в значение null или установить Merge Policy в «Заменить» и использовать пустой массив Artwork.

Чтобы сохранить существующее изображение обложки без изменений, установите Merge Policy в «Префикс», «Суффикс» или «Падение» и используйте пустой массив Artwork.

InputKey -> (строка)

Имя файла, который будет использоваться в качестве изображения обложки альбома. Для определения, в каком ведре Amazon S3 содержится указанный файл, Elastic Transcoder проверяет конвейер, указанный в PipelineId; объект InputBucket в этом конвейере определяет ведро.

Если имя файла содержит префикс, например, cooking/pie.jpg, включите префикс в ключ. Если файл не находится в указанном ведре, Elastic Transcoder возвращает ошибку.

MaxWidth -> (строка)

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

MaxHeight -> (строка)

Максимальная высота выходного изображения обложки в пикселях. Если вы укажете auto, Elastic Transcoder использует значение по умолчанию 600. Если вы укажете числовое значение, введите четное целое число от 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.

AlbumArtFormat -> (строка)

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

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

Настройки шифрования, если таковые имеются, которые вы хотите применить к изображению обложки Elastic Transcoder.

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Режим блочного шифра с заливкой, изначально использовавшийся для файлов HLS.
aes-ctr: Режим счисления AES.
aes-gcm: Режим счисления AES Galois Counter Mode, режим аутентифицированного шифрования, что означает, что файл, ключ или начальный вектор, которые были изменены, не проходят процесс расшифровки.

Для всех трех вариантов AES необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Начальный вектор

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

Для режимов AES ваши приватные ключи шифрования и нешифрованные данные никогда не хранятся AWS; поэтому важно безопасно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете расшифровать свои данные.

Key -> (строка)

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

128 , 192 , или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден во время передачи. MD5 ключа должен быть закодирован в base64 и должен иметь длину ровно 16 байт перед кодированием в base64.

InitializationVector -> (строка)

Последовательность случайных битов, созданных генератором случайных чисел, уникальных для каждой операции шифрования, которые вы использовали для шифрования входных файлов или которые вы хотите, чтобы Elastic Transcoder использовал для шифрования выходных файлов. Начальный вектор должен быть закодирован в base64 и должен иметь длину ровно 16 байт перед кодированием в base64.

Composition -> (список)

Вы можете создать выходной файл, который содержит фрагмент входного файла. Этот фрагмент, называемый клипом, может быть взят с начала, середины или конца файла. Объект Composition содержит настройки для клипов, составляющих выходной файл. В текущей версии вы можете указать настройки только для одного клипа на выходной файл. Объект Composition не может быть null.

(структура)

Настройки одного клипа в композиции. Все задачи в списке воспроизведения должны иметь одинаковые настройки клипа.

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

Настройки, определяющие, когда начинается клип и как долго он длится.

StartTime -> (строка)

Место в входном файле, где вы хотите начать клип. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder начнет с начала входного файла.

Duration -> (строка)

Продолжительность клипа. Формат может быть HH:mm:ss.SSS (максимальное значение: 23:59:59.999; SSS — тысячные доли секунды) или sssss.SSS (максимальное значение: 86399.999). Если вы не укажете значение, Elastic Transcoder создает выходной файл от StartTime до конца файла.

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

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

Встроенные: Встроенные субтитры включены в тот же файл, что и аудио и видео. Elastic Transcoder поддерживает только один встроенный субтитр на язык, до максимального значения 300 встроенных субтитров на файл. Допустимые входные значения включают: CEA-608 (EIA-608 , только первый непустой канал), CEA-708 (EIA-708 , только первый непустой канал), и mov-text . Допустимые выходные значения включают: mov-text . Elastic Transcoder поддерживает максимальное количество одного встроенного формата на каждый выход.
Внешние: Внешние субтитры хранятся в отдельном файле метаданных от аудио и видео данных. Внешние субтитры требуют проигрывателя, способного понимать связь между файлом видео и внешним файлом. Elastic Transcoder поддерживает только один внешний субтитр на язык, до максимального значения 20 внешних субтитров на файл. Допустимые входные значения включают: dfxp (только первый элемент div), ebu-tt , scc , smpt , srt , ttml (только первый элемент div), и webvtt . Допустимые выходные значения включают: dfxp (только первый элемент div), scc , srt , и webvtt .

Если вам требуются субтитры в формате ttml или smpte-tt, укажите dfxp как выходной формат.

Elastic Transcoder не поддерживает OCR (оптическое распознавание символов), не принимает изображения в качестве допустимого входного значения для субтитров и не доступен для транскодирования только аудио. Elastic Transcoder не сохраняет форматирование текста (например, курсив) во время процесса транскодирования.

Чтобы удалить субтитры или оставить субтитры пустыми, установите Captions в значение null. Чтобы передать существующие субтитры без изменений, установите MergePolicy в MergeRetain и передайте массив CaptionSources со значением null.

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

Дополнительную информацию о файлах внешних субтитров см. на страницах Википедии по Extensible Metadata Platform и файлам внешних субтитров.

MergePolicy -> (строка)

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

MergeOverride: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходе. Если субтитры для языка встроены во входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует внешние субтитры и игнорирует встроенные субтитры для этого языка.
MergeRetain: Elastic Transcoder транскодирует как встроенные, так и внешние субтитры в выходе. Если субтитры для языка встроены во входной файл и также присутствуют во внешнем файле, Elastic Transcoder использует встроенные субтитры и игнорирует внешние субтитры для этого языка. Если CaptionSources пусто, Elastic Transcoder пропускает все внешние субтитры из выходных файлов.
Override: Elastic Transcoder транскодирует только внешние субтитры, которые вы указали в CaptionSources .

MergePolicy не может быть null.

CaptionSources -> (список)

Исходные файлы для внешних субтитров, используемых во время процесса транскодирования. Чтобы пропустить все внешние субтитры, оставьте CaptionSources пустым.

(структура)

Исходный файл для внешних субтитров, используемых во время процесса транскодирования.

Key -> (строка)

Имя файла внешних субтитров, который вы хотите, чтобы Elastic Transcoder включил в выходной файл.

Language -> (строка)

2-символьный код ISO 639-1
3-символьный код ISO 639-2

Дополнительную информацию о кодах языков ISO и названиях языков см. на странице списка кодов ISO 639-1.

TimeOffset -> (строка)

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

Укажите TimeOffset в формате [+-]SS.sss или [+-]HH:mm:SS.ss.

Label -> (строка)

Метка субтитров, отображаемая в проигрывателе при выборе языка. Рекомендуется указать здесь название языка субтитров на языке этих субтитров.

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

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

Mode -> (строка)

s3: Amazon S3 создает и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 вызывает Amazon Key Management Service, который создает и управляет ключами, используемыми для шифрования ваших файлов. Если вы указали s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свой конвейер.
aes-cbc-pkcs7: Заполненный режим шифрования блоков, изначально использовавшийся для файлов HLS.
aes-ctr: Режим подсчета AES.
aes-gcm: Режим подсчета AES Galois, режим шифрования с аутентификацией, означающий, что файл, ключ или начальный вектор, подвергшиеся искажениям, не проходят процесс расшифровки.

Для всех трех вариантов AES вам необходимо указать следующие параметры, которые должны быть закодированы в base64:

Key
Key MD5
Initialization Vector

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

Key -> (строка)

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

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью Amazon Key Management Service.

KeyMd5 -> (строка)

MD5-хеш ключа, который вы использовали для шифрования входного файла или который вы хотите, чтобы Elastic Transcoder использовал для шифрования выходного файла. Elastic Transcoder использует хеш ключа как контрольную сумму, чтобы убедиться, что ваш ключ не был поврежден при передаче. MD5 ключа должен быть закодирован в base64 и должен иметь ровно 16 байт до кодирования в base64.

InitializationVector -> (строка)

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

CaptionFormats -> (список)

(структура)

Формат выходных субтитров. Если вы оставите это значение пустым, Elastic Transcoder вернёт ошибку.

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

Поддерживаемые форматы встроенных субтитров:
- для FLAC : Нет
- для MP3 : Нет
- для MP4 : mov-text
- для MPEG-TS : Нет
- для ogg : Нет
- для webm : Нет
Поддерживаемые форматы отдельных субтитров: Elastic Transcoder поддерживает dfxp (только первый элемент div), scc, srt и webvtt. Если вы хотите субтитры, совместимые с ttml или smpte-tt, укажите dfxp в качестве выходного формата.
- для FMP4 : dfxp
- Выходы, не являющиеся FMP4 : Все типы отдельных субтитров

fmp4 субтитры имеют расширение .ismt

Шаблон -> (строка)

Префикс для имён файлов субтитров, в формате описание -{language}, где:

описание — описание видео.
{language} — буквальное значение, которое Elastic Transcoder заменяет на двух- или трёхбуквенный код языка субтитров в именах выходных файлов.

Например, предположим, что вы выполняет транскодирование в формате srt. Если вы введёте «Sydney-{язык}-sunrise», а язык субтитров — английский (en), имя первого файла субтитров будет Sydney-en-sunrise00000.srt.

Шифрование -> (структура)

Параметры шифрования, если таковые имеются, которые вы хотите применить к форматам субтитров.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим блочного шифрования, изначально использовавшийся для файлов HLS.
aes-ctr: Режим счётчика AES.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшийся подделке, не пройдёт процесс дешифрования.

Для всех трёх вариантов AES вам необходимо указать следующие параметры, которые должны быть закодированы в base64:

Ключ
MD5 ключа
Вектор инициализации

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

Для режимов AES ваши личные ключи шифрования и нешифрованные данные никогда не хранятся AWS; поэтому важно надёжно управлять своими ключами шифрования. Если вы их потеряете, вы не сможете дешифровать свои данные.

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

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

128 , 192 или 256 .

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

Шифрование -> (структура)

Параметры шифрования, если таковые имеются, которые вы хотите применить к выходным файлам. Если вы решили использовать шифрование, вам необходимо указать режим. Если вы решили не использовать шифрование, Elastic Transcoder запишет нешифрованный файл в ваш Amazon S3-bucket.

Режим -> (строка)

s3: Amazon S3 создаёт и управляет ключами, используемыми для шифрования ваших файлов.
s3-aws-kms: Amazon S3 обращается к Amazon Key Management Service, который создаёт и управляет ключами, используемыми для шифрования ваших файлов. Если вы укажете s3-aws-kms и не хотите использовать ключ по умолчанию, вы должны добавить используемый вами ключ AWS-KMS в свою конвейерную линию.
aes-cbc-pkcs7: Заполненный режим блочного шифрования, изначально использовавшийся для файлов HLS.
aes-ctr: Режим счётчика AES.
aes-gcm: Режим AES Galois Counter Mode, режим аутентифицированного шифрования, означающий, что файл, ключ или вектор инициализации, подвергшийся подделке, не пройдёт процесс дешифрования.

Ключ
MD5 ключа
Вектор инициализации

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

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

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

128 , 192 или 256 .

Ключ также должен быть зашифрован с использованием Amazon Key Management Service.

KeyMd5 -> (строка)

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

InitializationVector -> (строка)

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

AppliedColorSpaceConversion -> (строка)

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

OutputKeyPrefix -> (строка)

Значение, если таковое имеется, которое вы хотите, чтобы Elastic Transcoder добавлял в качестве префикса к именам всех файлов, создаваемых этим заданием, включая выходные файлы, миниатюры и плейлисты. Рекомендуется добавить / или какой-либо другой разделитель в конец OutputKeyPrefix.

Плейлисты -> (список)

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

Выходные данные только в формате Fragmented MP4 или MPEG-TS.

Если вы укажете пресет в PresetId, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), Playlists содержит информацию о мастер-плейлистах, которые вы хотите создать с помощью Elastic Transcoder.

Максимальное количество мастер-плейлистов в задании — 30.

(структура)

Используйте только для выходных данных в формате Fragmented MP4 или MPEG-TS. Если вы укажете пресет, для которого значение Container равно fmp4 (Fragmented MP4) или ts (MPEG-TS), Playlists содержит информацию о мастер-плейлистах, которые вы хотите создать с помощью Elastic Transcoder. Рекомендуется создавать только один мастер-плейлист на один формат вывода. Максимальное количество мастер-плейлистов в задании — 30.

Name -> (строка)

Имя, которое вы хотите присвоить мастер-плейлисту, например, nyc-vacation.m3u8. Если имя содержит символ /, то часть имени до последнего символа / должна быть одинаковой для всех Name объектов. Если вы создаете более одного мастер-плейлиста, значения всех Name объектов должны быть уникальными.

Примечание

Format -> (строка)

Формат выходного плейлиста. Допустимые форматы включают HLSv3 , HLSv4 и Smooth .

OutputKeys -> (список)

Для каждого вывода в данном задании, который вы хотите включить в мастер-плейлист, значение объекта Outputs:Key.

Если ваш вывод не HLS или не имеет заданной длительности сегмента, имя файла вывода представляет собой конкатенацию OutputKeyPrefix и Outputs:Key : OutputKeyPrefix``Outputs:Key``
Если ваш вывод — HLSv3 и имеет заданную длительность сегмента, или не включен в плейлист, Elastic Transcoder создает файл выходного плейлиста с расширением .m3u8 и серию файлов .ts, которые включают пятизначный последовательный счётчик, начинающийся с 00000: OutputKeyPrefix``Outputs:Key`` .m3u8 OutputKeyPrefix``Outputs:Key`` 00000.ts
Если ваш вывод — HLSv4 , имеет заданную длительность сегмента и включён в плейлист HLSv4, Elastic Transcoder создаёт файл выходного плейлиста с расширением _v4.m3u8. Если вывод — видео, Elastic Transcoder также создает файл с расширением _iframe.m3u8 : OutputKeyPrefix``Outputs:Key`` _v4.m3u8 OutputKeyPrefix``Outputs:Key`` _iframe.m3u8 OutputKeyPrefix``Outputs:Key`` .ts

Если вы включаете более одного вывода в плейлист, любые настройки длительности сегмента, клипа или субтитров должны быть одинаковыми для всех выводов в плейлисте. Для плейлистов Smooth соотношение Audio:Profile, Video:Profile и Video:FrameRate до Video:KeyframesMaxDist должно быть одинаковым для всех выводов.

(строка)

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

Method -> (строка)

Метод защиты контента для вашего вывода. Единственное допустимое значение: aes-128 .

Это значение записывается в атрибут method тега метаданных EXT-X-KEY в выходном плейлисте.

Key -> (строка)

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

128 , 192 или 256 .

KeyMd5 -> (строка)

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

MD5-хеш ключа, который вы хотите использовать для шифрования выходного файла и который вы хотите использовать в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. MD5-хеш ключа должен быть закодирован в base64 и должен иметь ровно 16 байтов до кодирования в base64.

InitializationVector -> (строка)

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

Последовательность случайных битов, сгенерированная генератором случайных чисел, уникальная для каждой операции шифрования, которую вы хотите использовать для шифрования выходных файлов. Инициализирующий вектор должен быть закодирован в base64 и должен иметь ровно 16 байтов до кодирования в base64.

LicenseAcquisitionUrl -> (строка)

Местоположение ключа лицензии, необходимого для расшифровки вашего HLS плейлиста. URL должен быть абсолютным путём и используется в атрибуте URI тега EXT-X-KEY в файле плейлиста.

KeyStoragePolicy -> (строка)

Укажите, хотите ли вы, чтобы Elastic Transcoder записал ваш ключ HLS лицензии в ведро Amazon S3. Если вы выберите WithVariantPlaylists, LicenseAcquisitionUrl должно быть пустым, и Elastic Transcoder запишет ваш ключ данных в то же ведро, что и связанный плейлист.

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

Format -> (строка)

Тип DRM, если таковой имеется, который вы хотите применить к выходным файлам, связанным с этим плейлистом.

Key -> (строка)

Ключ DRM для вашего файла, предоставленный поставщиком лицензии DRM. Ключ должен быть закодирован в base64 и должен иметь один из следующих битовых размеров до кодирования в base64:

128 , 192 или 256 .

Ключ также должен быть зашифрован с помощью AWS KMS.

KeyMd5 -> (строка)

MD5-хеш ключа, используемого для DRM вашего файла, который вы хотите использовать в качестве контрольной суммы, чтобы убедиться, что ваш ключ не был повреждён во время передачи. MD5-хеш ключа должен быть закодирован в base64 и должен иметь ровно 16 байтов до кодирования в base64.

KeyId -> (строка)

Идентификатор вашего ключа DRM, чтобы ваш поставщик лицензий DRM знал, какой ключ предоставить.

Идентификатор ключа должен быть предоставлен в формате big endian, и Elastic Transcoder преобразует его в little endian перед вставкой в заголовки DRM PlayReady. Если вы не уверены, предоставляет ли ваш сервер лицензий идентификатор ключа в формате big или little endian, обратитесь к поставщику DRM.

InitializationVector -> (строка)

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

LicenseAcquisitionUrl -> (строка)

Расположение ключа лицензии, необходимого для воспроизведения контента DRM. URL должен быть абсолютным путём и ссылается на заголовок PlayReady. Заголовок PlayReady ссылается на заголовок защиты в клиентском манифесте для выходов Smooth Streaming и в тегах метаданных EXT-X-DXDRM и EXT-XDXDRMINFO для выходов HLS плейлистов. Пример URL: https://www.example.com/exampleKey/

Status -> (строка)

Статус задания, с которым связан плейлист.

StatusDetail -> (строка)

Дополнительная информация о статусе.

Status -> (строка)

Статус задания: Submitted , Progressing , Complete , Canceled или Error .

UserMetadata -> (карта)

Метаданные, определённые пользователем, которые вы хотите связать с заданием Elastic Transcoder. Вы указываете метаданные в парах key/value и можете добавить до 10 пар key/value на задание. Elastic Transcoder не гарантирует, что пары key/value будут возвращены в том же порядке, в котором вы их указали.

Метаданные keys и values должны использовать символы из следующего списка:

0-9
A-Z и a-z
Space
Следующие символы: _.:/=+-%@

key -> (строка)

value -> (строка)

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

Подробности о времени выполнения задания.

SubmitTimeMillis -> (целое число)

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

StartTimeMillis -> (целое число)

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

FinishTimeMillis -> (целое число)

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