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

Incorporamento di metadati all'interno di un flusso video

I metadati temporizzati di Amazon Interactive Video Service (IVS) forniscono un modo per incorporare i metadati in un flusso Amazon IVS. Assicurano che tutti gli spettatori ricevano i metadati nel flusso video contemporaneamente, indipendentemente dalla latenza dello streaming o dalla posizione geografica.

Che cosa sono i metadati temporizzati?

I metadati temporizzati sono metadati con un timestamp. Possono essere inseriti in un flusso a livello di codice tramite API IVS o SDK di trasmissione IVS. Quando Amazon IVS elabora un flusso, i metadati temporizzati vengono sincronizzati con i fotogrammi audio e video. Durante la riproduzione, tutti gli spettatori dello stream ottengono i metadati contemporaneamente. Il codice temporale funge da punto di partenza e può essere utilizzato per attivare un'azione basata sui dati, ad esempio:

I metadati temporizzati di Amazon IVS utilizzano i tag ID3 incorporati nei segmenti video. Di conseguenza, sono disponibili nel video registrato.

Impostazione delle autorizzazioni IAM

Prerequisito: prima di procedere, devi avere completato Guida introduttiva allo streaming a bassa latenza IVS (inclusa la creazione di un utente IAM e la configurazione delle autorizzazioni).

Successivamente, dovrai concedere all'utente IAM l'autorizzazione per utilizzare i metadati temporizzati. Completa la procedura riportata di seguito.

Inserimento dei metadati temporizzati

È possibile inserire metadati temporizzati solo in un flusso attivo su un canale specificato.

Utilizzo della AWS CLI

A scopo di test, il modo più semplice per aggiungere metadati temporizzati è utilizzare la AWS CLI. L'utilizzo della AWS CLI richiede prima il download e la configurazione della CLI sul computer. Potresti averlo già fatto durante la fase Guida introduttiva allo streaming a bassa latenza IVS; in caso contrario, puoi farlo ora. Per maggiori dettagli, consulta la Guida per l'utente dell'interfaccia a riga di comando di AWS.

Una volta che la CLI è disponibile:

Utilizzo dell'API Amazon IVS

Per inserire i metadati temporizzati a livello di programmazione, utilizza l'endpoint API PutMetadata.

Ecco un esempio di richiesta HTTP:

POST /PutMetadata HTTP/1.1
{
    "channelArn": "my_channel",
    "metadata": "{\"question\": \"What does IVS stand for?\", \"correctIndex\": 0, \"answers\": [\"interactive video service\", \"interesting video service\", \"ingenious video service\"]}"
}

Utilizzo dell'SDK di trasmissione IVS

È possibile inserire metadati temporizzati in banda utilizzando SDK di trasmissione IVS. Può essere utile per sincronizzare i metadati con i contenuti audio e video.

Utilizzo di metadati temporizzati

Utilizza il lettore Amazon IVS per utilizzare metadati temporizzati incorporati in un flusso video. Consulta SDK Amazon IVS Player e il resto della documentazione del lettore.

Di seguito sono riportati alcuni frammenti di esempio che stampano tutti i metadati ricevuti sulla console utilizzando l'SDK del lettore Amazon IVS. Ogni volta che la riproduzione raggiunge un segmento con metadati incorporati viene attivato un evento. (L'evento è TEXT_METADATA_CUE per Web, onCue() per Android e player(_:didOutputCue:) per iOS.) È possibile utilizzare questo evento per avviare funzionalità all'interno dell'applicazione client, ad esempio l'aggiornamento di un widget interattivo. Questo evento viene attivato sia per il contenuto live che per quello registrato.

SDK del lettore Amazon IVS per Web:

const player = IVSPlayer.create();
player.addEventListener(IVSPlayer.PlayerEventType.TEXT_METADATA_CUE,
    function (cue) {
  console.log('Timed metadata: ', cue.text);
});

SDK del lettore Amazon IVS per Android:

@Override
public void onCue(@NonNull Cue cue) {
  if(cue instanceof TextMetadataCue) {
    Log.i("Timed Metadata: ", ((TextMetadataCue)cue).text);
  }
}

SDK del lettore Amazon IVS per iOS:

func player(_ player: IVSPlayer, didOutputCue cue: IVSCue) {
  if let textMetadataCue = cue as? IVSTextMetadataCue {
    print("Timed Metadata: \(textMetadataCue.text)")
  }
}

Nota: i metadati temporizzati sono supportati per iOS Safari e iOS Chrome nel lettore 1.3.0 e versioni successive.

Demo di esempio: App Quiz

Esempi di codice di un'app di quiz interattiva sono disponibili su GitHub. Utilizziamo JSON tramite metadati temporizzati per popolare un'interfaccia utente di quiz per visualizzare domande e risposte. Le risposte sono selezionabili e rivelano se la selezione è corretta.

Visualizzazione dei metadati temporizzati

Se lo desideri, puoi visualizzare i metadati temporizzati incorporati nel live streaming nella console:

Ulteriori informazioni

Consulta Utilizzo dei metadati temporizzati di Amazon Interactive Video Service, la prima di una serie di blog in due parti sull'utilizzo dei metadati temporizzati di Amazon IVS.