標準和自訂狀態簡介

我們提供 5 種標準播放器狀態,您也可以新增自訂狀態。

標準狀態名稱
Media SDK 常數
Media Collection API 名稱
全螢幕
ADB.Media.PlayerState.Fullscreen
fullScreen
隱藏式字幕
ADB.Media.PlayerState.ClosedCaptioning
closedCaptioning
靜音
ADB.Media.PlayerState.Mute
mute
子母畫面
ADB.Media.PlayerState.PictureInPicture
pictureInPicture
觀看中
ADB.Media.PlayerState.InFocus
inFocus

標準和自訂狀態的資料計算方式相同,但兩者的資料儲存方式則因 Analytics 報告目的而有所不同。

標準狀態 — 當您從 Analytics 報告 (管理員端) 的「媒體管理」控制台啟用播放器狀態追蹤時,有 15 個解決方案變數可用於報告和資料匯出。

自訂狀態 — 您可以自行建立處理規則,將計算值儲存至自訂事件,然後使用這些規則來報告和匯出資料。

準則

  • 一個視訊工作階段 最多能有 10 個播放器狀態。
  • 可使用任意的狀態組合。
  • 如果傳入了多個播放器狀態,只有前 10 個會保留,並轉送給下游的 VA 處理元件。
  • 10 個狀態的上限適用於所有狀態,無論關閉與否皆然。
  • 狀態可以多次開始和結束,均計為單一狀態。例如,closedCapationing 可以開始和停止五次,但只會計為單一狀態。
  • 超過 10 個允許狀態數上限的狀態會被捨棄。

自訂狀態

您可以建立自訂狀態,在播放工作階段期間擷取自訂動作並更新自訂中繼資料。

如需有關建立自訂狀態的資訊,請參閱媒體 API 參考指南:createStateObject

recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb