このページは Cloud Translation API によって翻訳されました。

ブックマーク

このガイドでは、ビデオオンデマンド（VOD）ストリームにダイナミック広告挿入（DAI）を使用している場合に、IMA DAI SDK を使用してブックマークを実装する方法について説明します。スタートガイドで紹介したような IMA DAI 実装が機能していることが前提となります。

ブックマークとは

ブックマークは、コンテンツストリーム内の特定の箇所を保存して戻る機能です。ユーザーが 5 分間のコンテンツを視聴した後に動画ストリームを中断し、再び視聴したとします。ブックマーク機能でストリーム内のユーザーの位置が保存されるため、ストリーミングを中断したところから再開でき、視聴者にシームレスなエクスペリエンスを提供できます。

DAI ブックマークの仕組み

DAI ストリームをブックマークする場合は、ユーザーが動画を離れたときのストリーム ID と時間を記録する必要があります。ユーザーが戻ったら、ストリームを再リクエストし、保存された時間までシークします。リクエストされた配信の各インスタンスには、異なる長さの広告ブレークが設定できるため、ストリーミング時間を保存するだけでは機能しません。本当に必要なのは、同じコンテンツ時間から続行することです。

状況を救う変換手法

IMA DAI SDK には、特定のストリーム時間に対するコンテンツ時間と、特定のコンテンツ時間に対するストリーミング時間をリクエストするための 2 つのメソッドが用意されています。これらの変換方法を使用すると、ブックマークしたコンテンツ時間を保存し、ストリームの新しいインスタンスで対応するストリーム時間までシークできます。以下に、ブックマークの実装動作を示すサンプルアプリへのリンクを含むアプローチを示します。

ブックマークを保存しています

アクティビティが一時停止しているときにブックマークを保存します。

Saves the current time as a bookmark in the current video.
Function saveBookmarkTime(player as Object,  streamManager as Object) as Void
  m.videos[player.video.index].bookmarkTime =
      streamManager.getContentTime(player.currentTime * 1000)
End Function

ブックマークを読み込んでいます

ストリームを再リクエストするときにブックマークを読み込みます。これは、VideoStreamPlayer インターフェースの実装の一部です。

player.loadUrl = Function(streamInfo as Object)
  ...
  If m.video.bookmarkTime > 0
    streamTime = m.streamManager.getStreamTime(m.video.bookmarkTime)
    m.videoPlayer.seek(streamTime)
  End If
End Function