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.
GetClip
Descarga un archivo MP4 (clip) que contiene el contenido multimedia archivado bajo demanda de la transmisión de vídeo especificada durante el intervalo de tiempo especificado.
StreamName Tanto el parámetro StreamArn como el de StreamArn son opcionales, pero debes especificar el StreamArn StreamName o el StreamArn al invocar esta operación de API.
nota
Primero debes llamar a la GetDataEndpoint API para obtener un punto final. A continuación, envíe las GetClip solicitudes a este punto final mediante el parámetro --endpoint-url.
Una transmisión de vídeo de Amazon Kinesis tiene los siguientes requisitos para proporcionar datos a través de MP4:
-
La retención de datos debe ser mayor o igual que 0.
-
La pista de vídeo de cada fragmento debe contener los datos privados del códec en la codificación de vídeo avanzada (AVC) para el formato H.264 y en HEVC para el formato H.265. Para obtener más información, consulte la especificación especificación ISO/IEC 14496-15 para MPEG
. Si desea obtener más información sobre cómo adaptar datos de transmisiones a un determinado formato, consulte Referencia de marcas de adaptación de capa de abstracción de red (NAL). -
La pista de audio (si la hay) de cada fragmento debe contener los datos privados del códec en formato AAC (especificación ISO/IEC 13818-7 para AAC
) o en formato MS Wave .
Puedes monitorizar la cantidad de datos salientes supervisando la CloudWatch métrica de GetClip.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
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. No se admiten cambios de CPD entre los fragmentos de destino del clip resultante. El CPD debe ser coherente en todos los medios consultados; de lo contrario, se devolverá un error.
importante
No se admiten los cambios de seguimiento. Las pistas deben permanecer consistentes en todo el contenido multimedia consultado. Se devuelve un error si los fragmentos de la transmisión pasan de tener solo vídeo a tener audio y vídeo, o si se cambia una pista de audio AAC por una pista de audio A-Law.
Sintaxis de la solicitud
POST /getClip HTTP/1.1
Content-type: application/json
{
"ClipFragmentSelector": {
"FragmentSelectorType": "string",
"TimestampRange": {
"EndTimestamp": number,
"StartTimestamp": number
}
},
"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.
- ClipFragmentSelector
-
El intervalo de tiempo del clip solicitado y el origen de las marcas de tiempo.
Tipo: objeto ClipFragmentSelector
Obligatorio: sí
- StreamARN
-
El nombre del recurso de Amazon (ARN) de la transmisión de la que se va a recuperar el clip multimedia.
Debe especificar el StreamARN StreamName o el StreamARN.
Tipo: string
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 el clip multimedia.
Debe especificar el StreamArn StreamName o el StreamArn.
Tipo: string
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: ContentType
PayloadElementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
La respuesta devuelve los siguientes encabezados HTTP.
- ContentType
-
El tipo de contenido del contenido multimedia del clip solicitado.
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128.
Patrón:
^[a-zA-Z0-9_\.\-]+$
La respuesta devuelve lo siguiente como el cuerpo HTTP.
- Payload
-
Archivo MP4 tradicional que contiene el clip multimedia de la secuencia de vídeo especificada. La salida contendrá los primeros 100 MB o los primeros 200 fragmentos de la marca de tiempo de inicio especificada. Para obtener más información, consulte Límites de Kinesis Video Streams.
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 Límites 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
- InvalidMediaFrameException
-
No se pudieron analizar uno o más fotogramas del clip solicitado en función del códec especificado.
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 valorDataRetentionInHoursde 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.GetHLSStreamingSessionURLyGetDASHStreamingSessionURLarroja este error si una sesión con unPlaybackModedeON_DEMANDoLIVE_REPLAYse solicita una transmisión que no tiene fragmentos en el intervalo de tiempo solicitado, o siLIVEse solicita una sesión con unPlaybackModede 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 de los identificadores de códec de las pistas del primer fragmento de una sesión de reproducción. El ID de códec de la pista 1 debería ser
V_MPEG/ISO/AVCy, opcionalmente, el ID de códec de la pista 2 debería ser.A_AACCó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 AWS SDK específicos del idioma, consulta lo siguiente:
