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.

追加した

• VideoAction/VideoAdActionイベントにcontentIsLive属性を追加し、設定時にVideoノードのcontent.liveフィールドを反映するようにしました — これにより、Rokuは標準のクロスエージェントのビデオデータモデルに準拠します。

修理済み

• ビデオの一時停止中にリバッファリングが完了した場合、再生が再開されるまでCONTENT_BUFFER_ENDが遅延する問題を修正しました。ユーザーが再生を再開したかどうかに関係なく、バッファリングが実際に回復するとすぐにイベントが発生するようになりました — これにより、バッファリング中の一時停止シナリオにおいて過剰に報告されていたバッファリング時間と合計リバッファリング時間が修正されます。
• ハートビートを含むすべてのVideoAction/VideoAdActionイベントにerrorCode/errorMessage/backtraceが付与される問題を修正しました — RokuのVideoノードはエラーがない場合でも（invalidではなく）errorCode: 0を報告するため、エラーではないすべてのイベントでエラー形式の属性が漏洩していました（NR-606648）。これらは実際のエラーイベントにのみ表示されるようになりました。
• 4.2.0での導入以来、MediaTailor SSAIデバッグロギング（nrActivateLogging）がサイレントに抑制されていた問題を修正しました — callFuncを介してnrCheckLoggingState()に渡された余分な引数により、ロギングゲートを評価する代わりに呼び出しがno-opになり、ロギング状態に関係なくMediaTailorのデバッグ出力が生成されることはありませんでした。

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).

新機能

• サポートされるregionの値として"JP"を追加し（"US"、"EU"、および"staging"とともに）、イベント、ログ、メトリクス、およびモバイル・コネクトのトラフィックをNew Relic Japanのコレクターのエンドポイントにルーティングするようにしました。リージョンの照合では大文字と小文字は区別されません（"JP"または"jp"）。

バグ修正

• ハーベスト間で4.2.1で追加されたKPI（avgDownloadRate、minDownloadRate、maxDownloadRate、totalSwitchUps、totalSwitchDowns、totalPauseTime、totalRenditions）のみが変更されるたびに、最初のイベント以降にQOE_AGGREGATEイベントが送信されなくなるダーティ・チェックのギャップを修正しました — これは、totalPauseTimeが唯一変動し続けている値である長い一時停止中に最も顕著でした。

メモ

• QOE_AGGREGATEイベントとその内部トラッキング（rendition-switch-down interval accumulation）からtotalTimeSwitchedDownを削除しました。

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

新機能

• RokuのRAFX_SSAIawsemtアダプターを介したAWS Elemental MediaTailorサーバーサイド広告挿入のネイティブサポートを追加しました
• MediaTailor 広告ライフサイクルイベントの自動VideoAdAction記録を追加しました：AD_BREAK_START、AD_REQUEST、AD_START、AD_QUARTILE、AD_END、AD_BREAK_END、および AD_ERROR
• 1回の呼び出しでRAFX_SSAIアダプターにNew Relicリスナーを登録するためのnrEnableMediaTailorTracking(nr, adIface)を追加しました
• VideoAdActionイベントにサイドカーのキーの値メタデータを注入するためにnrSetMediaTailorAdMetadata(tracker, metadata)を追加しました
• 任意のトラッカーからVideoAdActionを直接記録するためのnrSendVideoAdEvent(nr, actionName, attr)を追加しました
• 推奨されるインテグレーションパターンを示すMediaTailorTask.brsリファレンスタスクとVideoScene.brsサンプルを追加しました

アップデート

• RAFXリスナーとの互換性のためにシーンスレッドでMediaTailorTrackerを作成し、ノードフィールド経由でタスクに渡しました
• RAFX_SSAI.requestStream()経由でセッションを初期化しました；getStreamInfo().manifest_urlからのスティッチされたマニフェストURLをVideoノードに割り当てました
• 広告ブレークのタイミングの解決のため、タスクのイベントループにVideoノードのpositionフィールドの監視を追加
• MediaTailorサポートをオプトインとして設定します；nrEnableMediaTailorTrackingが呼び出されたときにのみアクティブになります

バグ修正

• Google IMA広告ライフサイクルイベント（AD_BREAK_START、AD_BREAK_END、AD_START、AD_END、AD_QUARTILE、AD_ERROR）を修正し、次の代わりに正しくVideoAdActionを生成するようにしました 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)

新機能

• 高度なパフォーマンスメトリクスによる包括的なビデオ品質トラッキングのためのQoE分析を追加
• averageBitrate属性を追加：再生全体における時間加重平均ビットレート
• peakBitrate属性を追加しました：再生中に達成された最高ビットレート
• startupTime属性を追加：コンテンツのリクエストから最初のフレームまでの時間（プレロール広告を除く）
• rebufferingRatio属性を追加：再バッファリングに費やされた再生時間の割合
• totalRebufferingTime属性を追加しました：バッファ状態の合計ミリ秒数
• totalPlaytime属性を追加：ミリ秒単位の合計コンテンツ再生時間
• hadStartupError属性を追加：コンテンツの開始前にスタートアップが失敗したかどうかを示すブール値
• hadPlaybackError属性を追加：セッション中に再生エラーが発生したかどうかを示すブール値
• QoEトラッキングを有効にするためにnrActivateQoeTracking(nr)を追加しました（デフォルトでは無効）
• イベント頻度を設定するためのnrSetQoeAggregateIntervalMultiplier(nr, multiplier)を追加しました

アップデート

• QoEイベントを収集サイクルと同期
• インテリジェントな重複排除により、冗長なイベントを防止
• セッションごとのメトリクスの分離とクリーンアップを実装しました
• 精度向上のため、時間加重ビットレート計算を実装しました
• 広告時間を除外したスマートな起動時間計算を実装
• デフォルトでQoEトラッキングを無効化；収集乗数を1に設定（収集サイクルごと）