このガイドでは、ビデオ オンデマンド（VOD）ストリームにダイナミック広告挿入（DAI）を使用する場合に、IMA DAI SDK を使用してブックマークを実装する方法について説明します。これは、スタートガイドで説明されているような、IMA DAI の実装が機能していることを前提としています。
ブックマークとは
ブックマークは、コンテンツ ストリームのあるポイントを保存し、後でそこから再生する機能です。たとえば、ユーザーが 5 分間のコンテンツを見ているとします。動画ストリーム中に視聴を中断して、後で中断したところから再生を再開できます。ブックマークはユーザーが見ていた場所を保存するので、中断したところに戻ってスムーズに視聴を続けられます。
DAI ブックマークの仕組み
DAI ストリームをブックマークする場合は、ユーザーが動画を離れたときのストリーム ID と時間を記録する必要があります。ユーザーが戻ってきたら、ストリームを再度リクエストし、保存した時間にシークします。リクエストされたストリームの各インスタンスには異なる長さの広告ブレークが含まれる可能性があるため、ストリーム時間を保存するだけでは機能しません。実際には、同じコンテンツ時間から続行したいはずです。
変換メソッドの活用
IMA DAI SDK には、指定されたストリーム時間のコンテンツ時間と、指定されたコンテンツ時間のストリーム時間をリクエストするメソッドのペアが用意されています。これらの変換メソッドを使用すると、ブックマークされたコンテンツ時間を保存し、ストリームの新しいインスタンスで対応するストリーム時間にシークできます。以下に、ブックマークの実装例を示すサンプルアプリへのリンクを含め、そのアプローチを示します。
ブックマークの保存
Activity が一時停止したときにブックマークを保存します。
private double bookmarkTime;
@Override
public void onPause() {
super.onPause();
double streamTime = videoPlayer.getCurrentPosition() / 1000.0; // ms to s.
bookmarkTime = streamManager.getContentTimeForStreamTime(streamTime);
}
ブックマークを読み込んでいます
ストリームを再リクエストするときにブックマークを読み込みます。これは VideoStreamPlayer インターフェースの実装の一部です。
public void loadUrl(String url, List<HashMap<String, String>> subtitles) {
// Set video player's stream URL and subtitles, and play the stream.
...
// Bookmarking.
if (bookmarkTime > 0) {
double streamTime =
streamManager.getStreamTimeForContentTime(bookmarkTime);
videoPlayer.seek((long) (streamTime * 1000.0)); // s to ms.
}
}
サンプルアプリ
サンプルアプリをダウンロードして、ブックマークの実装を確認します。