google. ima. AdPodInfo
広告が連続配信広告の一部になっている可能性がある。このオブジェクトは、Pod 内の広告の数や Pod 内の広告位置など、その Pod に関連するメタデータを公開します。
このオブジェクトに含まれる getTotalAds
API は多くの場合正解ですが、SDK の最適な推測を表す場合があります。詳細については、このメソッドのドキュメントをご覧ください。
Methods
getAdPosition
getAdPosition() は数値を返します
広告の掲載順位を返します。
- 戻り値
-
number
連続配信広告内の広告の位置。返される値は 1 に基づいています(例: 1/2、2/2 など)。
getIsBumper
getIsBumper() がブール値を返す
広告がバンパー広告である場合に true を返します。バンパー広告は、ユーザーが広告ブレークに出入りするタイミングを指定できる短いリニア広告です。
- 戻り値
-
boolean
バンパー広告かどうか。
getMaxDuration
getMaxDuration() は数値を返します
Pod の最大時間(秒単位)。不明な期間については -1 が返されます。
- 戻り値
-
number
この連続配信広告内の広告の最大時間(秒)。
getPodIndex
getPodIndex() は数値を返す
クライアント側と DAI VOD: 連続配信広告のインデックスを返します。プレロール Pod の場合は 0 を返します。ミッドロールの場合、1、2、... を返します。北Postroll Pod の場合は -1 を返します。この広告が連続配信広告に含まれない場合、またはこの連続配信広告が再生リストの一部でない場合はデフォルトで 0 になります。DAI ライブ ストリーム: 常に -1 を返します。
- 戻り値
-
number
広告プレイリスト内の連続配信広告のインデックス。
getTimeOffset
getTimeOffset() は数値を返す
現在の連続配信広告がスケジュール設定された時点でのコンテンツ タイム オフセットを返します。 広告を動的に挿入する VOD ストリームの連続配信広告の場合は、ストリーミング時間が返されます。
プレロール Pod の場合は 0 が返されます。ミッドロールの場合、スケジュール設定された時間が返されます。ポストロールの場合、-1 が返されます。
この広告が連続配信広告の一部でない場合、または連続配信広告が広告の再生リストの一部でない場合は、デフォルトで 0 が使用されます。
- 戻り値
-
number
現在の連続配信広告の時間オフセット。
getTotalAds
getTotalAds() は数値を返します
この連続配信広告に含まれる広告の総数(バンパーを含む)。 バンパー広告は、ユーザーが広告ブレークに出入りするタイミングを指定できる短いリニア広告です。
この広告が連続配信広告に含まれていない場合、デフォルトは 1 です。
場合によっては、この連続配信広告に含まれる広告の数が SDK で認識されません。連続配信広告には、1 つの広告タグ内の複数の広告が含まれます。こうしたシナリオでは、最初に配信された AdEvent の数個(AD_METADATA、LOADED など)で、プレイリスト レスポンスから広告タグの総数が作成される可能性があります。FIRST_QUARTILE イベントは、パブリッシャーがこのオブジェクトから情報を pull し、プレーヤーの視覚要素を更新するイベントとして使用することをおすすめします。
- 戻り値
-
number
連続配信広告内の広告の合計数。