Streaming Video & Ads for others release notesRSS

New features

• Added log levels to activeLogs: pass "INFO", "WARNING" or "ERROR" as a minimum level instead of true. true still enables all logs and false still disables them.
• Added buffer-drop logging: an INFO message when the event buffer reaches 85% full, a WARNING at 90%, and one log line per dropped event with a running drop count.
• Added QOE_AGGREGATE values to the agent log output.

Bug fixes

• Fixed MediaTailor SSAI ad attributes being added to VideoAction events after an ad finished. They are now attached to VideoAdAction events only, and ad-level keys are removed from the agent when each ad ends.
• Fixed MediaTailor SSAI adSrc being empty. It now carries the stream URL.
• Fixed the MediaTailor tracker overriding ad timing and count attributes (timeSinceAdStarted, timeSinceAdBreakBegin, numberOfAds).
• Fixed contentRenditionHeight and contentRenditionWidth always reporting 720x480, 1280x720 or 1920x1080. They are now derived from GetVideoMode(), so they match videoMode (e.g. 2160p gives 2160 x 3840).
• Fixed colliding nrSessionId and viewId values when devices launched in the same second. Session IDs now use GetRandomUUID(), and nrVideoCounter is no longer reset on each NewRelicVideoStart().

Added

• Added contentIsLive attribute to VideoAction/VideoAdAction events, reflecting the Video node's content.live field when set — brings Roku in line with the standard cross-agent video data model.

Fixed

• Fixed CONTENT_BUFFER_END being delayed until playback resumed when a rebuffer completed while the video was paused. The event now fires as soon as buffering actually recovers, independent of whether the user has resumed playback — correcting over-reported buffering duration and total rebuffering time for pause-during-buffer scenarios.
• Fixed errorCode/errorMessage/backtrace being stamped onto every VideoAction/VideoAdAction event, including heartbeats — Roku's Video node reports errorCode: 0 (not invalid) even absent an error, so every non-error event was leaking error-shaped attributes (NR-606648). These now only appear on actual error events.
• Fixed MediaTailor SSAI debug logging (nrActivateLogging) being silently suppressed since its introduction in 4.2.0 — an extra argument passed to nrCheckLoggingState() via callFunc caused the call to no-op instead of evaluating the logging gate, so no MediaTailor debug output was ever produced regardless of logging state.

Adicionado

• Adicionado o atributo contentIsLive aos eventos VideoAction/VideoAdAction, refletindo o campo content.live do nó Video quando definido — alinha o Roku com o modelo de dados de vídeo padrão entre agentes.

Fixo

• Corrigido o atraso de CONTENT_BUFFER_END até a retomada da reprodução quando um rebuffer era concluído enquanto o vídeo estava pausado. O evento agora é acionado assim que o armazenamento em buffer realmente se recupera, independentemente de o usuário ter retomado a reprodução — corrigindo a duração do armazenamento em buffer e o tempo total de rebuffer relatados em excesso para cenários de pausa durante o buffer.
• Corrigida a marcação de errorCode/errorMessage/backtrace em cada evento VideoAction/VideoAdAction, incluindo heartbeats — o nó Video do Roku relata errorCode: 0 (não invalid) mesmo na ausência de um erro, de modo que cada evento sem erro estava vazando atributos em forma de erro (NR-606648). Estes agora aparecem apenas em eventos de erro reais.
• Corrigida a supressão silenciosa do logging de depuração do MediaTailor SSAI (nrActivateLogging) desde a sua introdução na versão 4.2.0 — um argumento extra passado para nrCheckLoggingState() via callFunc fez com que a chamada resultasse em no-op em vez de avaliar o gate de logging, de modo que nenhuma saída de depuração do MediaTailor foi produzida, independentemente do estado do logging.

New features

• Added "JP" as a supported region value (alongside "US", "EU", and "staging"), routing event, log, metric, and mobile-connect traffic to the New Relic Japan collector endpoints. Region matching is case-insensitive ("JP" or "jp").

Bug fixes

• Fixed a dirty-check gap where QOE_AGGREGATE events stopped being sent after the first one whenever only a KPI added in 4.2.1 (avgDownloadRate, minDownloadRate, maxDownloadRate, totalSwitchUps, totalSwitchDowns, totalPauseTime, totalRenditions) changed between harvests—most noticeable during a long pause, where totalPauseTime was the only value still moving.

Notes

• Removed totalTimeSwitchedDown from the QOE_AGGREGATE event and its internal tracking (rendition-switch-down interval accumulation).

Novo recurso

• Adicionado "JP" como um valor de region suportado (junto com "US", "EU" e "staging"), roteando o tráfego de evento, log, métrica e mobile-connect para os endpoints do coletor do New Relic Japan. A correspondência de região não diferencia maiúsculas de minúsculas ("JP" ou "jp").

Correções de bugs

• Corrigida uma lacuna de dirty-check onde QOE_AGGREGATE eventos paravam de ser enviados após o primeiro sempre que apenas um KPI adicionado na versão 4.2.1 (avgDownloadRate, minDownloadRate, maxDownloadRate, totalSwitchUps, totalSwitchDowns, totalPauseTime, totalRenditions) mudava entre as coletas — mais perceptível durante uma longa pausa, onde totalPauseTime era o único valor ainda em movimento.

Notas

• Removido totalTimeSwitchedDown do evento QOE_AGGREGATE e de seu rastreamento interno (acúmulo de intervalo de rendition-switch-down).

New features

• Added native support for AWS Elemental MediaTailor server-side ad insertion via Roku's RAFX_SSAI awsemt adapter
• Added automatic VideoAdAction recording for MediaTailor ad lifecycle events: AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END, and AD_ERROR
• Added nrEnableMediaTailorTracking(nr, adIface) to register New Relic listeners on a RAFX_SSAI adapter in one call
• Added nrSetMediaTailorAdMetadata(tracker, metadata) to inject sidecar key/value metadata into VideoAdAction events
• Added nrSendVideoAdEvent(nr, actionName, attr) for direct recording of VideoAdAction from any tracker
• Added MediaTailorTask.brs reference task and VideoScene.brs sample demonstrating the recommended integration pattern

Update

• Created MediaTailorTracker in the scene thread and passed to the task via a node field for RAFX listener compatibility
• Initialised session through RAFX_SSAI.requestStream(); assigned stitched manifest URL from getStreamInfo().manifest_url to the Video node
• Added Video node position field observation in the task event loop for ad-break timing resolution
• Set MediaTailor support as opt-in; activates only when nrEnableMediaTailorTracking is called

Bug fixes

• Fixed Google IMA ad lifecycle events (AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR) to correctly produce VideoAdAction instead of VideoAction

Novo recurso

• Adicionado suporte nativo para inserção de anúncios no lado do servidor do AWS Elemental MediaTailor via adaptador RAFX_SSAI awsemt do Roku
• Adicionada gravação automática de VideoAdAction para eventos de ciclo de vida de anúncios do MediaTailor: AD_BREAK_START, AD_REQUEST, AD_START, AD_QUARTILE, AD_END, AD_BREAK_END e AD_ERROR
• Adicionado nrEnableMediaTailorTracking(nr, adIface) para registrar listeners do New Relic em um adaptador RAFX_SSAI em uma chamada
• Adicionado nrSetMediaTailorAdMetadata(tracker, metadata) para injetar metadados de valor principal do sidecar em eventos VideoAdAction
• Adicionado nrSendVideoAdEvent(nr, actionName, attr) para gravação direta de VideoAdAction a partir de qualquer rastreador
• Adicionada a tarefa de referência MediaTailorTask.brs e o exemplo VideoScene.brs demonstrando o padrão de integração recomendado

Atualizar

• Criado MediaTailorTracker na thread da cena e passado para a tarefa via um campo de nó para compatibilidade com o listener RAFX
• Sessão inicializada através de RAFX_SSAI.requestStream(); URL do manifesto costurado de getStreamInfo().manifest_url atribuída ao nó de Vídeo
• Adicionada observação do campo position do nó de vídeo no loop de eventos da tarefa para resolução de tempo do intervalo de anúncios
• Definir o suporte ao MediaTailor como opt-in; ativa apenas quando nrEnableMediaTailorTracking é chamado

Correções de bugs

• Corrigidos os eventos de ciclo de vida de anúncios do Google IMA (AD_BREAK_START, AD_BREAK_END, AD_START, AD_END, AD_QUARTILE, AD_ERROR) para produzir corretamente VideoAdAction em vez de VideoAction

New features

• Added QoE analytics for comprehensive video quality tracking with advanced performance metrics
• Added averageBitrate attribute: time-weighted average bitrate across playback
• Added peakBitrate attribute: highest bitrate achieved during playback
• Added startupTime attribute: time from content request to first frame (excludes pre-roll ads)
• Added rebufferingRatio attribute: percentage of playback time spent rebuffering
• Added totalRebufferingTime attribute: total milliseconds in buffer states
• Added totalPlaytime attribute: total content playback time in milliseconds
• Added hadStartupError attribute: boolean indicating if startup failed before content start
• Added hadPlaybackError attribute: boolean indicating if playback errors occurred during session
• Added nrActivateQoeTracking(nr) to enable QoE tracking (disabled by default)
• Added nrSetQoeAggregateIntervalMultiplier(nr, multiplier) to configure event frequency

Update

• Synchronized QoE events with harvest cycles
• Prevented redundant events through intelligent duplication
• Implemented per-session metric isolation and cleanup
• Implemented time-weighted bitrate calculations for accuracy
• Implemented smart startup time calculation excluding ad time
• Disabled QoE tracking by default; harvest multiplier set to 1 (every harvest cycle)

Novo recurso

• Adicionadas análises de QoE para rastreamento abrangente da qualidade de vídeo com métricas avançadas de desempenho
• Adicionado o atributo averageBitrate: taxa de bits média ponderada pelo tempo ao longo da reprodução
• Adicionado o atributo peakBitrate: maior taxa de bits alcançada durante a reprodução
• Atributo startupTime adicionado: tempo da solicitação de conteúdo até o primeiro frame (exclui anúncios pre-roll)
• Atributo rebufferingRatio adicionado: porcentagem do tempo de reprodução gasto em rebuffering
• Atributo totalRebufferingTime adicionado: total de milissegundos em estados de buffer
• Atributo totalPlaytime adicionado: tempo total de reprodução de conteúdo em milissegundos
• Atributo hadStartupError adicionado: booleano indicando se a inicialização falhou antes do início do conteúdo
• Adicionado o atributo hadPlaybackError: booleano indicando se ocorreram erros de reprodução durante a sessão
• Adicionado nrActivateQoeTracking(nr) para habilitar o rastreamento de QoE (desabilitado por padrão)
• Adicionado nrSetQoeAggregateIntervalMultiplier(nr, multiplier) para configurar a frequência de eventos

Atualizar

• Eventos de QoE sincronizados com ciclos de coleta
• Evitou eventos redundantes por meio de duplicação inteligente
• Implementado isolamento e limpeza de métrica por sessão
• Implementados cálculos de taxa de bits ponderada pelo tempo para precisão
• Implementado cálculo inteligente do tempo de inicialização excluindo o tempo de anúncio
• Rastreamento de QoE desativado por padrão; multiplicador de coleta definido como 1 (a cada ciclo de coleta)