GetClip - Amazon Kinesis Video Streams
Sintassi della richiestaURIParametri della richiestaCorpo 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 MP4 file (clip) contenente i file multimediali su richiesta archiviati dal flusso video specificato nell'intervallo di tempo specificato.

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

Nota

È necessario innanzitutto chiamare il GetDataEndpoint API 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

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 Streams AWS . Si applicano i costi per i dati in uscita AWS .

Importante

I dati privati del codec (CPD) contenuti in ogni frammento contengono informazioni di inizializzazione specifiche del codec, come la frequenza dei fotogrammi, la risoluzione e il profilo di codifica, necessarie per decodificare correttamente il frammento. CPDle modifiche non sono supportate tra i frammenti di destinazione della clip risultante. CPDDevono rimanere coerenti su tutti i supporti interrogati, altrimenti verrà restituito un errore.

Importante

Le modifiche alla traccia non sono supportate. Le tracce devono rimanere coerenti su tutti i file multimediali interrogati. Viene restituito un errore se i frammenti dello stream passano da un formato contenente solo video ad avere sia audio che video, o se una traccia AAC audio viene trasformata in una traccia audio A-Law.

Sintassi della richiesta

POST /getClip HTTP/1.1
Content-type: application/json

{
   "ClipFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "StreamARN": "string",
   "StreamName": "string"
}

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

ClipFragmentSelector

L'intervallo di tempo del clip richiesto e l'origine 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 lo StreamName o lo StreamARN.

Tipo: stringa

Limitazioni 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 dello stream per il quale recuperare il clip multimediale.

È necessario specificare lo StreamName o lo StreamARN.

Tipo: stringa

Limitazioni 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

La risposta restituisce le seguenti HTTP intestazioni.

ContentType

Il tipo di contenuto multimediale nella clip richiesta.

Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

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

La risposta restituisce quanto segue come HTTP corpo.

Payload

MP4File 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 la sezione Quote di 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 informazioni sui limiti, consulta la sezione Quote di Kinesis Video Streams.

HTTPCodice di stato: 400

InvalidArgumentException

Un parametro specificato supera le restrizioni, non è supportato o non può essere utilizzato.

HTTPCodice di stato: 400

InvalidCodecPrivateDataException

I dati privati del codec in almeno una delle tracce del flusso video non sono validi per questa operazione.

HTTPCodice di stato: 400

InvalidMediaFrameException

Impossibile analizzare uno o più fotogrammi nella clip richiesta in base al codec specificato.

HTTPCodice di stato: 400

MissingCodecPrivateDataException

Non è stato trovato alcun dato privato del codec in almeno una delle tracce del flusso video.

HTTPCodice di stato: 400

NoDataRetentionException

GetImagesè stato richiesto per uno stream che non conserva dati (ovvero ha un valore DataRetentionInHours pari a 0).

HTTPCodice di stato: 400

NotAuthorizedException

Codice di stato: 403, il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto.

HTTPCodice di stato: 401

ResourceNotFoundException

GetImagesgenererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato.

GetHLSStreamingSessionURLe GetDASHStreamingSessionURL genera questo errore se LIVE_REPLAY viene richiesta una sessione con un PlaybackMode of ON_DEMAND o per uno stream che non contiene frammenti nell'intervallo di tempo richiesto, o se LIVE viene richiesta una sessione con un PlaybackMode of per uno stream che non contiene frammenti negli ultimi 30 secondi.

HTTPCodice di stato: 404

UnsupportedStreamMediaTypeException

Il tipo di supporto (ad esempio, video h.264 o h.265 o AAC audio G.711) non può essere determinato dal codec IDs delle tracce del primo frammento di una sessione di riproduzione. L'ID del codec per la traccia 1 dovrebbe essere V_MPEG/ISO/AVC e, facoltativamente, l'ID del codec per la traccia 2 dovrebbe essere. A_AAC

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue: