get-hls-streaming-session-url

Описание

Получает URL-адрес HTTP Live Streaming (HLS) для потока. Затем вы можете открыть URL-адрес в браузере или проигрывателе медиа для просмотра содержимого потока.

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

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

• Для потокового видео медиа должны содержать видео, закодированное с использованием H.264 или H.265, и, необязательно, аудио, закодированное с использованием AAC. В частности, идентификатор кодека трека 1 должен быть V_MPEG/ISO/AVC (для H.264) или V_MPEG/ISO/HEVC (для H.265). Необязательно, идентификатор кодека трека 2 должен быть A_AAC. Для потокового аудио только идентификатор кодека трека 1 должен быть A_AAC.
• Срок хранения данных должен быть больше 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).

Сессии HLS потоков Kinesis Video Streams содержат фрагменты в фрагментированной форме MPEG-4 (также называемой fMP4 или CMAF) или форме MPEG-2 (также называемой TS-фрагментами, которые также поддерживаются спецификацией HLS). Для получения дополнительной информации о типах фрагментов HLS см. спецификацию HLS.

Следующая процедура демонстрирует использование HLS с Kinesis Video Streams:

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

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

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

  • **GetHLSMasterPlaylist:** Получает главный плейлист HLS, который содержит URL-адрес для действия GetHLSMediaPlaylist для каждого трека и дополнительные метаданные для проигрывателя медиа, включая предполагаемый битрейт и разрешение.
  • **GetHLSMediaPlaylist:** Получает плейлист медиа HLS, который содержит URL-адрес для доступа к фрагменту инициализации MP4 с действием GetMP4InitFragment и URL-адреса для доступа к фрагментам медиа MP4 с действиями GetMP4MediaFragment. Плейлист медиа HLS также содержит метаданные о потоке, необходимые проигрывателю для его воспроизведения, такие как то, является ли PlaybackMode LIVE или ON_DEMAND. Плейлист медиа HLS обычно статичен для сессий с PlaybackType ON_DEMAND. Плейлист медиа HLS постоянно обновляется новыми фрагментами для сессий с PlaybackType LIVE. Существует отдельный плейлист медиа HLS для видеотрека и аудиотрека (если применимо), содержащий URL-адреса MP4 медиа для конкретного трека.
  • **GetMP4InitFragment:** Получает фрагмент инициализации MP4. Проигрыватель медиа обычно загружает фрагмент инициализации перед загрузкой любых фрагментов медиа. Этот фрагмент содержит атомы MP4 «fytp» и «moov», а также дочерние атомы, необходимые для инициализации декодера проигрывателя медиа. Фрагмент инициализации не соответствует фрагменту в потоке Kinesis video. Он содержит только частные данные кодека для потока и соответствующего трека, которые проигрывателю медиа нужны для декодирования кадров медиа.
  • **GetMP4MediaFragment:** Получает фрагменты медиа MP4. Эти фрагменты содержат атомы MP4 «moof» и «mdat» и их дочерние атомы, содержащие закодированные фрагменты кадров медиа и их временные метки.

  Примечание

  Для сессии потоковой передачи HLS поддерживаются изменения частных данных кодека (CPD) в треке. После того, как первый фрагмент медиа становится доступным в сессии потоковой передачи, фрагменты могут содержать изменения CPD для каждого трека. Следовательно, фрагменты в сессии могут иметь другое разрешение, битрейт или другую информацию в CPD без прерывания воспроизведения. Однако любые изменения, внесенные в номер трека или формат кодека трека, могут привести к ошибке при загрузке этих различных фрагментов медиа. Например, потоковая передача завершится неудачей, если фрагменты в потоке изменятся с наличия только видео на наличие как видео, так и аудио, или если аудиотрек AAC будет изменен на аудиотрек ALAW. Для каждой сессии потоковой передачи разрешено только 500 изменений CPD.

  Полученные с этим действием данные подлежат оплате. Для получения информации см. Цены.

  • **GetTSFragment:** Получает фрагменты MPEG TS, содержащие данные инициализации и медиа для всех треков в потоке.

  Примечание

  Если ContainerFormat является MPEG_TS, этот API используется вместо GetMP4InitFragment и GetMP4MediaFragment для получения медиа потока.

  Полученные с этим действием данные подлежат оплате. Дополнительную информацию см. в разделе Цены на Kinesis Video Streams.

URL-адрес сессии потоковой передачи не должен использоваться несколькими проигрывателями. Служба может ограничивать сессию, если несколько проигрывателей медиа используют ее совместно. Для ограничений подключения см. Пределы Kinesis Video Streams.

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

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

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

Синтаксис

  get-hls-streaming-session-url
[--stream-name <value>]
[--stream-arn <value>]
[--playback-mode <value>]
[--hls-fragment-selector <value>]
[--container-format <value>]
[--discontinuity-mode <value>]
[--display-fragment-timestamp <value>]
[--expires <value>]
[--max-media-playlist-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 (строка)

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

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

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

Синтаксис JSON:

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

--container-format (строка)

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

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

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

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

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

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

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

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

Вывод

HLSStreamingSessionURL -> (строка)