O agente New Relic Roku foi projetado para monitorar o comportamento do aplicativo Roku, com foco em eventos relacionados ao sistema e ao vídeo. Ele usa a API de eventos para enviar dados por meio de uma interface REST, suportando cinco tipos de eventos:
- ConnectedDeviceSystem: Sistema de eventos
- VideoAction: Evento de vídeo
- VideoErrorAction: Evento de erro
- VideoAdAction: Anúncio de evento
- VideoCustomAction: evento personalizado
Pré-requisitos
Antes de instalar o agente de Streaming Video & Ads para Roku, certifique-se de ter:
- ID da sua contaNew Relic
- Seu New Relic
- Revisou os requisitos de compatibilidade do agente de Streaming Video & Ads
Instale o agente Roku
Baixe e extraia o pacote
Baixe o pacote Roku Video agente e descompacte-o para acessar a seguinte estrutura de arquivo:
components/NewRelicAgent/ NRAgent.brs NRAgent.xml NRTask.brs NRTask.xmlsource/ NewRelicAgent.brsCopie arquivos para o seu projeto
Copie a pasta NewRelicAgent para o diretório components e o arquivo NewRelicAgent.brs para o diretório source do seu projeto de aplicativo Roku.
Inicialize o agente
Inicialize o agente da New Relic no seu arquivo BrightScript principal (por exemplo, Main.brs):
m.nr = NewRelic("ACCOUNT ID", "LICENSE KEY")Dica
Configuração avançada: Você pode opcionalmente especificar o nome do aplicativo, o token da aplicação, a região do endpoint e o logging:
m.nr = NewRelic("ACCOUNT ID", "LICENSE KEY", "APP NAME", "APPLICATION TOKEN", "US", true)O endpoint padrão é US. Para data centers da UE, use EU.
Habilitar capturas de eventos
O agente de mídia da New Relic para dispositivos Roku captura eventos que ocorrem durante a reprodução de conteúdo de vídeo. Para habilitar a captura automática de eventos, adicione estas chamadas à sua aplicação:
Registrar início da aplicação
Após inicializar o agente, registre o evento de início da aplicação:
nrAppStarted(m.nr, aa)Ativar o rastreamento de sistema e vídeo
Ativar o rastreamento de eventos de sistema e vídeo:
m.syslog = NewRelicSystemStart(m.port)Para rastreamento de vídeo, chame NewRelicVideoStart(m.nr, m.video) no seu componente de cena.
Processar mensagens no loop de espera
Trate os eventos do sistema no seu loop de espera principal:
if nrProcessMessage(m.nr, msg) = false ' Process other messagesend ifExemplo completo
Abaixo está um exemplo completo de integração do agente New Relic em um aplicativo Roku:
Principal.brs
sub Main(aa as Object) screen = CreateObject("roSGScreen") m.port = CreateObject("roMessagePort") screen.setMessagePort(m.port)
'Create the main scene that contains a video player scene = screen.CreateScene("VideoScene") screen.show()
'Init New Relic Agent m.nr = NewRelic("ACCOUNT ID", "LICENSE KEY")
'Send APP_STARTED event nrAppStarted(m.nr, aa)
'Pass NewRelicAgent object to the main scene scene.setField("nr", m.nr)
'Activate system tracking m.syslog = NewRelicSystemStart(m.port)
while (true) msg = wait(0, m.port) if nrProcessMessage(m.nr, msg) = false 'It is not a system message captured by New Relic Agent if type(msg) = "roPosterScreenEvent" if msg.isScreenClosed() exit while end if end if end if end whileend subCena de vídeo.xml
<?xml version="1.0" encoding="utf-8" ?><component name="VideoScene" extends="Scene"> <interface> <!-- Field used to pass the NewRelicAgent object to the scene --> <field id="nr" type="node" onChange="nrRefUpdated" /> </interface>
<children> <Video id="myVideo" translation="[0,0]" /> </children>
<!-- New Relic Agent Interface --> <script type="text/brightscript" uri="pkg:/source/NewRelicAgent.brs"/>
<script type="text/brightscript" uri="pkg:/components/VideoScene.brs"/></component>VideoScene.br
sub init() m.top.setFocus(true) setupVideoPlayer()end sub
function nrRefUpdated() m.nr = m.top.nr
'Activate video tracking NewRelicVideoStart(m.nr, m.video)end function
function setupVideoPlayer() videoUrl = "http://..." videoContent = createObject("RoSGNode", "ContentNode") videoContent.url = videoUrl videoContent.title = "Any Video" m.video = m.top.findNode("myVideo") m.video.content = videoContent m.video.control = "play"end functionQual é o próximo?
Após instalar o agente Roku, explore estes recursos para aproveitar ao máximo o seu monitoramento de streaming de vídeo:
- Referência da API do Roku Agent: Explore a API completa para eventos personalizados, métricas e configuração avançada
- Rastreamento de anúncios para Roku: Configure o monitoramento para eventos de anúncios do RAF e do Google IMA
- Visualize seus dados no New Relic: Explore a telemetria de reprodução de vídeo e anúncios em todas as plataformas