• /
  • EnglishEspañolFrançais日本語한국어Português
  • EntrarComeçar agora

Esta tradução de máquina é fornecida para sua comodidade.

Caso haja alguma divergência entre a versão em inglês e a traduzida, a versão em inglês prevalece. Acesse esta página para mais informações.

Criar um problema

Comece com o agente Roku

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.xml
source/
NewRelicAgent.brs

Copie 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 messages
end if

Exemplo 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 while
end sub

Cena 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 function

Qual é 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:

Copyright © 2026 New Relic Inc.

This site is protected by reCAPTCHA and the Google Privacy Policy and Terms of Service apply.