View a markdown version of this page

Reproducción de vídeo con HLS - Amazon Kinesis Video Streams
Use la AWS CLI para recuperar la URL de una sesión de streaming de HLSEjemplo: usa HLS en HTML y JavaScriptSolución de problemas de HLS

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.

Reproducción de vídeo con HLS

HTTP Live Streaming (HLS) es un protocolo de comunicación de streaming HTTP-based multimedia estándar del sector. Puede usar HLS para ver una transmisión de vídeo de Kinesis, ya sea para reproducirla en directo o para ver vídeos archivados.

Puede utilizar HLS para la reproducción en directo. La latencia suele oscilar entre 3 y 5 segundos, pero puede oscilar entre 1 y 10 segundos, según el caso de uso, el reproductor y las condiciones de la red. Puedes usar un reproductor de terceros (como Google Shaka Player) para mostrar la transmisión de vídeo proporcionando la URL de la sesión de streaming HLS, ya sea mediante programación Video.js o de forma manual. También puedes reproducir vídeos introduciendo la URL de la sesión de streaming de HLS en la barra de ubicación de los navegadores Apple Safari o Microsoft Edge. https://www.microsoft.com/en-us/edge

Para ver una transmisión de vídeo de Kinesis con HLS, primero cree una sesión de transmisión con. GetHLSStreamingSessionURL Esta acción devuelve una URL (que contiene un token de sesión) que permite tener acceso a la sesión HLS. A continuación, puede utilizar la URL en un reproductor multimedia o en una aplicación independiente para mostrar la transmisión.

importante

No todos los archivos multimedia enviados a Kinesis Video Streams se pueden reproducir mediante HLS. Consulte los GetHLSStreamingSessionURL requisitos de carga específicos.

Use la AWS CLI para recuperar la URL de una sesión de streaming de HLS

El siguiente procedimiento muestra cómo utilizar la URL AWS CLI para generar una sesión de streaming de HLS para una transmisión de vídeo de Kinesis.

Para obtener instrucciones de instalación, consulte la Guía del AWS Command Line Interface usuario. Tras la instalación, configúrala AWS CLI con las credenciales y la región.

Como alternativa, abra el AWS CloudShell terminal, que lo tiene AWS CLI instalado y configurado. Para obtener más información, consulte la guía del usuario de AWS CloudShell.

Recupere el punto final de la URL de HLS para su transmisión de vídeo de Kinesis.

  1. Escriba lo siguiente en la terminal:

    aws kinesisvideo get-data-endpoint \
  --api-name GET_HLS_STREAMING_SESSION_URL \
  --stream-name YourStreamName

    Recibirás una respuesta similar a la siguiente:

    {
    "DataEndpoint": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com"
}

  2. Realice la solicitud de URL de la sesión de streaming de HLS a ese punto final devuelto.

    Live

    Para la reproducción en directo, la lista de reproducción multimedia de HLS se actualiza continuamente con los archivos multimedia más recientes a medida que están disponibles. Cuando se reproduce este tipo de sesión en un reproductor multimedia, la interfaz de usuario suele mostrar una notificación «en directo», sin ningún control de desplazamiento para elegir la posición en la ventana de reproducción en la que desea que se muestre.

    Asegúrese de que está cargando contenido multimedia a esta transmisión cuando ejecute este comando. 

    aws kinesis-video-archived-media get-hls-streaming-session-url \
  --endpoint-url https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com \
  --stream-name YourStreamName \
  --playback-mode LIVE
    Live replay

    Para la reproducción en directo, la reproducción comienza a partir de una hora de inicio especificada. La lista de reproducción multimedia HLS también se actualiza continuamente con los archivos multimedia más recientes a medida que están disponibles. La sesión seguirá incluyendo contenido multimedia recién ingerido hasta que caduque o hasta la hora de finalización especificada, lo que ocurra primero. Este modo es útil para poder iniciar la reproducción desde el momento en que se detecta un evento y continuar transmitiendo en directo contenido multimedia que aún no se haya ingerido en el momento de la creación de la sesión.

    Determine una marca de tiempo de inicio.

    Para este ejemplo, utilizamos el formato Unix Epoch time in seconds. Consulte la sección de marcas de tiempo de la Guía del AWS Command Line Interface usuario para obtener más información sobre el formato de las marcas de tiempo.

    Consulte UnixTime.org para obtener una herramienta de conversión.

    • 1708471800 equivale al 20 de febrero de 2024 a las 3:30:00 p. m. GMT-08:00

    En este ejemplo, no especificamos una marca de tiempo de finalización, lo que significa que la sesión seguirá incluyendo los medios recién ingeridos hasta que caduque la sesión.

    Invoca la GetHLSStreamingSessionURL API con el modo de LIVE_REPLAY reproducción y un selector de fragmentos HLS especificado. 

    aws kinesis-video-archived-media get-hls-streaming-session-url \
  --endpoint-url https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com \
  --stream-name YourStreamName \
  --playback-mode LIVE_REPLAY \
  --hls-fragment-selector \
    "FragmentSelectorType=SERVER_TIMESTAMP,TimestampRange={StartTimestamp=1708471800}"
    On-demand

    Para la reproducción bajo demanda, la lista de reproducción multimedia de HLS contiene el contenido multimedia especificado por el selector de fragmentos de HLS. Cuando este tipo de sesión se reproduce en un reproductor multimedia, la interfaz de usuario suele mostrar un control de desplazamiento para elegir la posición en la ventana de reproducción que desea mostrar.

    Para crear una URL para una sección determinada de la transmisión, primero determine las marcas de tiempo de inicio y finalización.

    Para este ejemplo, utilizamos el formato Unix Epoch time in seconds. Consulte la sección de marcas de tiempo de la Guía del AWS Command Line Interface usuario para obtener más información sobre el formato de las marcas de tiempo.

    Consulte UnixTime.org para obtener una herramienta de conversión.

    • 1708471800 equivale al 20 de febrero de 2024 a las 3:30:00 p. m. GMT-08:00

    • 1708471860 es igual a las 3:31:00 del 20 de febrero de 2024 GMT-08:00

    Invoca la GetHLSStreamingSessionURL API con el modo de ON_DEMAND reproducción y un selector de fragmentos HLS especificado. https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_reader_GetHLSStreamingSessionURL.html#KinesisVideo-reader_GetHLSStreamingSessionURL-request-HLSFragmentSelector

    aws kinesis-video-archived-media get-hls-streaming-session-url \
  --endpoint-url https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com \
  --stream-name YourStreamName \
  --playback-mode ON_DEMAND \
  --hls-fragment-selector \
    "FragmentSelectorType=SERVER_TIMESTAMP,TimestampRange={StartTimestamp=1708471800,EndTimestamp=1708471860}"
    nota

    Las marcas de tiempo deben tener una diferencia de 24 horas entre sí, tal y como se indica en la documentación. HLSTimestampRange

    Recibirás una respuesta similar a la siguiente:

    {
    "HLSStreamingSessionURL": "https://b-1234abcd.kinesisvideo.aws-region.amazonaws.com/hls/v1/getHLSMasterPlaylist.m3u8?SessionToken=CiAz...DkRE6M~"
}
    importante

    No compartas ni guardes este token en lugares 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 utilizaría con sus AWS credenciales.

    Puedes usar esta URL y cualquier reproductor HLS para ver la transmisión HLS.

    Por ejemplo, usa el reproductor multimedia VLC.

    También puedes reproducir el HLS Stream introduciendo la URL de la sesión de streaming del HLS en la barra de ubicación de los navegadores Apple Safari o Microsoft Edge.

Ejemplo: usa HLS en HTML y JavaScript

El siguiente ejemplo muestra cómo usar el AWS SDK de la JavaScript versión 2 para recuperar una sesión de streaming de HLS para una transmisión de vídeo de Kinesis y reproducirla en una página web. El ejemplo muestra cómo reproducir vídeo en los siguientes reproductores:

Vea el código de ejemplo completo y la página web alojada en. GitHub Esta página web estática simplifica las pruebas y la experimentación con el HLS y los MPEG-DASH resultados de la transmisión de vídeo de Amazon Kinesis. La página de ejemplo proporciona campos de entrada para los siguientes parámetros:

  • Región de AWS: La región en la que se encuentra su transmisión de vídeo de Kinesis

  • Nombre de la transmisión: el nombre de su transmisión de vídeo de Kinesis

  • Modo de reproducción: el modo de reproducción HLS (LIVE, LIVE_REPLAY u ON_DEMAND)

  • Tipo de selector de fragmentos: el método utilizado para seleccionar fragmentos (SERVER_TIMESTAMP o PRODUCER_TIMESTAMP)

  • Número de fragmento: el número del fragmento inicial (cuando corresponda)

  • Formato del contenedor: el formato del contenedor multimedia (FRAGMENTED_MP4 o MPEG_TS)

La aplicación recupera estos valores de los cuadros de entrada de la página HTML y los usa para crear la solicitud de una sesión de streaming de HLS que se muestra en la página.

Importe el AWS SDK JavaScript para navegadores

En la página web, incluye la siguiente etiqueta de script para importar el AWS SDK de la JavaScript versión 2 al proyecto.

<script src="https://cdnjs.cloudflare.com/ajax/libs/aws-sdk/2.490.0/aws-sdk.min.js"></script>

Para obtener más información, consulte la documentación del AWS SDK. JavaScript

Configure el cliente Kinesis Video Streams

Para acceder a la transmisión de vídeo con HLS, primero cree y configure el cliente Kinesis Video Streams. Consulte Configurar las credenciales en un navegador web para ver otros métodos de autenticación.

const clientConfig = {
    accessKeyId: 'YourAccessKey',
    secretAccessKey: 'YourSecretKey',
    region: 'us-west-2'
};
const kinesisVideoClient = new AWS.KinesisVideo(clientConfig);

La aplicación recupera los valores necesarios de los cuadros de entrada de la página HTML.

Recupere el punto final para la reproducción en HLS

Utilice el cliente de Kinesis Video Streams para invocar la GetDataEndpoint API y recuperar el punto final.

const getDataEndpointOptions = {
    StreamName: 'YourStreamName',
    APIName: 'GET_HLS_STREAMING_SESSION_URL'
};
const getDataEndpointResponse = await kinesisVideoClient
    .getDataEndpoint(getDataEndpointOptions)
    .promise();
const hlsDataEndpoint = getDataEndpointResponse.DataEndpoint;

Este código almacena el punto final en la hlsDataEndpoint variable.

Configure el cliente multimedia archivado de Kinesis Video Streams

En la configuración del cliente para el cliente multimedia archivado de Kinesis Video Streams, especifique el punto final que obtuvo en el paso anterior.

const archivedMediaClientConfig = {
    accessKeyId: 'YourAccessKey',
    secretAccessKey: 'YourSecretKey',
    region: 'us-west-2',
    endpoint: hlsDataEndpoint
};
const kinesisVideoArchivedMediaClient = new AWS.KinesisVideoArchivedMedia(archivedMediaClientConfig);

Recupere la URL de la sesión de streaming de HLS

Utilice el cliente multimedia archivado de Kinesis Video Streams para invocar la GetHLSStreamingSessionURL API y recuperar la URL de reproducción de HLS.

const getHLSStreamingSessionURLOptions = {
    StreamName: 'YourStreamName',
    PlaybackMode: 'LIVE'
};
const getHLSStreamingSessionURLResponse = await kinesisVideoArchivedMediaClient
    .getHLSStreamingSessionURL(getHLSStreamingSessionURLOptions)
    .promise();
const hlsUrl = getHLSStreamingSessionURLResponse.HLSStreamingSessionURL;

Muestre la transmisión de HLS en la página web

Cuando tenga la URL de la sesión de streaming HLS, proporciónesela al reproductor de vídeo. El método para proporcionar la URL al reproductor de vídeo es específico del reproductor utilizado.

Video.js

Haga lo siguiente para importar Video.js y sus clases CSS en el script de nuestro navegador:

<link rel="stylesheet" href="https://vjs.zencdn.net/6.6.3/video-js.css">
<script src="https://vjs.zencdn.net/6.6.3/video.js"></script>
<script src="https://cdnjs.cloudflare.com/ajax/libs/videojs-contrib-hls/5.14.1/videojs-contrib-hls.js"></script>

Cree un elemento video HTML para mostrar el vídeo:

<video id="videojs" class="player video-js vjs-default-skin" controls autoplay></video>

Establezca la URL HLS como fuente del elemento de vídeo HTML:

const playerElement = document.getElementById('videojs');
const player = videojs(playerElement);
player.src({
    src: hlsUrl,
    type: 'application/x-mpegURL'
});
player.play();
Shaka

Haga lo siguiente para importar el reproductor Shaka de Google a nuestro script de navegador:

<script src="https://cdnjs.cloudflare.com/ajax/libs/shaka-player/2.4.1/shaka-player.compiled.js"></script>

Crea un elemento video HTML para mostrar el vídeo:

<video id="shaka" class="player" controls autoplay></video>

Crea un reproductor Shaka especificando el elemento de vídeo y llama al método de carga:

const playerElement = document.getElementById('shaka');
const player = new shaka.Player(playerElement);
player.load(hlsUrl);
hls.js

Haz lo siguiente para importar hls.js a la secuencia de comandos de tu navegador:

<script src="https://cdn.jsdelivr.net/npm/hls.js@latest"></script>

Cree un elemento video HTML para mostrar el vídeo:

<video id="hlsjs" class="player" controls autoplay></video>

Cree un reproductor hls.js, asígnele la URL HLS y dígale que se reproduzca:

const playerElement = document.getElementById('hlsjs');
const player = new Hls();
player.loadSource(hlsUrl);
player.attachMedia(playerElement);
player.on(Hls.Events.MANIFEST_PARSED, function() {
    video.play();
});

Solución de problemas de HLS

En esta sección se describen los problemas que pueden surgir al usar HTTP Live Streaming (HLS) con Kinesis Video Streams.

La recuperación de la URL de la sesión de streaming HLS se ha realizado correctamente, pero la reproducción no se puede realizar en el reproductor de vídeo

Esta situación se produce cuando puede recuperar correctamente una URL de una sesión de streaming HLS con GetHLSStreamingSessionURL, pero el vídeo no se reproduce cuando se proporciona la URL a un reproductor de vídeo.

Para solucionar este problema, pruebe lo siguiente:

  • Determine si la transmisión de vídeo se reproduce en la consola de Kinesis Video Streams. Observe los errores que se muestren en la consola.

  • Si la duración del fragmento es inferior a un segundo, auméntela a un segundo. Si la duración del fragmento es demasiado corta, es posible que el servicio limite el rendimiento del reproductor porque solicita fragmentos de vídeo con demasiada frecuencia.

  • Compruebe que la URL de cada sesión de streaming HLS solo la esté utilizando un único reproductor. Si hay más de un reproductor utilizando la URL de una sesión de streaming HLS, el servicio puede recibir demasiadas solicitudes y limitarlas.

  • Comprueba que el reproductor admite todas las opciones que especificas para la sesión de streaming de HLS. Pruebe distintas combinaciones de valores para los parámetros siguientes:

    • ContainerFormat

    • PlaybackMode

    • FragmentSelectorType

    • DiscontinuityMode

    • MaxMediaPlaylistFragmentResults

    Algunos reproductores multimedia (como HTML5 y los reproductores de móviles) normalmente solo admiten HLS con el formato de contenedor fMP4. Es posible que otros reproductores multimedia (como Flash y los reproductores personalizados) solo admitan HLS con el formato contenedor MPEG TS. Se recomienda experimentar con el ContainerFormat parámetro para empezar a solucionar el problema.

  • Verifique que cada fragmento tenga un número coherente de pistas. Comprueba que los fragmentos de la transmisión no cambien entre tener una pista de audio y vídeo y solo una pista de vídeo. Comprueba también que los ajustes del codificador (resolución y velocidad de fotogramas) no cambien entre los fragmentos de cada pista.

Latencia demasiado alta entre el productor y el reproductor

Esta situación se produce cuando hay una latencia demasiado alta entre el momento en que se captura el vídeo y el momento en que se reproduce en el reproductor de vídeo.

El vídeo se reproduce a través de HLS en cada fragmento. Por lo tanto, la latencia no puede ser menor que la duración del fragmento. La latencia también incluye el tiempo necesario para almacenar los datos en el búfer y transferirlos. Si la solución requiere una latencia menor que un segundo, considere la posibilidad de utilizar la API GetMedia en su lugar.

Puede modificar los siguientes parámetros para reducir la latencia global, pero al ajustarlos, también puede reducirse la calidad de vídeo o puede aumentar la frecuencia de repetición de operaciones de almacenamiento en búfer.

  • Duración del fragmento: la duración del fragmento es la cantidad de vídeo entre las divisiones de la transmisión, controlada por la frecuencia de los fotogramas clave generados por el codificador de vídeo. El valor recomendado es de un segundo. Una duración de los fragmentos más breve significa que hay que esperar menos tiempo a que finalice el fragmento antes de transmitir los datos de vídeo al servicio. El servicio también procesa más rápido los fragmentos más cortos. Sin embargo, si la duración del fragmento es demasiado breve, aumenta la probabilidad de que el reproductor se quede sin contenido y tenga que detenerse y almacenar contenido en el búfer. Si la duración del fragmento es inferior a 500 milisegundos, el productor puede crear demasiadas solicitudes, lo que hace que el servicio las limite.

  • Velocidad de bits: una transmisión de vídeo con una velocidad de bits más baja tarda menos tiempo en leerse, escribirse y transmitirse. Sin embargo, una transmisión de vídeo con una tasa de bits inferior normalmente tiene una menor calidad de vídeo.

  • Recuento de fragmentos en las listas de reproducción multimedia: un reproductor sensible a la latencia solo debe cargar los fragmentos más recientes de una lista de reproducción multimedia. En su lugar, la mayoría de los reproductores comienzan con el fragmento más antiguo. Al reducir el número de fragmentos de la lista de reproducción, se reduce la separación de tiempo entre los fragmentos anteriores y los nuevos. Con un tamaño de lista de reproducción más pequeño, es posible omitir un fragmento durante la reproducción si hay un retraso en la adición de nuevos fragmentos a la lista de reproducción o si el reproductor tarda en actualizar la lista de reproducción. Recomendamos usar de 3 a 5 fragmentos y usar un reproductor que esté configurado para cargar solo los fragmentos más recientes de una lista de reproducción.

  • Tamaño del búfer del reproductor: la mayoría de los reproductores de vídeo tienen una duración de búfer mínima configurable, normalmente con un valor predeterminado de 10 segundos. Para obtener la latencia más baja, puede establecer este valor en 0 segundos. Sin embargo, si lo hace, el reproductor rechazará el búfer si hay algún retraso para producir fragmentos, ya que el reproductor no dispondrá de búfer para absorber el retraso.

  • El reproductor se pone al día: los reproductores de vídeo no suelen capturar automáticamente la reproducción en la parte delantera del búfer de vídeo si el búfer se llena, por ejemplo, cuando un fragmento retrasado provoca una acumulación de fragmentos en la reproducción. Un reproductor personalizado puede evitarlo descartando fotogramas o aumentando la velocidad de reproducción (por ejemplo, a 1,1x) para alcanzar el principio del búfer. Esto hace que la reproducción se entrecorte o que aumente de velocidad mientras el reproductor recupera el tiempo perdido, y la repetición de operaciones de almacenamiento en búfer puede ser más frecuente debido a que el tamaño del búfer es pequeño.