リニア DAI ストリームで時間指定メタデータを処理する

プラットフォームを選択: HTML5 Roku

インタラクティブ メディア広告（IMA）ダイナミック広告挿入 SDK（DAI）は、ストリームのメディア セグメント（インバンド メタデータ）またはストリーミング マニフェスト ファイル（インマニフェスト メタデータ）に埋め込まれたメタデータ情報を使用して、視聴者の位置とクライアントサイドの広告イベントをトラッキングします。メタデータは、再生されるストリームの種類に応じて、さまざまな形式で DAI ストリームから取得できます。IMA DAI SDK は、単一の API を介してすべてのメタデータ形式を処理します。

アプリは、メタデータをキャプチャして IMA DAI SDK に転送する役割を担います。SDK には、この情報を渡す StreamManager.onMessage() メソッドが用意されています。このメソッドは、roVideo ポートによって提供される msg オブジェクトの形式でメタデータを転送します。これらのオブジェクトは IMA DAI SDK によって処理され、広告イベントのタイミングが設定されます。引数は 1 つです。

  • msg: roVideo ポートによって提供される msg タイプ オブジェクト。

メタデータのサンプルコード

roVideo ポートからメタデータを処理し、StreamManager.onMessage() を介して IMA DAI SDK に渡す方法の例を次に示します。

Sub runLoop()
  ' Forward all timed metadata events to IMA.
  m.top.video.timedMetaDataSelectionKeys = ["*"]

  ' Cycle through all the fields and set listeners.
  ' IMPORTANT: Failure to listen to the position and timedmetadata fields could
  ' result in ad impressions not being reported.
  m.port = CreateObject("roMessagePort")
  fields = m.top.video.getFields()
  for each field in fields
    m.top.video.observeField(field, m.port)
  end for

  while True
    msg = wait(1000, m.port)
    if m.top.video = invalid
      print "exiting"
      exit while
    end if

    m.streamManager.onMessage(msg)
    currentTime = m.top.video.position
    If currentTime > 3 And not m.top.adPlaying
       m.top.video.enableTrickPlay = true
    End If
  end while
End Sub

ループ処理ストリーム メタデータをアプリに組み込む方法について詳しくは、IMA Roku スタートガイドをご覧ください。ガイドのイベント リスナーとストリーム開始セクションには、メタデータ処理ループが含まれています。

HLS CMAF ストリーム

Common Media Application Framework（CMAF）を使用するリニア DAI HLS ストリームは、CMAF を介した ID3 標準に沿って、インバンド eMSGv1 ボックスでタイムド メタデータを渡します。これらの eMSG ボックスは各メディア セグメントの先頭に埋め込まれ、各 ID3 eMSG にはストリームの最後の不連続点からの相対的な PTS が含まれます。

IMA Roku の場合、すべての HLS CMAF ストリームは eMSGv0 形式を使用してインバンド ID3 データを送信します。IMA は、eMSGv0 形式で提供される情報と動画オブジェクトの情報を組み合わせます。

HLS CMAF ストリーム ID3 イベントを適切に解析できるようにするには、StreamRequest.videoObject を使用してストリーム リクエストで動画オブジェクトを送信する必要があります。