GetDASHStreamingSessionURL

Recupera uno streaming adattivo MPEG dinamico su HTTP (DASH) URL per lo stream. È quindi possibile aprirlo URL in un lettore multimediale per visualizzare i contenuti dello streaming.

StreamNameSia i parametri che i StreamARN parametri sono facoltativi, ma è necessario specificare StreamName o il StreamARN quando si richiama questa API operazione.

Uno stream video di Amazon Kinesis presenta i seguenti requisiti per la fornitura di dati tramiteMPEG: DASH

• Requisiti per la riproduzione dei brani video.

• La conservazione dei dati deve essere superiore a 0.

• La traccia video di ogni frammento deve contenere dati privati del codec nei formati Advanced Video Coding (AVC) per il formato H.264 e per il formato H.265. HEVC Per ulteriori informazioni, vedere MPEG -4 specific/14496-15. ISO IEC Per informazioni sull'adattamento dei dati di flusso a un determinato formato, vedere NAL Adaptation Flags.

• La traccia audio (se presente) di ogni frammento deve contenere dati privati del codec nel AAC formato (AACspecificazioneISO/IEC13818-7) o nel formato MS Wave.

La procedura seguente mostra come usare MPEG - DASH con Kinesis Video Streams:

1. Chiama il GetDataEndpoint API per ottenere un endpoint. Quindi invia le GetDASHStreamingSessionURL richieste a questo endpoint utilizzando il parametro --endpoint-url.

2. Recupera il - usando. MPEG DASH URL GetDASHStreamingSessionURL Kinesis Video Streams MPEG crea DASH una sessione di streaming da utilizzare per accedere ai contenuti di uno stream MPEG utilizzando DASH il protocollo -. GetDASHStreamingSessionURLrestituisce un file autenticato URL (che include un token di sessione crittografato) per il file MPEG - DASH manifest della sessione (la risorsa principale necessaria per lo streaming con MPEG -). DASH

   Nota

   Non condividere o archiviare questo token dove un'entità non autorizzata può accedervi. Il token fornisce l'accesso al contenuto dello stream. Proteggi il token con le stesse misure che usi con le tue AWS credenziali.

   I file multimediali resi disponibili tramite il manifesto sono costituiti solo dallo stream, dall'intervallo di tempo e dal formato richiesti. Nessun altro dato multimediale (come frame esterni alla finestra richiesta o bitrate alternativi) viene reso disponibile.

3. Fornite il file URL (contenente il token di sessione crittografato) per il MPEG DASH manifesto a un lettore multimediale che supporti il protocollo MPEG -DASH. Kinesis Video Streams rende disponibili il frammento di inizializzazione e i frammenti multimediali tramite il manifesto. URL Il frammento di inizializzazione contiene i dati privati del codec per lo stream e altri dati necessari per configurare il decodificatore e il renderer video o audio. I frammenti multimediali contengono fotogrammi video codificati o campioni audio codificati.

4. Il lettore multimediale riceve i metadati e i dati multimediali autenticati URL e richiede lo streaming normale dei metadati e dei dati multimediali. Quando il lettore multimediale richiede dati, richiama le seguenti azioni:

   • GetDASHManifest: Recupera un MPEG DASH manifesto che contiene i metadati per i file multimediali che si desidera riprodurre.

   • GetMP4InitFragment: recupera il frammento di inizializzazione. MP4 Il lettore multimediale in genere carica il frammento di inizializzazione prima di caricare qualsiasi frammento multimediale. Questo frammento contiene gli atomi "fytp" e "moov" e MP4 gli atomi secondari necessari per inizializzare il decoder del lettore multimediale.

     Il frammento di inizializzazione non corrisponde a un frammento in uno stream video Kinesis. Contiene solo i dati privati del codec per lo stream e la rispettiva traccia, necessari al lettore multimediale per decodificare i frame multimediali.

   • GetMP4MediaFragment: MP4 recupera i frammenti multimediali. Questi frammenti contengono gli atomi "" e moof "mdat" e i relativi MP4 atomi secondari, contenenti i frame multimediali del frammento codificato e i relativi timestamp.

     Importante

     Il codec private data (CPD) contenuto in ogni frammento contiene 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 durante una sessione di streaming. CPDDevono rimanere coerenti attraverso i media interrogati.

     Importante

     Le modifiche alla traccia non sono supportate. Le tracce devono rimanere coerenti su tutti i file multimediali interrogati. Lo streaming fallirà 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.

     I dati recuperati con questa azione sono fatturabili. Per maggiori dettagli, consulta la sezione Prezzi.

Nota

Per le restrizioni che si applicano alle DASH sessioni MPEG -, consulta le quote di Kinesis Video Streams.

Puoi monitorare la quantità di dati consumata dal lettore multimediale monitorando la CloudWatch metrica di GetMP4MediaFragment.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 costi sia per le HLS sessioni che per i dati in uscita AWS .

Per ulteriori informazioniHLS, consulta HTTPLive Streaming sul sito Apple Developer.

Importante

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

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

• x-amz-RequestIdHTTPheader: se desideri segnalare un problema al team di supporto, puoi diagnosticare meglio AWS il problema se fornisci il Request Id.

Sia il codice di HTTP stato 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 del client potrebbe dover intraprendere per riprovare con successo.

Per ulteriori informazioni, consultate la sezione Errori nella parte inferiore di questo argomento, nonché Errori comuni.

Sintassi della richiesta

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

{
   "DASHFragmentSelector": { 
      "FragmentSelectorType": "string",
      "TimestampRange": { 
         "EndTimestamp": number,
         "StartTimestamp": number
      }
   },
   "DisplayFragmentNumber": "string",
   "DisplayFragmentTimestamp": "string",
   "Expires": number,
   "MaxManifestFragmentResults": number,
   "PlaybackMode": "string",
   "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.

DASHFragmentSelector

L'intervallo di tempo del frammento richiesto e l'origine dei timestamp.

Questo parametro è obbligatorio se PlaybackMode è o. ON_DEMAND LIVE_REPLAY Questo parametro è facoltativo se lo PlaybackMode è LIVE. Se PlaybackMode sìLIVE, FragmentSelectorType può essere impostato, ma non TimestampRange deve essere impostato. Se PlaybackMode è ON_DEMAND oLIVE_REPLAY, entrambi FragmentSelectorType TimestampRange devono essere impostati.

Tipo: oggetto DASHFragmentSelector

Campo obbligatorio: no

DisplayFragmentNumber

I frammenti vengono identificati nel file manifesto in base al numero di sequenza nella sessione. Se DisplayFragmentNumber è impostato suALWAYS, il numero di frammento di Kinesis Video Streams viene aggiunto a ciascun elemento S nel file manifest con il nome dell'attributo «kvs:fn». Questi numeri di frammento possono essere utilizzati per la registrazione o per essere utilizzati con altri (ad esempio e). APIs GetMedia GetMediaForFragmentList È necessario un lettore DASH multimediale personalizzato MPEG per sfruttare questi attributi personalizzati.

Il valore predefinito è NEVER.

Tipo: stringa

Valori validi: ALWAYS | NEVER

Campo obbligatorio: no

DisplayFragmentTimestamp

In base alla DASH specifica MPEG -, l'ora dell'orologio da parete dei frammenti nel file manifest può essere derivata utilizzando gli attributi presenti nel manifesto stesso. Tuttavia, in genere, MPEG i lettori multimediali DASH compatibili non gestiscono correttamente le lacune nella timeline multimediale. Kinesis Video Streams regola la timeline multimediale nel file manifesto per consentire la riproduzione di contenuti multimediali con discontinuità. Pertanto, l'ora dell'orologio da parete derivata dal file manifest potrebbe essere imprecisa. Se DisplayFragmentTimestamp è impostato suALWAYS, il timestamp preciso del frammento viene aggiunto a ogni elemento S nel file manifest con il nome dell'attributo «kvs:ts». È necessario un lettore DASH multimediale personalizzato MPEG per sfruttare questo attributo personalizzato.

Il valore predefinito è NEVER. In caso DASHFragmentSelector SERVER_TIMESTAMP affermativo, i timestamp saranno i timestamp di inizio del server. Allo stesso modo, quando DASHFragmentSelector è cosìPRODUCER_TIMESTAMP, i timestamp saranno i timestamp di inizio del produttore.

Tipo: stringa

Valori validi: ALWAYS | NEVER

Campo obbligatorio: no

Expires

Il tempo in secondi che manca alla scadenza della sessione richiesta. Questo valore può essere compreso tra 300 (5 minuti) e 43200 (12 ore).

Quando una sessione scade, non è GetMP4MediaFragment possibile effettuare nuove chiamate a GetDashManifestGetMP4InitFragment, o per quella sessione.

Il valore predefinito è 300 (5 minuti).

Tipo: integer

Intervallo valido: valore minimo di 300. valore massimo pari a 43200.

Campo obbligatorio: no

MaxManifestFragmentResults

Il numero massimo di frammenti restituiti nel DASH manifesto MPEG -.

Quando PlaybackMode èLIVE, vengono restituiti i frammenti più recenti fino a questo valore. Quando PlaybackMode èON_DEMAND, vengono restituiti i frammenti più vecchi, fino a questo numero massimo.

Quando c'è un numero maggiore di frammenti disponibili in un DASH manifesto liveMPEG, i lettori video spesso memorizzano il contenuto nel buffer prima di iniziare la riproduzione. L'aumento della dimensione del buffer aumenta la latenza di riproduzione, ma diminuisce la probabilità che si verifichi il rebuffering durante la riproduzione. È consigliabile che un DASH manifesto live contenga MPEG un minimo di 3 frammenti e un massimo di 10 frammenti.

L'impostazione predefinita è 5 frammenti se PlaybackMode è LIVE o e 1.000 se LIVE_REPLAY lo è. PlaybackMode ON_DEMAND

Il valore massimo di 1.000 frammenti corrisponde a più di 16 minuti di video in stream con frammenti di 1 secondo e più di 2 ore e mezza di video in stream con frammenti di 10 secondi.

Tipo: long

Intervallo valido: valore minimo di 1. Valore massimo di 5000.

Campo obbligatorio: no

PlaybackMode

Sia che si tratti di recuperare dati live, replay dal vivo o archiviati su richiesta.

Le caratteristiche dei tre tipi di sessioni includono quanto segue:

• LIVE: Per sessioni di questo tipo, il DASH manifesto MPEG - viene continuamente aggiornato con i frammenti più recenti non appena diventano disponibili. È consigliabile che il lettore multimediale recuperi un nuovo manifesto a intervalli di un secondo. Quando questo tipo di sessione viene riprodotta in un lettore multimediale, l'interfaccia utente in genere visualizza una notifica «live», senza alcun controllo di scorrimento per scegliere la posizione da visualizzare nella finestra di riproduzione.

  Nota

  In LIVE modalità, i frammenti più recenti disponibili sono inclusi in un DASH manifesto MPEG -, anche se c'è uno spazio tra i frammenti (ovvero se manca un frammento). Un intervallo come questo potrebbe causare l'arresto di un lettore multimediale o un salto nella riproduzione. In questa modalità, i frammenti non vengono aggiunti al file MPEG - DASH manifest se sono più vecchi del frammento più recente della playlist. Se il frammento mancante diventa disponibile dopo l'aggiunta di un frammento successivo al manifesto, il frammento più vecchio non viene aggiunto e lo spazio vuoto non viene colmato.

• LIVE_REPLAY: Per le sessioni di questo tipo, il DASH manifesto MPEG - viene aggiornato in modo analogo a come viene aggiornato per la LIVE modalità, tranne per il fatto che inizia includendo i frammenti di una determinata ora di inizio. Invece di aggiungere i frammenti man mano che vengono ingeriti, i frammenti vengono aggiunti man mano che trascorre la durata del frammento successivo. Ad esempio, se i frammenti della sessione durano due secondi, un nuovo frammento viene aggiunto al manifesto ogni due secondi. Questa modalità è utile per poter avviare la riproduzione dal momento in cui viene rilevato un evento e continuare lo streaming live di contenuti multimediali che non sono ancora stati acquisiti al momento della creazione della sessione. Questa modalità è utile anche per lo streaming di contenuti multimediali precedentemente archiviati senza essere limitata dal limite di 1.000 frammenti previsto dalla modalità. ON_DEMAND

• ON_DEMAND: Per sessioni di questo tipo, il DASH manifesto MPEG - contiene tutti i frammenti della sessione, fino al numero specificato in. MaxManifestFragmentResults Il manifesto deve essere recuperato solo una volta per ogni sessione. Quando questo tipo di sessione viene riprodotta in un lettore multimediale, l'interfaccia utente in genere visualizza un controllo a scorrimento per scegliere la posizione da visualizzare nella finestra di riproduzione.

In tutte le modalità di riproduzione, se sì FragmentSelectorTypePRODUCER_TIMESTAMP, e se sono presenti più frammenti con lo stesso timestamp di inizio, il frammento con il numero di frammento maggiore (ovvero il frammento più recente) viene incluso nel file - manifest. MPEG DASH Gli altri frammenti non sono inclusi. I frammenti con timestamp diversi ma con durate sovrapposte sono comunque inclusi nel manifesto -. MPEG DASH Ciò può portare a un comportamento imprevisto nel lettore multimediale.

Il valore predefinito è LIVE.

Tipo: stringa

Valori validi: LIVE | LIVE_REPLAY | ON_DEMAND

Campo obbligatorio: no

StreamARN

L'Amazon Resource Name (ARN) dello stream per il quale recuperare il file MPEG - DASH manifestURL.

Devi specificare il StreamName o ilStreamARN.

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 file MPEG - DASH manifestURL.

È necessario specificare il StreamName o 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: application/json

{
   "DASHStreamingSessionURL": "string"
}

Elementi di risposta

Se l'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal servizio.

DASHStreamingSessionURL

Il URL (contenente il token di sessione) che un lettore multimediale può utilizzare per recuperare il file MPEG - DASH manifest.

Tipo: stringa

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

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:

• Interfaccia a riga di comando AWS

• AWS SDKper. NET

• AWS SDKper C++

• AWS SDKper Go v2

• AWS SDKper Java V2

• AWS SDKper JavaScript V3

• AWS SDKper PHP V3

• AWS SDKper Python

• AWS SDKper Ruby V3