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 parametri StreamName e StreamArn sono facoltativi, ma è necessario specificare il StreamName o StreamArn quando si richiama questa operazione API. **Nota** È innanzitutto necessario chiamare l'`GetDataEndpoint`API per ottenere un endpoint. Quindi invia le `GetClip` richieste a questo endpoint utilizzando il parametro [--endpoint-url](https://docs.aws.amazon.com/cli/latest/reference/). Uno stream video di Amazon Kinesis presenta i seguenti requisiti per la fornitura di dati tramite: MP4 + Requisiti [per la riproduzione dei brani video](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/video-playback-requirements.html). + 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, vedere la specifica [MPEG-4](https://www.iso.org/standard/55980.html) 14496-15. ISO/IEC Per informazioni sull'adattamento dei dati di flusso a un dato formato, vedi i [contrassegni di adattamento NAL](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/producer-reference-nal.html). + [La traccia audio (se presente) di ogni frammento deve contenere dati privati del codec in formato AAC ([specifica ISO/IEC AAC 13818-7) o in formato MS Wave](https://www.iso.org/standard/43345.html).](https://www.mmsp.ece.mcgill.ca/Documents/AudioFormats/WAVE/WAVE.html) 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/monitoring.html) Streams. [Per informazioni sui prezzi, consulta Prezzi e prezzi di [Amazon Kinesis Video](https://aws.amazon.com/kinesis/video-streams/pricing/) Streams AWS .](https://aws.amazon.com/pricing/) 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. Le modifiche CPD non sono supportate tra i frammenti di destinazione della clip risultante. Il CPD deve rimanere coerente 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 audio AAC viene sostituita da 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" } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [ClipFragmentSelector](#API_reader_GetClip_RequestSyntax) ** L'intervallo di tempo della clip richiesta e la fonte dei timestamp. Tipo: oggetto [ClipFragmentSelector](API_reader_ClipFragmentSelector.md) Obbligatorio: sì ** [StreamARN](#API_reader_GetClip_RequestSyntax) ** L'Amazon Resource Name (ARN) dello stream per il quale recuperare il clip multimediale. Devi specificare il StreamName o lo StreamArn. Tipo: String 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]+` Obbligatorio: no ** [StreamName](#API_reader_GetClip_RequestSyntax) ** Il nome dello stream per il quale recuperare il clip multimediale. È necessario specificare o StreamName StreamArn. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `[a-zA-Z0-9_.-]+` 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](#API_reader_GetClip_ResponseSyntax) ** 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 corpo HTTP. ** [Payload](#API_reader_GetClip_ResponseSyntax) ** MP4 File 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** 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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/limits.html). 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 valore `DataRetentionInHours` pari 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 ** `GetImages`genererà questo errore quando Kinesis Video Streams non riesce a trovare lo stream specificato. `GetHLSStreamingSessionURL`e `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. 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 dal codec IDs delle tracce nel primo frammento per 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` Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue AWS SDKs specifiche, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesis-video-reader-data-2017-09-30/GetClip) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesis-video-reader-data-2017-09-30/GetClip)