Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
GetClip
Scarica un file MP4 (clip) contenente i file multimediali su richiesta archiviati dal flusso video specificato nell'intervallo di tempo specificato.
Entrambi i parametri StreamName e StreamArn sono facoltativi, ma è necessario specificare il StreamName o StreamArn quando si richiama questa operazione API.
Nota
È innanzitutto necessario chiamare l'GetDataEndpointAPI per ottenere un endpoint. Quindi invia le GetClip richieste a questo endpoint utilizzando il parametro --endpoint-url.
Uno stream video di Amazon Kinesis presenta i seguenti requisiti per la fornitura di dati tramite MP4:
-
Requisiti per la riproduzione dei brani video.
-
La conservazione dei dati deve essere superiore a 0.
-
La traccia video di ogni frammento deve contenere i dati codec privati in Advanced Video Coding (AVC) per il formato H.264 e HEVC per il formato H.265. Per ulteriori informazioni, consulta Specifica MPEG-4 ISO/IEC 14496-15
. Per informazioni sull'adattamento dei dati di flusso a un dato formato, vedi i contrassegni di adattamento NAL. -
La traccia audio (se presente) di ogni frammento deve contenere dati codec privati in formato AAC (Specifica AAC ISO/IEC 13818-7
) o in formato MS Wave .
Puoi monitorare la quantità di dati in uscita monitorando la CloudWatch metrica di GetClip.OutgoingBytes Amazon. Per informazioni sull'utilizzo per CloudWatch monitorare Kinesis Video Streams, consulta Monitoring Kinesis Video Streams. Per informazioni sui prezzi, consulta Prezzi e prezzi di Amazon Kinesis Video
Sintassi della richiesta
POST /getClip HTTP/1.1
Content-type: application/json
{
"ClipFragmentSelector": {
"FragmentSelectorType": "string",
"TimestampRange": {
"EndTimestamp": number,
"StartTimestamp": number
}
},
"StreamARN": "string",
"StreamName": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- ClipFragmentSelector
-
L'intervallo di tempo del clip richiesto e la fonte dei timestamp.
Tipo: oggetto ClipFragmentSelector
Campo obbligatorio: sì
- StreamARN
-
L'Amazon Resource Name (ARN) dello stream per il quale recuperare il clip multimediale.
Devi specificare il StreamName o lo StreamArn.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 1024 caratteri.
Modello:
arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+Campo obbligatorio: no
- StreamName
-
Il nome dello stream per il quale recuperare il clip multimediale.
È necessario specificare o StreamName StreamArn.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 256 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-Type: ContentType
PayloadElementi di risposta
Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.
La risposta restituisce le seguenti intestazioni HTTP.
- ContentType
-
Il tipo di contenuto multimediale nella clip richiesta.
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 128 caratteri.
Modello:
^[a-zA-Z0-9_\.\-]+$
La risposta restituisce quanto segue come corpo HTTP.
- Payload
-
File MP4 tradizionale che contiene il clip multimediale del flusso video specificato. L'output conterrà i primi 100 MB o i primi 200 frammenti del timestamp di inizio specificato. Per ulteriori informazioni, consulta Kinesis Video Streams Limits.
Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.
- ClientLimitExceededException
-
Kinesis Video Streams ha limitato la richiesta perché hai superato un limite. Prova a effettuare la chiamata più tardi. Per informazioni sui limiti, consulta Kinesis Video Streams Limits.
Codice di stato HTTP: 400
- InvalidArgumentException
-
Un parametro specificato supera le restrizioni, non è supportato o non può essere utilizzato.
Codice di stato HTTP: 400
- InvalidCodecPrivateDataException
-
I dati privati del codec in almeno una delle tracce del flusso video non sono validi per questa operazione.
Codice di stato HTTP: 400
- InvalidMediaFrameException
-
Non è stato possibile analizzare uno o più fotogrammi nella clip richiesta in base al codec specificato.
Codice di stato HTTP: 400
- MissingCodecPrivateDataException
-
Non sono stati trovati dati privati del codec in almeno una delle tracce del flusso video.
Codice di stato HTTP: 400
- NoDataRetentionException
-
GetImagesè stato richiesto per uno stream che non conserva dati (ovvero ha un valoreDataRetentionInHourspari a 0).Codice di stato HTTP: 400
- NotAuthorizedException
-
Codice di stato: 403, il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto.
Codice di stato HTTP: 401
- ResourceNotFoundException
-
GetImagesgenererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato.GetHLSStreamingSessionURLeGetDASHStreamingSessionURLgenera questo errore seLIVE_REPLAYviene richiesta una sessione con unPlaybackModeofON_DEMANDo per uno stream che non contiene frammenti nell'intervallo di tempo richiesto, o seLIVEviene richiesta una sessione con unPlaybackModeof per uno stream che non contiene frammenti negli ultimi 30 secondi.Codice di stato HTTP: 404
- UnsupportedStreamMediaTypeException
-
Il tipo di supporto (ad esempio, video h.264 o h.265 o audio AAC o G.711) non può essere determinato dagli ID dei codec delle tracce nel primo frammento di una sessione di riproduzione. L'ID del codec per la traccia 1 dovrebbe essere
V_MPEG/ISO/AVCe, facoltativamente, l'ID del codec per la traccia 2 dovrebbe essere.A_AACCodice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK specifici della lingua, consulta quanto segue AWS :
