GetDASHStreamingSessionURL - Amazon Kinesis Video Streams
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

GetDASHStreamingSessionURL

Recupera una URL de transmisión adaptativa dinámica MPEG a través de HTTP (DASH) para la transmisión. A continuación, puede abrir la URL en un reproductor multimedia para ver el contenido de la transmisión.

StreamNameTanto el parámetro como el StreamARN parámetro son opcionales, pero debes especificar uno StreamName o el StreamARN al invocar esta operación de API.

Una transmisión de vídeo de Amazon Kinesis tiene los siguientes requisitos para proporcionar datos a través de MPEG-DASH:

El siguiente procedimiento muestra cómo utilizar MPEG-DASH con Kinesis Video Streams:

  1. Llame a la GetDataEndpoint API para obtener un punto final. A continuación, envíe las GetDASHStreamingSessionURL solicitudes a este punto final mediante el parámetro --endpoint-url.

  2. Recupera la URL de MPEG-DASH usando. GetDASHStreamingSessionURL Kinesis Video Streams crea una sesión de streaming MPEG-DASH que se utiliza para acceder al contenido de una transmisión mediante el protocolo MPEG-DASH. GetDASHStreamingSessionURLdevuelve una URL autenticada (que incluye un token de sesión cifrado) para el manifiesto MPEG-DASH de la sesión (el recurso raíz necesario para la transmisión con MPEG-DASH).

    nota

    No compartas ni guardes este token donde una entidad no autorizada pueda acceder a él. El token proporciona acceso al contenido de la transmisión. Proteja el token con las mismas medidas que utiliza con sus AWS credenciales.

    El contenido multimedia que está disponible a través del manifiesto consiste únicamente en la transmisión, el intervalo de tiempo y el formato solicitados. No hay otros datos multimedia disponibles (como fotogramas fuera de la ventana solicitada o velocidades de bits alternativas).

  3. Proporcione la URL (que contiene el token de sesión cifrado) del manifiesto MPEG-DASH a un reproductor multimedia compatible con el protocolo MPEG-DASH. Kinesis Video Streams hace que el fragmento de inicialización y los fragmentos multimedia estén disponibles a través de la URL del manifiesto. El fragmento de inicialización contiene los datos privados del códec de la transmisión y otros datos necesarios para configurar el decodificador y el renderizador de vídeo o audio. Los fragmentos multimedia contienen fotogramas de vídeo codificados o muestras de audio codificadas.

  4. El reproductor multimedia recibe la URL autenticada y solicita los metadatos y los datos multimedia de la transmisión con normalidad. Cuando el reproductor multimedia solicita datos, ejecuta las siguientes acciones:

    • ObtenerDASHManifest: recupera un manifiesto MPEG DASH, que contiene los metadatos del contenido multimedia que desea reproducir.

    • Obtener MP4InitFragment: recupera el fragmento de inicialización. MP4 El reproductor multimedia suele cargar el fragmento de inicialización antes de cargar cualquier fragmento multimedia. Este fragmento contiene los átomos fytp «» y moov «» y los MP4 átomos secundarios necesarios para inicializar el decodificador del reproductor multimedia.

      El fragmento de inicialización no corresponde a un fragmento de una transmisión de vídeo de Kinesis. Contiene solo los datos privados del códec para la transmisión y la pista correspondiente, que el reproductor multimedia necesita para decodificar los fotogramas multimedia.

    • Obtener MP4MediaFragment: recupera fragmentos multimedia MP4. Estos fragmentos contienen los átomos «moof» y «mdat» y sus MP4 átomos secundarios, que contienen los marcos multimedia del fragmento codificado y sus marcas temporales.

      importante

      Los datos privados del códec (CPD) contenidos en cada fragmento contienen información de inicialización específica del códec, como la velocidad de fotogramas, la resolución y el perfil de codificación, que son necesarios para decodificar correctamente el fragmento. Los cambios de CPD no se admiten durante una sesión de streaming. El CPD debe permanecer coherente en todos los medios consultados.

      importante

      No se admiten los cambios de seguimiento. Las pistas deben permanecer consistentes en todo el contenido multimedia consultado. La transmisión fallará si los fragmentos de la transmisión pasan de tener solo vídeo a tener audio y vídeo, o si una pista de audio AAC pasa a ser una pista de audio A-Law.

      Los datos recuperados con esta acción son facturables. Para obtener más información, consulte Pricing.

nota

Para conocer las restricciones que se aplican a las sesiones MPEG-DASH, consulte Cuotas de Kinesis Video Streams.

Puedes monitorizar la cantidad de datos que consume el reproductor multimedia supervisando la CloudWatch métrica de GetMP4MediaFragment.OutgoingBytes Amazon. Para obtener información sobre cómo CloudWatch monitorizar Kinesis Video Streams, consulte Supervisión de Kinesis Video Streams. Para obtener información sobre precios, consulte Precios AWS y precios de Amazon Kinesis Video Streams. Se aplican cargos tanto por las sesiones de HLS como por los AWS datos salientes.

Para obtener más información sobre HLS, consulta HTTP Live Streaming en el sitio para desarrolladores de Apple.

importante

Si se produce un error después de invocar una API de contenido multimedia archivado de Kinesis Video Streams, además del código de estado HTTP y el cuerpo de la respuesta, se incluye la siguiente información:

  • x-amz-ErrorTypeEncabezado HTTP: contiene un tipo de error más específico además del que proporciona el código de estado HTTP.

  • x-amz-RequestIdEncabezado HTTP: si desea informar de un problema AWS al equipo de soporte, puede diagnosticar mejor el problema si se le proporciona el ID de solicitud.

Tanto el código de estado HTTP como el ErrorType encabezado se pueden utilizar para tomar decisiones programáticas sobre si los errores se pueden volver a cometer y en qué condiciones, así como para proporcionar información sobre las medidas que el programador del cliente podría tener que tomar para volver a intentarlo correctamente.

Para obtener más información, consulte la sección de errores al final de este tema, así como la sección Errores comunes.

Sintaxis de la solicitud

POST /getDASHStreamingSessionURL HTTP/1.1
Content-type: application/json

{
   "DASHFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "DisplayFragmentNumber": "string",
   "DisplayFragmentTimestamp": "string",
   "Expires": number,
   "MaxManifestFragmentResults": number,
   "PlaybackMode": "string",
   "StreamARN": "string",
   "StreamName": "string"
}

Parámetros de solicitud del URI

La solicitud no utiliza ningún parámetro de URI.

Cuerpo de la solicitud

La solicitud acepta los siguientes datos en formato JSON.

DASHFragmentSelector

El intervalo de tiempo del fragmento solicitado y el origen de las marcas de tiempo.

Este parámetro es obligatorio si PlaybackMode es ON_DEMAND o. LIVE_REPLAY Si lo es, este parámetro PlaybackMode es opcional LIVE. Si PlaybackMode es LIVE así, se FragmentSelectorType puede establecer, pero no se TimestampRange debe establecer. Si PlaybackMode es ON_DEMAND oLIVE_REPLAY, ambos FragmentSelectorType y TimestampRange deben estar configurados.

Tipo: objeto DASHFragmentSelector

Obligatorio: no

DisplayFragmentNumber

Los fragmentos se identifican en el archivo de manifiesto en función de su número de secuencia en la sesión. Si DisplayFragmentNumber se establece enALWAYS, el número de fragmento de Kinesis Video Streams se añade a cada elemento S del archivo de manifiesto con el nombre de atributo «kvs:fn». Estos números de fragmento se pueden usar para registrar o para usarlos con otros APIs (por ejemplo, y). GetMedia GetMediaForFragmentList Se necesita un reproductor multimedia MPEG-DASH personalizado para aprovechar este atributo personalizado.

El valor predeterminado es NEVER.

Tipo: cadena

Valores válidos: ALWAYS | NEVER

Obligatorio: no

DisplayFragmentTimestamp

Según la especificación MPEG-DASH, el tiempo de reloj de pared de los fragmentos del archivo de manifiesto se puede obtener mediante los atributos del propio manifiesto. Sin embargo, por lo general, los reproductores multimedia compatibles con MPEG-DASH no gestionan adecuadamente las brechas en la cronología multimedia. Kinesis Video Streams ajusta la cronología multimedia del archivo de manifiesto para permitir la reproducción de contenido multimedia con discontinuidades. Por lo tanto, es posible que la hora del reloj de pared derivada del archivo de manifiesto no sea precisa. Si DisplayFragmentTimestamp se establece enALWAYS, se añade la marca de tiempo exacta del fragmento a cada elemento S del archivo de manifiesto con el nombre de atributo «kvs:ts». Se necesita un reproductor multimedia MPEG-DASH personalizado para aprovechar este atributo personalizado.

El valor predeterminado es NEVER. Si DASHFragmentSelector es asíSERVER_TIMESTAMP, las marcas de tiempo serán las marcas de tiempo de inicio del servidor. Del mismo modo, cuando DASHFragmentSelector esPRODUCER_TIMESTAMP, las marcas de tiempo serán las marcas de tiempo de inicio del productor.

Tipo: cadena

Valores válidos: ALWAYS | NEVER

Obligatorio: no

Expires

El tiempo en segundos que falta para que caduque la sesión solicitada. Este valor puede estar entre 300 (5 minutos) y 43200 (12 horas).

Cuando una sesión caduca, no se pueden realizar nuevas llamadas a GetDashManifest esa sesión ni se GetMP4MediaFragment pueden realizar para ella. GetMP4InitFragment

El valor predeterminado es 300 (5 minutos).

Tipo: entero

Rango válido: valor mínimo de 300. Valor máximo de 43 200.

Obligatorio: no

MaxManifestFragmentResults

El número máximo de fragmentos que se devuelven en el manifiesto MPEG-DASH.

Si el valor PlaybackMode esLIVE, se devuelven los fragmentos más recientes hasta este valor. Si el PlaybackMode esON_DEMAND, se devuelven los fragmentos más antiguos, hasta este número máximo.

Cuando hay un número mayor de fragmentos disponibles en un manifiesto MPEG-DASH en directo, los reproductores de vídeo suelen almacenar el contenido en búfer antes de iniciar la reproducción. Al aumentar el tamaño del búfer, se aumenta la latencia de reproducción, pero se reduce la probabilidad de que se vuelva a almacenar en búfer durante la reproducción. Recomendamos que un manifiesto MPEG-DASH en directo tenga un mínimo de 3 fragmentos y un máximo de 10 fragmentos.

El valor predeterminado es de 5 fragmentos si PlaybackMode es LIVE o LIVE_REPLAY y 1000 si es. PlaybackMode ON_DEMAND

El valor máximo de 1000 fragmentos corresponde a más de 16 minutos de vídeo en las transmisiones con fragmentos de 1 segundo y a más de 2 horas y media de vídeo en las transmisiones con fragmentos de 10 segundos.

Tipo: largo

Rango válido: valor mínimo de 1. Valor máximo de 5000.

Obligatorio: no

PlaybackMode

Ya sea para recuperar datos en directo, reproducirlos en directo o archivados bajo demanda.

Entre las características de los tres tipos de sesiones se incluyen las siguientes:

  • LIVE: Para las sesiones de este tipo, el manifiesto MPEG-DASH se actualiza continuamente con los fragmentos más recientes a medida que están disponibles. Recomendamos que el reproductor multimedia recupere un nuevo manifiesto en un intervalo de un segundo. Cuando se reproduce este tipo de sesión en un reproductor multimedia, la interfaz de usuario suele mostrar una notificación «en directo», sin necesidad de controlar la posición de visualización en la ventana de reproducción.

    nota

    En el LIVE modo, los fragmentos más recientes disponibles se incluyen en un manifiesto MPEG-DASH, incluso si hay un espacio entre los fragmentos (es decir, si falta un fragmento). Un espacio como este puede provocar que el reproductor multimedia se detenga o que se interrumpa la reproducción. En este modo, los fragmentos no se añaden al manifiesto MPEG-DASH si son más antiguos que el fragmento más reciente de la lista de reproducción. Si el fragmento que falta pasa a estar disponible después de añadir otro fragmento al manifiesto, el fragmento anterior no se añadirá ni se llenará el espacio vacío.

  • LIVE_REPLAY: Para las sesiones de este tipo, el manifiesto MPEG-DASH se actualiza de forma similar a como se actualiza para el LIVE modo, con la salvedad de que comienza por incluir fragmentos de una hora de inicio determinada. En lugar de añadir fragmentos a medida que se ingieren, los fragmentos se añaden a medida que transcurre la duración del siguiente fragmento. Por ejemplo, si los fragmentos de la sesión duran dos segundos, se añade un fragmento nuevo al manifiesto cada dos segundos. Este modo resulta útil para poder iniciar la reproducción desde el momento en que se detecta un evento y seguir retransmitiendo en directo contenido multimedia que aún no se haya ingerido en el momento de la creación de la sesión. Este modo también es útil para transmitir contenido multimedia previamente archivado sin estar limitado por el límite de 1000 fragmentos establecido en el ON_DEMAND modo.

  • ON_DEMAND: Para sesiones de este tipo, el manifiesto MPEG-DASH contiene todos los fragmentos de la sesión, hasta el número especificado en. MaxManifestFragmentResults El manifiesto se debe recuperar solo una vez por sesión. Cuando este tipo de sesión se reproduce en un reproductor multimedia, la interfaz de usuario suele mostrar un control de barra para seleccionar la posición de la ventana de reproducción que se va a mostrar.

En todos los modos de reproducción, si FragmentSelectorType es PRODUCER_TIMESTAMP así, y si hay varios fragmentos con la misma marca de tiempo de inicio, el fragmento que tenga el número de fragmento mayor (es decir, el fragmento más reciente) se incluye en el manifiesto MPEG-DASH. Los demás fragmentos no están incluidos. Los fragmentos que tienen marcas de tiempo diferentes pero que tienen duraciones superpuestas se siguen incluyendo en el manifiesto MPEG-DASH. Esto puede provocar un comportamiento inesperado en el reproductor multimedia.

El valor predeterminado es LIVE.

Tipo: cadena

Valores válidos: LIVE | LIVE_REPLAY | ON_DEMAND

Obligatorio: no

StreamARN

El nombre del recurso de Amazon (ARN) de la transmisión de la que se va a recuperar la URL del manifiesto MPEG-DASH.

Debe especificar el o el. StreamName StreamARN

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres.

Patrón: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Obligatorio: no

StreamName

El nombre de la transmisión de la que se va a recuperar la URL del manifiesto MPEG-DASH.

Debe especificar el o elStreamName. StreamARN

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres.

Patrón: [a-zA-Z0-9_.-]+

Obligatorio: no

Sintaxis de la respuesta

HTTP/1.1 200
Content-type: application/json

{
   "DASHStreamingSessionURL": "string"
}

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.

El servicio devuelve los datos siguientes en formato JSON.

DASHStreamingSessionURL

La URL (que contiene el token de sesión) que un reproductor multimedia puede utilizar para recuperar el manifiesto MPEG-DASH.

Tipo: cadena

Errores

Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.

ClientLimitExceededException

Kinesis Video Streams ha limitado la solicitud porque ha superado un límite. Intente realizar la llamada más tarde. Para obtener información sobre los límites, consulte Cuotas de Kinesis Video Streams.

Código de estado HTTP: 400

InvalidArgumentException

Un parámetro específico supera sus restricciones, no se admite o no se puede usar.

Código de estado HTTP: 400

InvalidCodecPrivateDataException

Los datos privados del códec de al menos una de las pistas de la transmisión de vídeo no son válidos para esta operación.

Código de estado HTTP: 400

MissingCodecPrivateDataException

No se encontró ningún dato privado del códec en al menos una de las pistas de la transmisión de vídeo.

Código de estado HTTP: 400

NoDataRetentionException

GetImagesse solicitó para una transmisión que no retiene datos (es decir, tiene un valor DataRetentionInHours de 0).

Código de estado HTTP: 400

NotAuthorizedException

Código de estado: 403. La persona que llama no está autorizada a realizar ninguna operación en la transmisión en cuestión o el token ha caducado.

Código de estado HTTP: 401

ResourceNotFoundException

GetImagesmostrará este error cuando Kinesis Video Streams no encuentre la transmisión que ha especificado.

GetHLSStreamingSessionURLy GetDASHStreamingSessionURL arroja este error si una sesión con un PlaybackMode de ON_DEMAND o LIVE_REPLAY se solicita una transmisión que no tiene fragmentos en el intervalo de tiempo solicitado, o si LIVE se solicita una sesión con un PlaybackMode de o para una transmisión que no tiene fragmentos en los últimos 30 segundos.

Código de estado HTTP: 404

UnsupportedStreamMediaTypeException

El tipo de contenido multimedia (por ejemplo, vídeo h.264 o h.265 o audio AAC o G.711) no se pudo determinar a partir del códec de las pistas del primer fragmento IDs de una sesión de reproducción. El ID de códec de la pista 1 debería ser V_MPEG/ISO/AVC y, opcionalmente, el ID de códec de la pista 2 debería ser. A_AAC

Código de estado HTTP: 400

Véase también

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente: