get-dash-streaming-session-url

Описание

Получает URL-адрес MPEG Dynamic Adaptive Streaming over HTTP (DASH) для потока. Затем вы можете открыть URL-адрес в медиаплеере для просмотра содержимого потока.

Оба параметра StreamName и StreamARN являются необязательными, но вы должны указать либо StreamName, либо StreamARN при вызове этой операции API.

Поток Amazon Kinesis video имеет следующие требования для предоставления данных через MPEG-DASH:

• Медиа должны содержать видео с кодировкой h.264 или h.265 и, необязательно, аудио с кодировкой AAC или G.711. В частности, идентификатор кодека трека 1 должен быть V_MPEG/ISO/AVC (для h.264) или V_MPEGH/ISO/HEVC (для H.265). Необязательно, идентификатор кодека трека 2 должен быть A_AAC (для AAC) или A_MS/ACM (для G.711).
• Срок хранения данных должен быть больше 0.
• Трек видео каждого фрагмента должен содержать приватные данные кодека в формате Advanced Video Coding (AVC) для H.264 и HEVC для H.265. Дополнительную информацию см. в спецификации MPEG-4 ISO/IEC 14496-15. Сведения об адаптации данных потока к определенному формату см. в NAL Adaptation Flags.
• Трек аудио (если присутствует) каждого фрагмента должен содержать приватные данные кодека в формате AAC (спецификация AAC ISO/IEC 13818-7) или формате MS Wave.

Следующая процедура демонстрирует, как использовать MPEG-DASH с потоками Kinesis Video:

• Получите конечную точку, используя GetDataEndpoint, указав GET_DASH_STREAMING_SESSION_URL для параметра APIName.
• Получите URL-адрес MPEG-DASH, используя GetDASHStreamingSessionURL. Потоки Kinesis Video Streams создают сеанс потоковой передачи MPEG-DASH для доступа к содержимому потока с помощью протокола MPEG-DASH. GetDASHStreamingSessionURL возвращает аутентифицированный URL-адрес (включающий зашифрованный токен сеанса) для манифеста сеанса MPEG-DASH (корневой ресурс, необходимый для потоковой передачи с MPEG-DASH).

• Предоставьте URL-адрес (содержащий зашифрованный токен сеанса) для манифеста MPEG-DASH медиаплееру, который поддерживает протокол MPEG-DASH. Потоки Kinesis Video Streams предоставляют начальный фрагмент и фрагменты медиа через URL-адрес манифеста. Начальный фрагмент содержит приватные данные кодека для потока и другие данные, необходимые для настройки декодера и рендера видео или аудио. Фрагменты медиа содержат закодированные кадры видео или закодированные аудиосэмплы.

• Медиаплеер получает аутентифицированный URL-адрес и обычно запрашивает метаданные потока и данные медиа. Когда медиаплеер запрашивает данные, он вызывает следующие действия:

  • GetDASHManifest: Получает манифест MPEG DASH, который содержит метаданные для воспроизведения необходимых медиа.
  • GetMP4InitFragment: Получает начальный фрагмент MP4. Медиаплеер обычно загружает начальный фрагмент перед загрузкой любых фрагментов медиа. Этот фрагмент содержит «fytp» и «moov» атомы MP4 и дочерние атомы, которые необходимы для инициализации декодера медиаплеера. Начальный фрагмент не соответствует фрагменту в потоке Kinesis video. Он содержит только приватные данные кодека для потока и соответствующего трека, которые медиаплеер нуждается для декодирования кадров медиа.
  • GetMP4MediaFragment: Получает фрагменты медиа MP4. Эти фрагменты содержат «moof» и «mdat» атомы MP4 и их дочерние атомы, содержащие закодированные кадры медиа фрагмента и их временные метки.

  Примечание

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

  Данные, полученные с помощью этого действия, учитываются при расчете стоимости. Подробности см. в разделе Цены.

Вы можете отслеживать количество данных, которые потребляет медиаплеер, отслеживая метрику GetMP4MediaFragment.OutgoingBytes Amazon CloudWatch. Подробную информацию об использовании CloudWatch для мониторинга потоков Kinesis Video см. в разделе Мониторинг потоков Kinesis Video Streams. Сведения о ценах см. в разделах Цены Amazon Kinesis Video Streams и Цены Amazon Web Services. Применяются сборы за сеансы HLS и исходящие данные Amazon Web Services.

Дополнительную информацию об HLS см. на сайте Apple Developer в разделе HTTP Live Streaming.

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

Синопсис

  get-dash-streaming-session-url
[--stream-name <value>]
[--stream-arn <value>]
[--playback-mode <value>]
[--display-fragment-timestamp <value>]
[--display-fragment-number <value>]
[--dash-fragment-selector <value>]
[--expires <value>]
[--max-manifest-fragment-results <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]

Параметры

--stream-name (строка)

--stream-arn (строка)

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

--display-fragment-timestamp (строка)

--display-fragment-number (строка)

--dash-fragment-selector (структура)

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

FragmentSelectorType=string,TimestampRange={StartTimestamp=timestamp,EndTimestamp=timestamp}

Синтаксис JSON:

{
  "FragmentSelectorType": "PRODUCER_TIMESTAMP"|"SERVER_TIMESTAMP",
  "TimestampRange": {
    "StartTimestamp": timestamp,
    "EndTimestamp": timestamp
  }
}

--expires (целое число)

--max-manifest-fragment-results (длинное целое число)

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

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

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

--debug (булево)

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

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

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

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

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

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

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

--output (строка)

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

• json
• text
• table
• yaml
• yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

• on
• off
• auto

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

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

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

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

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

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

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

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

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

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

• base64
• raw-in-base64-out

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

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

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

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

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

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

Вывод

DASHStreamingSessionURL -> (строка)