GetClip - Amazon Kinesis Video Streams
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

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 supporti archiviati su richiesta dal flusso video specificato nell'intervallo di tempo specificato.

Entrambi i StreamName e i parametri StreaMarn sono facoltativi, ma è necessario specificare il StreamName o StreamArn quando si richiama questa operazione API.

Come prerequisito per l'utilizzo dell'API GetClip, è necessario ottenere un endpoint utilizzandoGetDataEndpoint, specificando GET_CLIP perloAPINameParametro .

Un flusso video Amazon Kinesis prevede i seguenti requisiti per la visualizzazione di dati tramite MP4:

  • Il supporto deve contenere video con codifica h.264 o h.265 e, facoltativamente, audio con codifica G.711 o AAC. Nello specifico, l'ID codec della traccia 1 deve essere V_MPEG/ISO/AVC (per h.264) o V_MPEGH/ISO/HEVC (per H.265). In alternativa, l'ID codec della traccia 2 deve essere A_AAC (per AAC) o A_MS/ACM (per G.711).

  • 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.

È possibile monitorare la quantità di dati in uscita monitorandoGetClip.OutgoingBytesAmazon CloudWatch metrico. Per ulteriori informazioni sull'uso di CloudWatch per monitorare Kinesis Video Streams, vedereMonitoraggio dei Kinesis Video Streams. Per informazioni sui prezzi, consultaPrezzi di Amazon Kinesis Video StreamseAWS Pricing. Si applicano gli addebiti per i dati AWS in uscita.

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 della clip richiesta e la fonte dei timestamp.

Tipo: ClipFragmentSelector oggetto

campo obbligatorio: Sì

StreamARN

L'Amazon Resource Name (ARN) del flusso per cui recuperare il clip multimediale.

Devi specificare il StreamName o StreamArn.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 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 del flusso per cui recuperare il clip multimediale.

Devi specificare il StreamName o StreamArn.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

campo obbligatorio: No

Sintassi della risposta

HTTP/1.1 200
Content-Type: ContentType

Payload

Elementi 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 del supporto nella clip richiesta.

Vincoli di lunghezza: Lunghezza minima pari a 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 dal flusso video specificato. L'output conterrà i primi 100 MB o i primi 200 frammenti del timestamp iniziale specificato. Per ulteriori informazioni, consultaLimiti per Amazon Kinesis Video Streams.

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 ulteriori informazioni sui limiti, consultaLimiti per Amazon Kinesis Video Streams.

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 codec in almeno una delle tracce del flusso video.

Codice di stato HTTP: 400

NoDataRetentionException

È stata richiesta una sessione di streaming per cui non conservi alcun dato (ovvero contiene unDataRetentionInHoursdi 0).

Codice di stato HTTP: 400

NotAuthorizedException

Codice di stato: 403, Il chiamante non è autorizzato a eseguire un'operazione sul flusso 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 se una sessione con unPlaybackModediON_DEMANDoLIVE_REPLAYè richiesto per uno stream che non ha frammenti nell'intervallo di tempo richiesto o se una sessione con unPlaybackModediLIVEè richiesto per uno stream che non ha 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 ACC o G.711) non può essere determinato dagli ID codec delle tracce nel primo frammento per una sessione di riproduzione. L'ID codec per la traccia 1 dovrebbe essereV_MPEG/ISO/AVCe, facoltativamente, l'ID codec per il brano 2 dovrebbe essereA_AAC.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: