GetMedia - Flusso di video Amazon Kinesis

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

GetMedia

Usa questa API per recuperare contenuti multimediali da un flusso video Kinesis. Nella richiesta, identifichi il nome dello stream o Amazon Resource Name (ARN) dello stream e il blocco iniziale. Kinesis Video Streams restituisce quindi un flusso di blocchi ordinati per numero di frammento.

Nota

Devi prima chiamare l'GetDataEndpointAPI per ottenere un endpoint. Quindi invia le GetMedia richieste a questo endpoint utilizzando il parametro --endpoint-url.

Quando si inseriscono dati multimediali (frammenti) in uno stream, Kinesis Video Streams archivia ogni frammento in entrata e i relativi metadati in quello che viene chiamato «blocco». Per ulteriori informazioni PutMedia, consulta. L'GetMediaAPI restituisce un flusso di questi blocchi a partire dal blocco specificato nella richiesta.

I seguenti limiti si applicano quando si utilizza l'API: GetMedia

  • Un client può effettuare chiamate GetMedia fino a cinque volte al secondo per stream.

  • Kinesis Video Streams invia dati multimediali a una velocità massima di 25 megabyte al secondo (o 200 megabit al secondo) durante una sessione. GetMedia

Nota

Il codice di stato della risposta GetMedia HTTP verrà restituito immediatamente, ma la lettura del payload della risposta HTTP scadrà dopo 3 secondi se non ci sono frammenti importati disponibili per la riproduzione.

Nota

Se viene generato un errore dopo aver richiamato un'API multimediale Kinesis Video Streams, oltre al codice di stato HTTP e al corpo della risposta, include le seguenti informazioni:

  • x-amz-ErrorTypeIntestazione HTTP: contiene un tipo di errore più specifico oltre a quello fornito dal codice di stato HTTP.

  • x-amz-RequestIdIntestazione HTTP: se desideri segnalare un problema AWS, il team di supporto può diagnosticare meglio il problema se gli viene fornito il Request Id.

Sia il codice di stato HTTP che l' ErrorType intestazione possono essere utilizzati per prendere decisioni programmatiche sulla possibilità di correggere gli errori e in quali condizioni, oltre a fornire informazioni sulle azioni che il programmatore client potrebbe dover intraprendere per riprovare con successo.

Per ulteriori informazioni, consulta la sezione Errori nella parte inferiore di questo argomento, oltre a Errori comuni.

Sintassi della richiesta

POST /getMedia HTTP/1.1 Content-type: application/json { "StartSelector": { "AfterFragmentNumber": "string", "ContinuationToken": "string", "StartSelectorType": "string", "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.

StartSelector

Identifica il blocco iniziale da ottenere dallo stream specificato.

Tipo: oggetto StartSelector

Campo obbligatorio: sì

StreamARN

L'ARN dello stream da cui desideri ricevere i contenuti multimediali. Se non si specifica ilstreamARN, è necessario specificare ilstreamName.

▬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 video Kinesis da cui desideri ottenere i contenuti multimediali. Se non si specifica ilstreamName, è necessario specificare ilstreamARN.

▬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'operazione riesce, il servizio restituisce una risposta HTTP 200.

La risposta restituisce le seguenti intestazioni HTTP.

ContentType

Il tipo di contenuto del supporto richiesto.

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

Il payload restituito da Kinesis Video Streams è una sequenza di blocchi del flusso specificato. Per ulteriori informazioni sui blocchi, consulta. PutMedia I blocchi che Kinesis Video Streams restituisce nella chiamata includono anche i seguenti tag GetMedia Matroska (MKV) aggiuntivi:

  • AWS_KINESISVIDEO_CONTINUATION_TOKEN (stringa UTF-8) - Nel caso in cui la GetMedia chiamata termini, puoi utilizzare questo token di continuazione nella tua richiesta successiva per ottenere il blocco successivo in cui è terminata l'ultima richiesta.

  • AWS_KINESISVIDEO_MILLIS_BEHIND_NOW (stringa UTF-8) - Le applicazioni client possono utilizzare questo valore di tag per determinare quanto indietro il blocco restituito nella risposta si trova rispetto al blocco più recente dello stream.

  • AWS_KINESISVIDEO_FRAGMENT_NUMBER - Numero di frammento restituito nel blocco.

  • AWS_KINESISVIDEO_SERVER_TIMESTAMP - Timestamp del server del frammento.

  • AWS_KINESISVIDEO_PRODUCER_TIMESTAMP - Timestamp del produttore del frammento.

I seguenti tag saranno presenti se si verifica un errore:

  • AWS_KINESISVIDEO_ERROR_CODE - Descrizione in formato stringa di un errore che ha causato l'interruzione. GetMedia

  • AWS_KINESISVIDEO_ERROR_ID: codice intero dell'errore.

I codici di errore sono i seguenti:

  • 3002 - Errore durante la scrittura sullo stream

  • 4000 - Il frammento richiesto non è stato trovato

  • 4500 - Accesso negato per la chiave KMS dello stream

  • 4501 - La chiave KMS di Stream è disabilitata

  • 4502 - Errore di convalida sulla chiave KMS dello stream

  • 4503 - La chiave KMS specificata nello stream non è disponibile

  • 4504 - Utilizzo non valido della chiave KMS specificata nello stream

  • 4505 - Stato non valido della chiave KMS specificata nello stream

  • 4506 - Impossibile trovare la chiave KMS specificata nello stream

  • 5000 - Errore interno

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.

Codice di stato HTTP: 400

ConnectionLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di connessioni client consentite.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore di questo parametro di input non è valido.

Codice di stato HTTP: 400

InvalidEndpointException

Il chiamante ha utilizzato un endpoint errato per scrivere dati in uno stream. Quando riceve tale eccezione, l'utente deve chiamare GetDataEndpoint con APIName set to PUT_MEDIA e utilizzare l'endpoint from response per richiamare la chiamata successiva. PutMedia

Codice di stato HTTP: 400

NotAuthorizedException

Il chiamante non è autorizzato a eseguire un'operazione sullo stream specificato o il token è scaduto.

Codice di stato HTTP: 401

ResourceNotFoundException

Codice di stato: 404, Lo stream con il nome specificato non esiste.

Codice di stato HTTP: 404

Vedi anche

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