Tasti di metadati Roku

I metadati video, audio e degli annunci standard possono essere impostati rispettivamente sugli oggetti multimediali e sulle informazioni degli annunci. Utilizzando le chiavi costanti per i metadati video/ad, impostate il dizionario contenente i metadati standard sull’oggetto info prima di chiamare le API track. Per l’elenco completo delle costanti di metadati standard, consultate le tabelle di seguito, seguite da un esempio.

Costanti di metadati video

Nome metadati	Chiave dati contestuali	Nome costante
Mostra le informazioni	`a.media.show`	`MEDIA_VideoMetadataKeySHOW`
Stagione	`a.media.season`	`MEDIA_VideoMetadataKeySEASON`
Episodio	`a.media.episode`	`MEDIA_VideoMetadataKeyEPISODE`
Risorsa	`a.media.asset`	`MEDIA_VideoMetadataKeyASSET_ID`
Genere	`a.media.genre`	`MEDIA_VideoMetadataKeyGENRE`
Data primo Air	`a.media.airDate`	`MEDIA_VideoMetadataKeyFIRST_AIR_DATE`
Prima data aria digitale	`a.media.digitalDate`	`MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE`
Valutazione	`a.media.rating`	`MEDIA_VideoMetadataKeyRATING`
Creatore	`a.media.originator`	`MEDIA_VideoMetadataKeyORIGINATOR`
Rete	`a.media.network`	`MEDIA_VideoMetadataKeyNETWORK`
Mostra tipo	`a.media.type`	`MEDIA_VideoMetadataKeySHOW_TYPE`
Caricamento annuncio	`a.media.adLoad`	`MEDIA_VideoMetadataKeyAD_LOAD`
MVPD	`a.media.pass.mvpd`	`MEDIA_VideoMetadataKeyMVPD`
Autorizzato	`a.media.pass.auth`	`MEDIA_VideoMetadataKeyAUTHORIZED`
Parte giorno	`a.media.dayPart`	`MEDIA_VideoMetadataKeyDAY_PART`
Feed	`a.media.feed`	`MEDIA_VideoMetadataKeyFEED`
Formato flusso	`a.media.format`	`MEDIA_VideoMetadataKeySTREAM_FORMAT`

Costanti di metadati audio

Nome metadati	Chiave dati contestuali	Nome costante
Artista	`a.media.artist`	`MEDIA_AudioMetadataKeyARTIST`
Album	`a.media.album`	`MEDIA_AudioMetadataKeyALBUM`
Etichetta	`a.media.label`	`MEDIA_AudioMetadataKeyLABEL`
Autore	`a.media.author`	`MEDIA_AudioMetadataKeyAUTHOR`
Stazione	`a.media.station`	`MEDIA_AudioMetadataKeySTATION`
Editore	`a.media.publisher`	`MEDIA_AudioMetadataKeyPUBLISHER`

Aggiungi costanti di metadati

Nome metadati	Chiave dati contestuali	Nome costante
Inserzionista	`a.media.ad.advertiser`	`MEDIA_AdMetadataKeyADVERTISER`
ID campagna	`a.media.ad.campaign`	`MEDIA_AdMetadataKeyCAMPAIGN_ID`
Creative ID	`a.media.ad.creative`	`MEDIA_AdMetadataKeyCREATIVE_ID`
ID posizionamento	`a.media.ad.placement`	`MEDIA_AdMetadataKeyPLACEMENT_ID`
ID sito	`a.media.ad.site`	`MEDIA_AdMetadataKeyPLACEMENT_ID`
URL creativo	`a.media.ad.creativeURL`	`MEDIA_AdMetadataKeyCREATIVE_URL`

Costanti

Per tenere traccia degli eventi multimediali potete usare le seguenti costanti:

Altre costanti

Costante	Descrizione
`ERROR_SOURCE_PLAYER`	Costante per il lettore della fonte di errore

Costanti MediaObject (utilizzate come chiavi nelle istanze MediaObject)

Costante	Descrizione
`MEDIA_STANDARD_MEDIA_METADATA`	Costante per impostare i metadati sul `MediaInfo` `trackLoad`
`MEDIA_STANDARD_AD_METADATA`	Costante per impostare i metadati dell’annuncio sul pannello `EventData` `trackEvent`
`MEDIA_RESUMED`	Costante per l’invio di heartbeat ripreso video. Per riprendere il tracciamento video del contenuto precedentemente interrotto, è necessario impostare la `MEDIA_RESUMED` proprietà sull’ `mediaInfo` oggetto al momento della chiamata `mediaTrackLoad`. (`MEDIA_RESUMED` non è un evento che puoi monitorare utilizzando l’ `mediaTrackEvent` API). `MEDIA_RESUMED` deve essere impostato su true quando un’applicazione desidera continuare a monitorare il contenuto che un utente ha interrotto ma che intende riprendere la visualizzazione. Ad esempio, se un utente guarda il 30% del contenuto, chiude l’app. In questo modo la sessione verrà terminata. In seguito, se lo stesso utente torna allo stesso contenuto e l’applicazione consente all’utente di riprendere dallo stesso punto in cui l’ha interrotto, l’applicazione deve impostare `MEDIA_RESUMED` “true” mentre chiama l’ `mediaTrackLoad` API. Il risultato è che queste due diverse sessioni multimediali per lo stesso contenuto video possono essere collegate tra loro. Esempio di implementazione: `mediaInfo =` `adb_media_init_mediainfo(` `"test_media_name",` `"test_media_id",` `10,` `"vod"` `)` `mediaInfo[ADBMobile().MEDIA_RESUMED] = true` `mediaContextData = {}` `ADBMobile().mediaTrackLoad(mediaInfo, mediaContextData)` In questo modo verrà creata una nuova sessione per il video, ma l’SDK invierà anche una richiesta heartbeat con il tipo di evento “curriculum”, che può essere utilizzato nel reporting per collegare insieme due diverse sessioni multimediali.

Costanti del tipo di contenuto

Costante	Descrizione
`MEDIA_STREAM_TYPE_LIVE`	Costante per tipo di flusso LIVE
`MEDIA_STREAM_TYPE_VOD`	Costante per il tipo di flusso VOD

Costanti del tipo di evento (utilizzate per la chiamata trackEvent)

Costante	Descrizione
`MEDIA_BUFFER_START`	Tipo evento per avvio buffer
`MEDIA_BUFFER_COMPLETE`	Tipo evento per Buffer Complete
`MEDIA_SEEK_START`	Tipo di evento per la ricerca
`MEDIA_SEEK_COMPLETE`	Tipo evento per ricerca completa
`MEDIA_BITRATE_CHANGE`	Tipo evento per modifica bitrate
`MEDIA_CHAPTER_START`	Tipo evento per inizio capitolo
`MEDIA_CHAPTER_COMPLETE`	Tipo evento per il capitolo completo
`MEDIA_CHAPTER_SKIP`	Tipo evento per Ad Start
`MEDIA_AD_BREAK_START`	Tipo evento per Ad Start
`MEDIA_AD_BREAK_COMPLETE`	Tipo evento per AdBreak Complete
`MEDIA_AD_BREAK_SKIP`	Tipo di evento per AdBreak Skip
`MEDIA_AD_START`	Tipo evento per Ad Start
`MEDIA_AD_COMPLETE`	Tipo evento per annuncio completo
`MEDIA_AD_SKIP`	Tipo evento per Salto annuncio