AVFoundationのメディアパフォーマンスメトリックスの紹介

AVFoundationのメディアパフォーマンスメトリックスの紹介

新しいメディアパフォーマンスAPIを使用して、ユーザー体験をモニタリング、分析し、向上させる方法を説明します。さまざまなAVMetricEventsを使用し、AVplayerでHLSアセットを再生する際のパフォーマンスを監視する方法や、これらの指標を使用してプレイヤーのパフォーマンスに関する問題を把握し、対応の優先順位を判断する方法を学ぶことができます。

関連する章
- 0:00 - Introduction
- 1:33 - What are events?
- 5:36 - Subscribing to events
リソース
- Forum: Media Technologies
- - HDビデオ
  - SDビデオ
ダウンロード

こんにちは AVFoundation HLSエンジニアの Nishantです今日は Appleが取り組んできたメディアパフォーマンスメトリックスを収集する新しい方法について紹介します iOS 18ではこれらのメトリックスはイベントとして表されますこのセッションでは様々なイベントのタイプを見たあとアプリがこれらのイベントにサブスクライブする方法を説明しますその前にメディアの再生に関する一般的な問題をいくつか見てみましょう 1つはメディアの再生が開始されるのに時間がかかりすぎるという問題もう1つは途中で再生が停止するという問題です
これらの問題を現場で選別するのは難しいですがクライアント側のメトリックスにアクセスできるなら非常に簡単に行えますそのほかにもクライアント側のメトリックスから AVFoundation APIの動作について情報を得られますこれらはパフォーマンスを理解し改善するのに役立ちます
これまではメディア再生についてクライアント側のメトリックスのいくつかはアクセスログやエラーログ様々なAVPlayer通知を通して得ることができました iOS 18では HLS Streamingアセットの利用可能なメトリックスが強化されデータポイントが追加されていますではメディア再生に問題がある再生セッションを見ながら新しいメトリックスのいくつかを見てみましょうここに15分間のビデオ再生のタイムラインがあります最初の2秒間を拡大すると開始時に何が起こったかがわかります AVPlayerでマルチバリアントプレイリストのフェッチが開始されそれがイベントとしてタイムラインに表示されます
そのあと AVPlayerによりビデオオーディオ字幕のプレイリストがフェッチされますこれらも同様にイベントとしてタイムラインに表示されますメディアプレイリストを使用して AVPlayerによりメディアセグメントと必要なコンテンツキーがフェッチされます AVPlayerによりバッファにデータが十分に溜まったら再生を再開できる状態になりますそれが「likely to keep up」イベントとしてタイムラインに表されていますこのイベントは開始時間と関連プレイリストやメディアセグメントコンテンツキーイベントなど開始に影響を与えた要素についての詳細を提供しますご覧のように開始にほぼ2秒かかっています
開始時間が長いため先行するイベントを見てみましょう開始時間の大半がコンテンツキーのリクエストの待機に費やされていることがわかりますそのため主要なサーバパフォーマンスを向上させるかクライアント側で再生前のキーのプリロードを調べる必要がありますそれにより開始時間を短縮できるかもしれませんクライアント側のメトリックスにより AVFoundationの再生セッション内で何が起きているかわかるようになりました
次に進みましょう途中でメディアの再生が停止するもう1つの問題を見てみましょうタイムラインを拡大すると 7分から8分の部分に停止が発生しています
そのことがイベントとしてタイムラインで表されています
停止する前のイベントを見てみましょう AVPlayerがメディアセグメントをフェッチしていることがわかりますよく見るとビデオメディアセグメントが HTTP 404エラーを返していますそのため20Mbpsから15Mbpsにバリアントが切り替えられています
切り替えのあと新しいバリアントでもビデオメディアセグメントが HTTP 404エラーを返していますこの時点でAVPlayerがバッファ内のデータを使い切り停止に至っています
メディアセグメントイベントへのアクセスにより NSURLSessionTaskのメトリックスを参照できるようになりましたこのためリクエストに失敗した理由についてすべての応答ヘッダやその他のネットワークトランザクションなどさらに詳しく調べられるようになりましたこうした情報やセッション識別子は CDNパートナーと協力するときに問題の絞り込みに役立つかもしれませんクライアント側のメトリックスによりこのように現場で問題を選別できます
さらにセッションを大規模にモニタリングする場合 AVPlayerでは最後にサマリーイベントが作成されますこのイベントではセッションの停止回数や切り替え回数など様々な主要パフォーマンス指標が一目でわかりますこれらのKPIを活用することでメディアの再生状況を大規模に追跡できますここまでをまとめるとプレイリストやメディアセグメントコンテンツキーイベントを確認することで個々のリソースリクエストについての情報を得ることができました停止イベントとバリアント切り替えイベントからはメディアの再生停止とバリアントの切り替えに関する情報を得られました最後に作成されるサマリーイベントでは KPIを確認できましたほかにも AVPlayerItemは再生速度が変化すると速度変更イベントを生成しユーザーによるシーク時にはシークイベントエラー発生時はエラーイベントを生成しますそれではアプリでイベントにサブスクライブして受け取る方法を見ていきましょう iOS 18では AVMetricsと呼ばれる新しいAVFoundation APIが導入されていますこれにより様々な AVFoundationインターフェイスから統一された方法でメトリックスを収集できるようになりましたメディアタイムラインでのイベント発生時にアプリでイベントを受け取ることができますイベントはメディアプレイリストのフェッチなど特定のアクティビティの最後に生成されますパブリッシャー／サブスクライバーモデルに従い興味のあるイベントにのみサブスクライブすることができますそれでは重要ないくつかの概念について見ていきましょうパブリッシャーとはイベント発行に対応する AVFoundationインターフェイスのことで AVMetricEventStreamPublisher プロトコルに準拠していますこのプロトコルでは特定のメトリックスイベントタイプのイベントまたはすべてのメトリックスのイベントの発行をサポートしています iOS 18では AVPlayerItemは AVMetricEventStreamPublisher プロトコルに準拠しておりイベントを発行することができますでは一例を見てみましょうここでは「likely to keep up」と「summary events」に注目しそれらをバックエンドのアナリティクスサーバに報告しますまず「likely to keep up」と「summary events」のAVMetrics非同期シーケンスストリームをグラブします次に時系列にマージしたストリームを作成しますこれにより「likely to keep up」と「summary events」の両方を時系列で効率的に生成することができますイベントを受け取ったらそれらをシリアル化してバックエンドのアナリティクスサーバに送信します
Objective-Cデベロッパの場合は AVMetrics APIが少し異なりますここで AVMetricEventStream インスタンスを作成しサブスクライバーを設定しますそのあと興味のあるイベントにサブスクライブします
次に AVPlayerItemを追加しますこの時点からサブスクライバーはこれらのイベントを受け取り始めます
これらのイベントをシリアル化してバックエンドサーバに送信します以上がアプリでサブスクライブしてクライアント側のメトリックスをバックエンドのアナリティクスサーバに報告する方法ですここまで AVPlayerのクライアント側のメトリックスと様々なイベントタイプを紹介しましたアプリでサブスクライブしてメトリックスを受け取る方法も紹介しました新しいAPIをみなさんのアプリにぜひ導入してみてください機能強化されたクライアント側のアナリティクスが現場での問題の選別に役立ちユーザーのメディア再生パフォーマンスを改善させることを願っていますご視聴ありがとうございました

public protocol AVMetricEventStreamPublisher 
{
	func metrics<MetricType: AVMetricEvent>(forType metricType: MetricType.Type) -> AVMetrics<MetricType>

	func allMetrics() -> AVMetrics<AVMetricEvent>
}

extension AVPlayerItem : AVMetricEventStreamPublisher

6:50 - Example showing how to obtain likely to keep up and summary metrics from AVPlayerItem - Swift

let playerItem : AVPlayerItem = ...
			
let ltkuMetrics = item.metrics(forType: AVMetricPlayerItemLikelyToKeepUpEvent.self)
let summaryMetrics = item.metrics(forType: AVMetricPlayerItemPlaybackSummaryEvent.self)
		
for await (metricEvent, publisher) in ltkuMetrics.chronologicalMerge(with: summaryMetrics) 
{
	// send metricEvent to server
}

7:26 - Example showing how to obtain likely to keep up and summary metrics from AVPlayerItem - Objective-C

AVPlayerItem *item = ...
	
AVMetricEventStream *eventStream = [AVMetricEventStream eventStream];
id<AVMetricEventStreamSubscriber> subscriber = [[MyMetricSubscriber alloc] init];
[eventStream setSubscriber:subscriber queue:mySerialQueue]

[eventStream subscribeToMetricEvent:[AVMetricPlayerItemLikelyToKeepUpEvent class]];
[eventStream subscribeToMetricEvent:[AVMetricPlayerItemPlaybackSummaryEvent class]];

[eventStream addPublisher:item];

特定のトピックをお探しの場合は、上にトピックを入力すると、関連するトピックにすばやく移動できます。

クエリの送信中にエラーが発生しました。インターネット接続を確認して、もう一度お試しください。

関連する章

リソース