Shaka v4.0.3向けメディアエージェント

このリリースでは、Shaka 4.xとの下位互換性を維持しながら、詳細な再生オブザーバビリティのための3つの新しいビットレートメトリクス、QoE（Quality of Experience）サポート、およびShaka Player 5.xとの互換性を導入しています。

新しいビットレートメトリクス

ストリーミングのパフォーマンスに関するより深いインサイトを提供するため、3つの新しい属性が利用可能になりました：

属性	ソース	説明
`contentManifestBitrate`	`stats.streamBandwidth`	マニフェストで宣言されている合計バリアントビットレート（ビデオ+オーディオ）（Indicated Bitrate）。
`contentMeasuredBitrate`	`stats.estimatedBandwidth`	ShakaのABRアルゴリズムによって測定された推定ネットワーク帯域幅（Observed Bitrate）。
`contentDownloadBitrate`	`(bytesDownloaded × 8) / playTime`	ダウンロードされたすべてのメディアにおける実効ダウンロードスループット。

さらに、contentBitrateは、ビデオとオーディオの合計帯域幅を報告する他のメトリクスと区別するために、track.videoBandwidth（ビデオのみのビットレート）を使用します。

Quality of Experience（QoE）サポート

QoE集計イベントがvideo-core経由でサポートされるようになりました。コンフィグでqoeAggregate: trueを設定して有効にします：

const options = {
  info: {
    beacon: 'xxxxxxxxxx',
    applicationID: 'xxxxxxx',
    licenseKey: 'xxxxxxxxxxx',
  },
  config: {
    qoeAggregate: true,
    qoeIntervalFactor: 2,
  },
};

const tracker = new ShakaTracker(player, options);

以下のKPIは自動的に追跡されます：

KPI	説明
`startupTime`	コンテンツリクエストからコンテンツ開始までの時間(ms)。
`peakBitrate`	再生中に観測された最大`contentBitrate`。
`averageBitrate`	セッション全体の加重平均ビットレート。
`hadStartupFailure`	`true` コンテンツの開始前にコンテンツエラーが発生した場合。
`hadPlaybackFailure`	`true` 再生中にコンテンツエラーが発生した場合。
`totalRebufferingTime`	リバッファリングに費やした合計時間（ms）。
`rebufferingRatio`	総再生時間に占めるリバッファリング時間の割合。
`totalPlaytime`	コンテンツの合計再生時間（ms）。
`numberOfErrors`	セッション中のエラーの総数。

Shaka Player 5.x との互換性

トラッカーは、Shaka Player 4.xおよび5.xの両方に対応するようになりました：

getPlayerVersion() 両方のメジャーバージョンにわたってバージョンを解決します。
onError() Shaka playerエラー（e.detail）とHTML video要素エラー（e.target.error）の両方を処理します。
Shaka 5.x 用にサンプルファイルを更新しました（非推奨のshaka.polyfill.installAll()を削除し、プレーヤーのインスタンス化を更新しました）。

アップグレードガイド

更新するには、以下を実行します：

bash

$npm install @newrelic/video-shaka@4.0.3

QoEを有効にするには、上記のように設定オプションにqoeAggregate: trueを追加します。

依存関係

QoEサポートには、@newrelic/video-core v4.1.1以降が必要です。