Chaves de metadados do Roku

Os metadados padrão de vídeo, áudio e anúncios podem ser definidos em objetos de informação de mídia e anúncio respectivamente. Usando as chaves de constantes para metadados de vídeo/anúncio, defina o dicionário que contém os metadados padrão em um objeto de informação antes de chamar as APIs de rastreamento. Consulte as tabelas abaixo para obter a lista completa de constantes de metadados padrão, seguida de exemplos.

Constantes de metadados de vídeo

Nome dos metadados	Chave de dados de contexto	Nome da constante
Programa	`a.media.show`	`MEDIA_VideoMetadataKeySHOW`
Temporada	`a.media.season`	`MEDIA_VideoMetadataKeySEASON`
Episódio	`a.media.episode`	`MEDIA_VideoMetadataKeyEPISODE`
Ativo	`a.media.asset`	`MEDIA_VideoMetadataKeyASSET_ID`
Gênero	`a.media.genre`	`MEDIA_VideoMetadataKeyGENRE`
Data da primeira exibição	`a.media.airDate`	`MEDIA_VideoMetadataKeyFIRST_AIR_DATE`
Data da primeira exibição digital	`a.media.digitalDate`	`MEDIA_VideoMetadataKeyFIRST_DIGITAL_DATE`
Classificação	`a.media.rating`	`MEDIA_VideoMetadataKeyRATING`
Originador	`a.media.originator`	`MEDIA_VideoMetadataKeyORIGINATOR`
Rede	`a.media.network`	`MEDIA_VideoMetadataKeyNETWORK`
Mostrar tipo	`a.media.type`	`MEDIA_VideoMetadataKeySHOW_TYPE`
Carregamento do anúncio	`a.media.adLoad`	`MEDIA_VideoMetadataKeyAD_LOAD`
MVPD	`a.media.pass.mvpd`	`MEDIA_VideoMetadataKeyMVPD`
Autorizado	`a.media.pass.auth`	`MEDIA_VideoMetadataKeyAUTHORIZED`
Faixa de horário	`a.media.dayPart`	`MEDIA_VideoMetadataKeyDAY_PART`
Feed	`a.media.feed`	`MEDIA_VideoMetadataKeyFEED`
Formato de transmissão	`a.media.format`	`MEDIA_VideoMetadataKeySTREAM_FORMAT`

Constantes de metadados de áudio

Nome dos metadados	Chave de dados de contexto	Nome da constante
Artista	`a.media.artist`	`MEDIA_AudioMetadataKeyARTIST`
Álbum	`a.media.album`	`MEDIA_AudioMetadataKeyALBUM`
Rótulo	`a.media.label`	`MEDIA_AudioMetadataKeyLABEL`
Autor	`a.media.author`	`MEDIA_AudioMetadataKeyAUTHOR`
Estação	`a.media.station`	`MEDIA_AudioMetadataKeySTATION`
Editor	`a.media.publisher`	`MEDIA_AudioMetadataKeyPUBLISHER`

Constantes de metadados de anúncio

Nome dos metadados	Chave de dados de contexto	Nome da constante
Anunciante	`a.media.ad.advertiser`	`MEDIA_AdMetadataKeyADVERTISER`
ID da campanha	`a.media.ad.campaign`	`MEDIA_AdMetadataKeyCAMPAIGN_ID`
ID de criação	`a.media.ad.creative`	`MEDIA_AdMetadataKeyCREATIVE_ID`
ID de posicionamento	`a.media.ad.placement`	`MEDIA_AdMetadataKeyPLACEMENT_ID`
ID do site	`a.media.ad.site`	`MEDIA_AdMetadataKeyPLACEMENT_ID`
URL da arte	`a.media.ad.creativeURL`	`MEDIA_AdMetadataKeyCREATIVE_URL`

Constantes

Você pode usar as seguintes constantes para rastrear eventos de mídia:

Outras constantes

Constante	Descrição
`ERROR_SOURCE_PLAYER`	Constante para a fonte do erro como Reprodutor

Constantes de MediaObjectkey (usadas como chaves nas instâncias MediaObject)

Constante	Descrição
`MEDIA_STANDARD_MEDIA_METADATA`	Constante para definir metadados no `MediaInfo` `trackLoad`
`MEDIA_STANDARD_AD_METADATA`	Constante para definir os metadados de anúncios no `EventData` `trackEvent`
`MEDIA_RESUMED`	Constante para enviar um heartbeat de vídeo retomada. Para retomar o rastreamento de vídeo de um conteúdo anteriormente interrompido, você precisa definir a propriedade `MEDIA_RESUMED` no objeto `mediaInfo` quando chamar `mediaTrackLoad`. (`MEDIA_RESUMED` não é um evento que você pode rastrear usando a API `mediaTrackEvent`.) `MEDIA_RESUMED` deve ser definido como true quando um aplicativo deseja continuar a rastrear o conteúdo que um usuário parou de assistir, mas que agora pretende retomar. Por exemplo, digamos que um usuário assista 30% do conteúdo e então feche o aplicativo. Isso levará à sessão que está sendo encerrada. Posteriormente, se o usuário retornar ao mesmo conteúdo e o aplicativo permitir que ele retome do ponto em que parou, o aplicativo deverá definir `MEDIA_RESUMED` como “true” enquanto chama a API `mediaTrackLoad`. O resultado é que essas duas sessões de mídia diferentes para o mesmo conteúdo de vídeo podem ser vinculadas. Este é um exemplo de implementação: `mediaInfo =` `adb_media_init_mediainfo(` `"test_media_name",` `"test_media_id",` `10,` `"vod"` `)` `mediaInfo[ADBMobile().MEDIA_RESUMED] = true` `mediaContextData = {}` `ADBMobile().mediaTrackLoad(mediaInfo, mediaContextData)` Isso criará uma nova sessão para o vídeo, mas também fará com que o SDK envie uma solicitação de heartbeat contendo o tipo de evento “retomar”, que pode ser usado nos relatórios para vincular duas sessões de mídia diferentes.

Constantes de tipo de conteúdo

Constante	Descrição
`MEDIA_STREAM_TYPE_LIVE`	Constante para o tipo de fluxo LIVE
`MEDIA_STREAM_TYPE_VOD`	Constante para o tipo de fluxo de VOD

Constantes de tipo de evento (usadas para a chamada trackEvent)

Constante	Descrição
`MEDIA_BUFFER_START`	Tipo de evento para Início do buffer
`MEDIA_BUFFER_COMPLETE`	Tipo de evento para Buffer concluído
`MEDIA_SEEK_START`	Tipo de evento para Início da busca
`MEDIA_SEEK_COMPLETE`	Tipo de evento para Busca concluída
`MEDIA_BITRATE_CHANGE`	Tipo de evento para Alteração na taxa de bits
`MEDIA_CHAPTER_START`	Tipo de evento para Início do capítulo
`MEDIA_CHAPTER_COMPLETE`	Tipo de evento para capítulo concluído
`MEDIA_CHAPTER_SKIP`	Tipo de evento para Início do anúncio
`MEDIA_AD_BREAK_START`	Tipo de evento para Início do anúncio
`MEDIA_AD_BREAK_COMPLETE`	Tipo de evento para AdBreak concluído
`MEDIA_AD_BREAK_SKIP`	Tipo de evento para AdBreak ignorado
`MEDIA_AD_START`	Tipo de evento para Início do anúncio
`MEDIA_AD_COMPLETE`	Tipo de evento para Anúncio concluído
`MEDIA_AD_SKIP`	Tipo de evento para Anúncio ignorado