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 MP4 archivo (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 ARN parámetro Stream como el de Stream son opcionales, pero debe especificar el StreamName o el Stream ARN al invocar esta API operación.
nota
Primero debe llamar al 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 datos privados del códec en la codificación de vídeo avanzada (AVC) para los formatos H.264 y HEVC H.265. Para obtener más información, consulte la especificación MPEG -4 /14496-15 ISO
. IEC Para obtener información sobre cómo adaptar los datos de transmisión a un formato determinado, consulte NALAdaptation Flags. -
La pista de audio (si está presente) de cada fragmento debe contener datos privados del códec en el AAC formato (AACespecificaciónISO/IEC13818-7
) o en el 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. CPDno se admiten cambios entre los fragmentos de destino del clip resultante. CPDDeben permanecer coherentes en todos los archivos 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 una pista de AAC audio pasa a ser 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"
}URIParámetros de solicitud
La solicitud no utiliza ningún URI parámetro.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en JSON formato.
- 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 la transmisión StreamName o la transmisiónARN.
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 el clip multimedia.
Debe especificar la transmisión StreamName o la transmisiónARN.
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: ContentType
PayloadElementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta de HTTP 200.
La respuesta devuelve los siguientes HTTP encabezados.
- 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 HTTP cuerpo.
- Payload
-
MP4Archivo 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 Cuotas 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 Cuotas de Kinesis Video Streams.
HTTPCódigo de estado: 400
- InvalidArgumentException
-
Un parámetro específico supera sus restricciones, no se admite o no se puede usar.
HTTPCódigo de estado: 400
- InvalidCodecPrivateDataException
-
Los datos privados del códec en al menos una de las pistas del flujo de vídeo no son válidos para esta operación.
HTTPCódigo de estado: 400
- InvalidMediaFrameException
-
No se pudieron analizar uno o más fotogramas del clip solicitado en función del códec especificado.
HTTPCódigo de estado: 400
- MissingCodecPrivateDataException
-
No se encontraron datos privados del códec en al menos una de las pistas de la transmisión de vídeo.
HTTPCódigo de estado: 400
- NoDataRetentionException
-
GetImagesse solicitó para una transmisión que no retiene datos (es decir, tiene unDataRetentionInHours0).HTTPCódigo de estado: 400
- NotAuthorizedException
-
Código de estado: 403, la persona que llama no está autorizada a realizar ninguna operación en la transmisión determinada o el token ha caducado.
HTTPCódigo de estado: 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.HTTPCódigo de estado: 404
- UnsupportedStreamMediaTypeException
-
No se pudo determinar el tipo de medio (por ejemplo, vídeo h.264 o h.265 AAC o audio G.711) a partir del códec de las pistas IDs 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_AACHTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
