Spec-Zone.ru › AWS CLI v2

[ aws . mediatailor ]

put-playback-configuration

Описание

Создаёт конфигурацию воспроизведения. Сведения о конфигурациях MediaTailor см. в разделе Работа с конфигурациями в AWS Elemental MediaTailor.

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

Синтаксис

  put-playback-configuration
[--ad-decision-server-url <value>]
[--avail-suppression <value>]
[--bumper <value>]
[--cdn-configuration <value>]
[--configuration-aliases <value>]
[--dash-configuration <value>]
[--insertion-mode <value>]
[--live-pre-roll-configuration <value>]
[--manifest-processing-rules <value>]
--name <value>
[--personalization-threshold-seconds <value>]
[--slate-ad-url <value>]
[--tags <value>]
[--transcode-profile-name <value>]
[--video-content-source-url <value>]
[--ad-conditioning-configuration <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]

Параметры

--ad-decision-server-url (строка)

URL сервера принятия решений по рекламе (ADS). Он включает в себя указание статических параметров и заглушек для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сессии, при необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

--avail-suppression (структура)

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

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

Устанавливает режим подавления рекламы. По умолчанию подавление рекламы выключено, и все рекламные блоки заполняются рекламой или слайдом. Когда Режим установлен на BEHIND_LIVE_EDGE, подавление рекламы включено, и MediaTailor не будет заполнять рекламные блоки до или после времени подавления рекламы Value в окне просмотра манифеста. Когда Режим установлен на AFTER_LIVE_EDGE, подавление рекламы включено, и MediaTailor не будет заполнять рекламные блоки, которые находятся в пределах живого края плюс значение подавления доступности.

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

Время смещения живого края в формате ЧЧ:ММ:СС. MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра манифеста. Если Значение установлено на 00:00:00, оно синхронизируется с живым краем, и MediaTailor не будет заполнять никакие рекламные блоки до или после живого края. Если вы установите время Value, MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра манифеста. Например, если вы установите 00:45:00, то MediaTailor будет заполнять рекламные блоки, которые возникают в течение 45 минут до живого края, но не будет заполнять рекламные блоки до или после 45 минут до живого края.

ПолитикаЗаполнения -> (строка)

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

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

Mode=string,Value=string,FillPolicy=string

Синтаксис JSON:

{
  "Mode": "OFF"|"BEHIND_LIVE_EDGE"|"AFTER_LIVE_EDGE",
  "Value": "string",
  "FillPolicy": "FULL_AVAIL_ONLY"|"PARTIAL_AVAIL"
}

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

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

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

URL конечного баннера.

НачальныйUrl -> (строка)

URL начального баннера.

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

EndUrl=string,StartUrl=string

Синтаксис JSON:

{
  "EndUrl": "string",
  "StartUrl": "string"
}

--cdn-configuration (структура)

Настройка для использования сети доставки контента (CDN), такой как Amazon CloudFront, для управления сегментами контента и рекламы.

ПрефиксUrlСегментаРекламы -> (строка)

Нестандартная сеть доставки контента (CDN) для предоставления рекламных сегментов. По умолчанию AWS Elemental MediaTailor использует Amazon CloudFront с настройками кэша по умолчанию в качестве своей CDN для рекламных сегментов. Чтобы настроить альтернативную CDN, создайте правило в вашей CDN для источника рекламы ads.mediatailor.*<region>* .amazonaws.com. Затем укажите имя правила в этом AdSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет манифест, он сообщает вашу CDN в качестве источника рекламных сегментов.

ПрефиксUrlСегментаКонтента -> (строка)

Сеть доставки контента (CDN) для кэширования сегментов контента, чтобы запросы контента не всегда отправлялись на сервер источника. Сначала создайте правило в вашей CDN для сервера источника сегмента контента. Затем укажите имя правила в этом ContentSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет манифест, он сообщает вашу CDN в качестве источника сегментов контента.

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

AdSegmentUrlPrefix=string,ContentSegmentUrlPrefix=string

Синтаксис JSON:

{
  "AdSegmentUrlPrefix": "string",
  "ContentSegmentUrlPrefix": "string"
}

--configuration-aliases (карта)

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

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

Динамическая переменная, имеющая псевдонимы.

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

Карта псевдонимов со значением, которое будет использоваться во время запроса.

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

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

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

KeyName1=KeyName1=string,KeyName2=string,KeyName2=KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--dash-configuration (структура)

Настройка для контента DASH.

MpdМестоположение -> (строка)

Настройка, определяющая, включает ли MediaTailor тег Location в манифестах DASH. MediaTailor заполняет тег Location URL для запросов обновления манифеста, чтобы использовать их для плееров, которые не поддерживают склеенные перенаправления. Отключите это, если у вас настроены правила маршрутизации CDN для доступа к манифестам MediaTailor, и вы используете отчётность на стороне клиента или ваши плееры поддерживают склеенные HTTP-перенаправления. Допустимые значения — DISABLED и EMT_DEFAULT. Настройка EMT_DEFAULT включает включение тега и является значением по умолчанию.

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

Настройка, определяющая, обрабатывает ли MediaTailor манифесты с сервера источника как многопериодические манифесты или однопериодические манифесты. Если ваш сервер источника создаёт однопериодические манифесты, установите это значение на SINGLE_PERIOD. Значение по умолчанию — MULTI_PERIOD. Для многопериодических манифестов опустите эту настройку или установите её на MULTI_PERIOD.

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

MpdLocation=string,OriginManifestType=string

Синтаксис JSON:

{
  "MpdLocation": "string",
  "OriginManifestType": "SINGLE_PERIOD"|"MULTI_PERIOD"
}

--insertion-mode (строка)

Настройка, определяющая, могут ли плееры использовать склеенные или управляемые вставки рекламы. По умолчанию, STITCHED_ONLY, все сеансы плееров вынуждены использовать склеенные (на стороне сервера) вставки рекламы. Выбор PLAYER_SELECT позволяет плеерам выбирать либо склеенные, либо управляемые вставки рекламы во время инициализации сеанса. По умолчанию для плееров, которые не указывают режим вставки, используется склеенный.

Возможные значения:

  • STITCHED_ONLY
  • PLAYER_SELECT

--live-pre-roll-configuration (структура)

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

UrlСервераПринятияРешенийРекламы -> (строка)

URL сервера принятия решений по рекламе (ADS) для рекламы предварительного просмотра. Он включает в себя указание статических параметров и заглушек для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сессии, при необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

МаксимальнаяПродолжительностьВСекундах -> (целое число)

Максимальная разрешённая продолжительность рекламного блока предварительного просмотра. AWS Elemental MediaTailor не будет воспроизводить рекламу предварительного просмотра, превышающую это время, независимо от общей продолжительности рекламы, возвращённой ADS.

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

AdDecisionServerUrl=string,MaxDurationSeconds=integer

Синтаксис JSON:

{
  "AdDecisionServerUrl": "string",
  "MaxDurationSeconds": integer
}

--manifest-processing-rules (структура)

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

ПрозрачностьМаркиРекламы -> (структура)

Для HLS, при установке на true, MediaTailor пропускает EXT-X-CUE-IN, EXT-X-CUE-OUT и EXT-X-SPLICEPOINT-SCTE35 метки рекламы из исходного манифеста в персонализированный манифест MediaTailor.

Никакая логика к этим меткам рекламы не применяется. Например, если EXT-X-CUE-OUT имеет значение 60, но реклама для этого рекламного блока не заполняется, MediaTailor не установит значение на 0.

Включено -> (булево)

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

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

AdMarkerPassthrough={Enabled=boolean}

Синтаксис JSON:

{
  "AdMarkerPassthrough": {
    "Enabled": true|false
  }
}

--name (строка)

Идентификатор конфигурации воспроизведения.

--personalization-threshold-seconds (целое число)

Определяет максимальную продолжительность незаполненного времени рекламы (в секундах) в рекламном блоке. Если продолжительность незаполненного времени рекламы превышает порог персонализации, то персонализация рекламного блока отменяется, и отображается базовый контент. Эта функция относится к замене рекламы в потоковых и VOD-потоках, а не к вставке рекламы, поскольку она зависит от базового потока контента. Дополнительную информацию о поведении рекламного блока, включая замену и вставку рекламы, см. в разделе Поведение рекламы в AWS Elemental MediaTailor.

--slate-ad-url (строка)

URL для видеоактива с высоким качеством для транскодирования и использования для заполнения времени, которое не используется рекламой. AWS Elemental MediaTailor отображает слайды, чтобы заполнить пробелы в медиаконтенте. Настройка слайда необязательна для конфигураций без VPAID. Для VPAID слайд обязателен, потому что MediaTailor предоставляет его в слотах, предназначенных для динамического контента рекламы. Слайд должен быть активом высокого качества, содержащим как аудио, так и видео.

--tags (карта)

Теги, которые следует назначить конфигурации воспроизведения. Теги — это пары «ключ-значение», которые можно назначить ресурсам Amazon для организации, контроля доступа и отслеживания затрат. Дополнительную информацию см. в разделе Назначение тегов ресурсам AWS Elemental MediaTailor.

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

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

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

KeyName1=string,KeyName2=string

Синтаксис JSON:

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

--transcode-profile-name (строка)

Имя, используемое для связи этой конфигурации воспроизведения с пользовательским профилем транскодирования. Это переопределяет динамические значения транскодирования MediaTailor по умолчанию. Используйте это только в том случае, если вы уже настроите пользовательские профили с помощью службы поддержки AWS.

--video-content-source-url (строка)

Префикс URL родительского манифеста для потока за минусом идентификатора актива. Максимальная длина составляет 512 символов.

--ad-conditioning-configuration (структура)

Настройка, указывающая, какое кондиционирование MediaTailor выполнит для рекламы, возвращённой сервером принятия решений по рекламе (ADS), и какой приоритет MediaTailor использует при вставке рекламы.

Условная обработкаФайлаМедиаПотока -> (строка)

Для рекламы, имеющей файлы медиа с доставкой потоковой передачи и поддерживаемые расширения файлов, указывает, какое действие по транскодированию выполняет MediaTailor при первом получении этой рекламы от ADS. TRANSCODE указывает, что MediaTailor должен транскодировать рекламу. NONE указывает, что вы уже транскодировали рекламу вне MediaTailor и не нуждаетесь в её транскодировании в рамках рабочей среды вставки рекламы. Дополнительную информацию об обработке рекламы см. в руководстве пользователя Elemental MediaTailor.

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

StreamingMediaFileConditioning=string

Синтаксис JSON:

{
  "StreamingMediaFileConditioning": "TRANSCODE"|"NONE"
}

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

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

Общие параметры

--debug (логическое значение)

Включить отладочную запись журналов.

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

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

Регион для использования. Переопределяет параметры config/env.

--version (строка)

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

--color (строка)

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

  • включено
  • выключено
  • автоматически

--no-sign-request (логическое значение)

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

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

Набор сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет параметры config/env.

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

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

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

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

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

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

  • base64
  • raw-in-base64-out

--no-cli-pager (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Для создания конфигурации

Следующий put-playback-configuration создает конфигурацию с именем campaign_short.

aws mediatailor put-playback-configuration \
    --name campaign_short \
    --ad-decision-server-url http://your.ads.url \
    --video-content-source-url http://video.bucket/index.m3u8

Вывод:

{
    "AdDecisionServerUrl": "http://your.ads.url",
    "CdnConfiguration": {},
    "DashConfiguration": {
         "ManifestEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/dash/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/",
         "MpdLocation": "EMT_DEFAULT",
         "OriginManifestType": "MULTI_PERIOD"
    },
    "HlsConfiguration": {
        "ManifestEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/master/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/"
    },
    "Name": "campaign_short",
    "PlaybackConfigurationArn": "arn:aws:mediatailor:us-west-2:123456789012:playbackConfiguration/campaign_short",
    "PlaybackEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com",
    "SessionInitializationEndpointPrefix": "https://13484114d38f4383bc0d6a7cb879bd00.mediatailor.us-west-2.amazonaws.com/v1/session/1cbfeaaecb69778e0c167d0505a2bc57da2b1754/campaign_short/",
    "Tags": {},
    "VideoContentSourceUrl": "http://video.bucket/index.m3u8"
}

Дополнительную информацию см. в разделе Создание конфигурации в руководстве пользователя AWS Elemental MediaTailor.

Вывод

AdDecisionServerUrl -> (строка)

URL сервера принятия решений о рекламе (ADS). Он включает указание статических параметров и заготовок для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сеанса, при необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

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

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

Mode -> (строка)

Устанавливает режим подавления рекламы. По умолчанию подавление рекламы выключено, и все рекламные блоки заполняются рекламой или заполнителем. Когда Mode установлен в значение BEHIND_LIVE_EDGE, подавление рекламы активно, и MediaTailor не будет заполнять рекламные блоки до или после времени подавления Value в окне просмотра манифеста. Когда Mode установлен в значение AFTER_LIVE_EDGE, подавление рекламы активно, и MediaTailor не будет заполнять рекламные блоки, которые находятся в пределах текущего времени плюс значение подавления доступности.

Value -> (строка)

Смещение от текущего времени в формате ЧЧ:ММ:СС. MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра манифеста. Если Value установлен в значение 00:00:00, это соответствует текущему времени, и MediaTailor не будет заполнять рекламные блоки до или после текущего времени. Если вы задаете значение Value, MediaTailor не будет заполнять рекламные блоки до или после этого времени в окне просмотра манифеста. Например, если вы зададите значение 00:45:00, MediaTailor будет заполнять рекламные блоки, которые происходят в течение 45 минут до текущего времени, но не будет заполнять рекламные блоки до или после 45 минут до текущего времени.

FillPolicy -> (строка)

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

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

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

EndUrl -> (строка)

URL ресурса конечного вставного ролика.

StartUrl -> (строка)

URL ресурса начального вставного ролика.

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

Настройка использования сети доставки контента (CDN), например Amazon CloudFront, для управления сегментами контента и рекламы.

AdSegmentUrlPrefix -> (строка)

Альтернативная сеть доставки контента (CDN) для предоставления рекламных сегментов. По умолчанию AWS Elemental MediaTailor использует Amazon CloudFront с параметрами кэширования по умолчанию в качестве CDN для рекламных сегментов. Чтобы настроить альтернативный CDN, создайте правило в вашей CDN для источника ads.mediatailor.*<region>* .amazonaws.com. Затем укажите имя правила в этом поле AdSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет манифест, он указывает вашу CDN как источник рекламных сегментов.

ContentSegmentUrlPrefix -> (строка)

Сеть доставки контента (CDN) для кэширования сегментов контента, чтобы запросы на контент не всегда поступали на сервер источника. Сначала создайте правило в вашей CDN для сервера источника сегментов контента. Затем укажите имя правила в этом поле ContentSegmentUrlPrefix. Когда AWS Elemental MediaTailor предоставляет манифест, он указывает вашу CDN как источник сегментов контента.

ConfigurationAliases -> (отображение)

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

key -> (строка)

Динамическая переменная, имеющая псевдонимы.

value -> (отображение)

Отображение псевдонимов с значением, которое будет использоваться во время запроса.

key -> (строка)

value -> (строка)

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

Настройка для контента DASH.

ManifestEndpointPrefix -> (строка)

URL, сгенерированный MediaTailor для начала сеанса воспроизведения. Сеанс использует отчёт сервера. Этот параметр игнорируется при операциях PUT.

MpdLocation -> (строка)

Параметр, контролирующий включение тега Location в DASH-манифесты. MediaTailor заполняет тег Location URL запросов обновления манифеста, который используется плеерами, не поддерживающими постоянные перенаправления. Отключите его, если у вас настроены правила маршрутизации CDN для доступа к манифестам MediaTailor, и вы используете отчёт клиента или ваши плееры поддерживают постоянные HTTP-перенаправления. Допустимые значения: DISABLED и EMT_DEFAULT. Параметр EMT_DEFAULT включает включение тега и является значением по умолчанию.

OriginManifestType -> (строка)

Настройка, контролирующая обработку манифестов с сервера источника как манифестов с несколькими периодами или как манифестов с одним периодом. Если ваш сервер источника создаёт манифесты с одним периодом, установите это значение в SINGLE_PERIOD. Значение по умолчанию — MULTI_PERIOD. Для манифестов с несколькими периодами опустите этот параметр или установите его в значение MULTI_PERIOD.

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

Настройка для контента HLS.

ManifestEndpointPrefix -> (строка)

URL, используемый для инициирования сеанса воспроизведения для устройств, поддерживающих Apple HLS. Сеанс использует отчёт сервера.

InsertionMode -> (строка)

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

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

Настройка для вставки пре-ролл рекламы.

AdDecisionServerUrl -> (строка)

URL сервера принятия решений о рекламе (ADS) для пре-ролл рекламы. Он включает указание статических параметров и заготовок для динамических параметров. AWS Elemental MediaTailor подставляет параметры, специфичные для плеера и сеанса, при необходимости при вызове ADS. В качестве альтернативы для тестирования можно указать статический URL VAST. Максимальная длина составляет 25 000 символов.

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

Максимальная допустимая продолжительность доступности пре-ролл рекламы. AWS Elemental MediaTailor не будет воспроизводить пре-ролл рекламу, превышающую эту продолжительность, независимо от общей продолжительности рекламы, возвращённой ADS.

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

Настройка, определяющая, куда AWS Elemental MediaTailor отправляет журналы для конфигурации воспроизведения.

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

Процент журналов сеансов, которые MediaTailor отправляет в указанный вами журнал. Например, если ваша конфигурация воспроизведения имеет 1000 сеансов, и percentEnabled установлено в 60, MediaTailor отправит журналы для 600 сеансов в CloudWatch Logs. MediaTailor случайным образом определяет, журналы каких сеансов конфигурации воспроизведения отправлять. Если вы хотите просмотреть журналы конкретного сеанса, вы можете использовать режим журнала отладки.

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

EnabledLoggingStrategies -> (список)

Метод сбора журналов от AWS Elemental MediaTailor. LEGACY_CLOUDWATCH указывает, что MediaTailor отправляет журналы непосредственно в Amazon CloudWatch Logs. VENDED_LOGS указывает, что MediaTailor отправляет журналы в CloudWatch, который затем отправляет журналы в ваше выбранное место назначения. Поддерживаемые места назначения — группа журналов CloudWatch Logs, ведро Amazon S3 и поток Amazon Data Firehose.

(строка)

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

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

PublishOptInEventTypes -> (список)

Указывает, что MediaTailor выпускает RAW_ADS_RESPONSE журналы для сеансов воспроизведения, которые инициализированы с помощью этой конфигурации.

(строка)

ExcludeEventTypes -> (список)

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

(строка)

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

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

ExcludeEventTypes -> (список)

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

(строка)

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

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

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

Для HLS, при установке в значение true, MediaTailor пропускает EXT-X-CUE-IN, EXT-X-CUE-OUT и EXT-X-SPLICEPOINT-SCTE35 метки рекламы из исходного манифеста в персонализированный манифест MediaTailor.

К этим меткам рекламы не применяется логика. Например, если EXT-X-CUE-OUT имеет значение 60, но реклама не заполняется для этого рекламного блока, MediaTailor не установит значение в 0.

Enabled -> (логическое)

Включает передачу меток рекламы для вашей конфигурации.

Name -> (строка)

Идентификатор конфигурации воспроизведения.

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

Определяет максимальную продолжительность незаполненного времени рекламы (в секундах) в рекламном блоке. Если продолжительность незаполненного времени рекламы превышает порог персонализации, персонализация рекламного блока отменяется, и отображается исходный контент. Эта функция применяется к замене рекламы в потоках в реальном времени и VOD, а не к вставке рекламы, так как она опирается на исходный поток контента. Дополнительную информацию о поведении рекламных блоков, включая замену и вставку рекламы, см. в разделе Поведение рекламы в AWS Elemental MediaTailor.

PlaybackConfigurationArn -> (строка)

Amazon Resource Name (ARN), связанный с конфигурацией воспроизведения.

PlaybackEndpointPrefix -> (строка)

Префикс конечной точки воспроизведения, связанный с конфигурацией воспроизведения.

SessionInitializationEndpointPrefix -> (строка)

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

SlateAdUrl -> (строка)

URL высококачественного видеоресурса, который нужно транскодировать и использовать для заполнения незадействованного времени рекламой. AWS Elemental MediaTailor отображает заполнитель для заполнения пробелов в медиаконтенте. Настройка заполнителя необязательна для конфигураций, не использующих VPAID. Для VPAID заполнитель необходим, так как MediaTailor предоставляет его в слотах, предназначенных для динамического рекламного контента. Заполнитель должен быть высококачественным ресурсом, содержащим как аудио, так и видео.

Tags -> (отображение)

Теги для назначения конфигурации воспроизведения. Теги — пары ключ-значение, которые можно связать с ресурсами Amazon для организации, контроля доступа и отслеживания затрат. Дополнительную информацию см. в разделе Маркировка ресурсов AWS Elemental MediaTailor.

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

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

TranscodeProfileName -> (строка)

Имя, используемое для связывания этой конфигурации воспроизведения с настраиваемым профилем транскодирования. Это переопределяет динамические параметры транскодирования MediaTailor. Используйте только в том случае, если вы уже настроили пользовательские профили с помощью службы поддержки AWS.

VideoContentSourceUrl -> (строка)

Префикс URL для родительского манифеста потока, минус идентификатор ресурса. Максимальная длина — 512 символов.

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

Настройки, указывающие, какие действия по обработке MediaTailor выполнит над объявлениями, возвращенными сервером принятия решений об объявлениях (ADS), и какой приоритет MediaTailor использует при вставке объявлений.

StreamingMediaFileConditioning -> (строка)

Для объявлений, у которых медиафайлы имеют потоковую передачу и поддерживаемые расширения файлов, указывает, какое действие по транскодированию выполняет MediaTailor при первом получении этих объявлений от ADS. TRANSCODE указывает, что MediaTailor должен транскодировать объявления. NONE указывает, что вы уже транскодировали объявления вне MediaTailor и не нуждаетесь в их транскодировании в рамках процесса вставки объявлений. Дополнительную информацию об обработке объявлений см. в руководстве пользователя Elemental MediaTailor в разделе Использование предварительно обработанных объявлений.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API