cast.
這是 cast.framework.events 命名空間。
類別
BitrateChangedEvent
cast.framework.events.EventType.BITRATE_CHANGED 事件的事件資料。
BreaksEvent
與廣告插播相關的所有事件資料：cast.framework.events.EventType.BREAK_ENDED、cast.framework.events.EventType.BREAK_STARTED、cast.framework.events.EventType.BREAK_CLIP_ENDED、cast.framework.events.EventType.BREAK_CLIP_LOADING 和 cast.framework.events.EventType.BREAK_CLIP_STARTED
BufferingEvent
cast.framework.events.EventType.BUFFERING 事件的事件資料。
CacheItemEvent
cast.framework.events.EventType.CACHE_HIT 事件或 cast.framework.events.EventType.CACHE_INSERTED 事件的事件資料。
CacheLoadedEvent
cast.framework.events.EventType.CACHE_LOADED 事件的事件資料。
ClipEndedEvent
cast.framework.events.EventType.CLIP_ENDED 事件的事件資料。
CustomStateEvent
cast.framework.events.EventType.CUSTOM_STATE 事件的事件資料。
EmsgEvent
cast.framework.events.EventType.EMSG 事件的事件資料。
ErrorEvent
cast.framework.events.EventType.ERROR 事件的事件資料。
活動
cast.framework.PlayerManager 派發的所有事件的事件資料父類別。
Id3Event
cast.framework.events.EventType.ID3 事件的事件資料。
這裡提供的 ID3 中繼資料採用 ID3 v2 格式。
系統會為 ID3 訊息中的每個影格觸發一個事件。
這個事件「不」包含完整的原始 ID3 訊息。假設 ID3 訊息有下列子區段：
- ID3v2/檔案 ID
- ID3v2 版本
- ID3v2 旗標
- ID3v2 大小
- 影格類型 (即
TXXX) - 影格大小
- 影格標記
- 影格編碼
- 影格說明
- 影格資料
這項活動僅提供 5 (frameType)、9 (frameDescription) 和 10 (segmentData) 道具。
LiveStatusEvent
cast.framework.events.EventType.LIVE_IS_MOVING_WINDOW_CHANGED 事件或 cast.framework.events.EventType.LIVE_ENDED 事件的事件資料。
LoadEvent
與處理載入或預先載入要求相關的所有事件資料。 對播放器所做的變更。
MediaElementEvent
從 MediaElement 轉送的所有事件資料。
MediaFinishedEvent
cast.framework.events.EventType.MEDIA_FINISHED 事件的事件資料。
MediaInformationChangedEvent
cast.framework.events.EventType.MEDIA_INFORMATION_CHANGED 事件的事件資料。
MediaPauseEvent
從 MediaElement 轉送的 pause 事件資料。
MediaStatusEvent
cast.framework.events.EventType.MEDIA_STATUS 事件的事件資料。
RequestEvent
所有事件的事件資料，代表向接收端提出的要求。
SegmentDownloadedEvent
cast.framework.events.EventType.SEGMENT_DOWNLOADED 事件的事件資料。
SessionDataEvent
cast.framework.events.EventType.SESSION_DATA 事件的事件資料。
在 HLS EXT-X-SESSION-DATA 標記觸發，且僅限使用 Shaka Player 時。
TimedMetadataEvent
定時中繼資料事件的事件資料父類別。這與 Id3Event 的不同之處在於，中繼資料會保留在資訊清單中，而不是區隔內部。
TracksChangedEvent
cast.framework.events.EventType.TRACKS_CHANGED 事件的事件資料。
命名空間
category
列舉
DetailedErrorCode
數字
接收端 SDK 指派的代碼，說明發生的錯誤。
值 |
|
|---|---|
|
MEDIA_UNKNOWN |
數字 HTMLMediaElement 擲回錯誤，但 CAF 無法辨識特定錯誤時傳回。 |
|
MEDIA_ABORTED |
數字 使用者代理程式根據使用者要求，中止媒體資源擷取程序時傳回。 |
|
MEDIA_DECODE |
數字 在資源確定可用後，如果解碼媒體資源時發生錯誤，就會傳回這個值。 |
|
MEDIA_NETWORK |
數字 在資源確定可用後，如果網路錯誤導致使用者代理程式停止擷取媒體資源，就會傳回這個值。 |
|
MEDIA_SRC_NOT_SUPPORTED |
數字 當 src 屬性指定的媒體資源不合適時，系統會傳回這個值。 |
|
SOURCE_BUFFER_FAILURE |
數字 無法將來源緩衝區新增至 MediaSource 時傳回。 |
|
MEDIAKEYS_UNKNOWN |
數字 媒體金鑰發生不明錯誤時傳回。 |
|
MEDIAKEYS_NETWORK |
數字 因網路問題導致媒體金鑰失敗時傳回。 |
|
MEDIAKEYS_UNSUPPORTED |
數字 無法建立 MediaKeySession 物件時傳回。 |
|
MEDIAKEYS_WEBCRYPTO |
數字 加密失敗時傳回。 |
|
NETWORK_UNKNOWN |
數字 發生不明網路問題時傳回。 |
|
SEGMENT_NETWORK |
數字 無法下載片段時傳回。 |
|
HLS_NETWORK_MASTER_PLAYLIST |
數字 無法下載 HLS 主要播放清單時傳回。 |
|
HLS_NETWORK_PLAYLIST |
數字 無法下載 HTTP 即時串流播放清單時傳回。 |
|
HLS_NETWORK_NO_KEY_RESPONSE |
數字 無法下載 HLS 金鑰時傳回。 |
|
HLS_NETWORK_KEY_LOAD |
數字 在傳送 HLS 金鑰要求前失敗時傳回。 |
|
HLS_NETWORK_INVALID_SEGMENT |
數字 HLS 區隔無效時傳回。 |
|
HLS_SEGMENT_PARSING |
數字 無法剖析 HLS 區隔時傳回。 |
|
DASH_NETWORK |
數字 處理 DASH 串流時發生不明網路錯誤，就會傳回這個錯誤。 |
|
DASH_NO_INIT |
數字 DASH 串流缺少 init 時傳回。 |
|
SMOOTH_NETWORK |
數字 處理 Smooth 串流時發生不明網路錯誤，就會傳回這個錯誤。 |
|
SMOOTH_NO_MEDIA_DATA |
數字 Smooth 串流缺少媒體資料時傳回。 |
|
MANIFEST_UNKNOWN |
數字 剖析資訊清單時發生不明錯誤。 |
|
HLS_MANIFEST_MASTER |
數字 剖析 HLS 主資訊清單時發生錯誤，就會傳回這個值。 |
|
HLS_MANIFEST_PLAYLIST |
數字 剖析 HLS 播放清單時發生錯誤，就會傳回這個值。 |
|
DASH_MANIFEST_UNKNOWN |
數字 剖析 DASH 資訊清單時發生不明錯誤，就會傳回這個錯誤。 |
|
DASH_MANIFEST_NO_PERIODS |
數字 DASH 資訊清單缺少時段時傳回。 |
|
DASH_MANIFEST_NO_MIMETYPE |
數字 DASH 資訊清單缺少 MimeType 時，就會傳回這個錯誤。 |
|
DASH_INVALID_SEGMENT_INFO |
數字 DASH 資訊清單含有無效的區隔資訊時，會傳回這個錯誤。 |
|
SMOOTH_MANIFEST |
數字 剖析 Smooth 資訊清單時發生錯誤，就會傳回這個值。 |
|
SEGMENT_UNKNOWN |
數字 發生不明區隔錯誤時傳回。 |
|
TEXT_UNKNOWN |
數字 文字串流發生不明錯誤。 |
|
應用程式 |
數字 在架構外發生錯誤時傳回 (例如事件處理常式擲回錯誤)。 |
|
BREAK_CLIP_LOADING_ERROR |
數字 在廣告插播片段載入攔截器失敗時傳回。 |
|
BREAK_SEEK_INTERCEPTOR_ERROR |
數字 在廣告插播跳轉攔截器失敗時傳回。 |
|
IMAGE_ERROR |
數字 無法載入圖片時傳回。 |
|
LOAD_INTERRUPTED |
數字 載入作業因卸載作業或其他載入作業而中斷。 |
|
LOAD_FAILED |
數字 載入指令失敗。 |
|
MEDIA_ERROR_MESSAGE |
數字 系統已向寄件者傳送錯誤訊息。 |
|
Generic |
數字 發生不明錯誤時傳回。 |
EndedReason
字串
播放結束的原因。
值 |
|
|---|---|
|
END_OF_STREAM |
字串 目前串流已結束，因此停止播放。 |
|
錯誤 |
字串 發生錯誤，因此播放已結束。 |
|
已停止 |
字串 由於某項操作強制停止目前的串流，因此播放已結束。 |
|
INTERRUPTED |
字串 載入新項目，因此結束播放。 |
|
略過數 |
字串 因略過廣告操作而結束播放。 |
|
BREAK_SWITCH |
字串 因切換拼接廣告插播而結束播放。 |
|
PRELOAD_INTERRUPTED |
字串 現有的預先載入播放器遭到中斷或取代，因此播放作業已結束。這可區分預先載入取消和主動播放器取消 (STOPPED)。 |
|
LOAD_CANCELLED |
字串 並行載入要求在完成前取消，因此播放作業已結束。這可區分待處理的載入取消作業和進行中的串流中斷作業 (INTERRUPTED)。 |
|
SENDER_STOPPED |
字串 播放作業已結束，因為傳送端發出明確的 STOP 要求。這項資訊比一般 STOPPED 原因更精細。 |
|
LOAD_INTERRUPTED |
字串 播放作業結束，因為新的媒體載入作業中斷了使用中的播放器。這比使用中的串流一般 INTERRUPTED 原因更精細。 |
|
BREAK_INTERRUPTED |
字串 插播播放器中斷 (例如透過跳轉略過廣告插播)，因此播放結束。這可區分廣告插播中斷和標準媒體中斷 (INTERRUPTED)。 |
|
BREAK_RESOLVED |
字串 插播播放器已成功解析主要內容時間長度，因此播放已結束。這與一般廣告邊界切換 (BREAK_SWITCH) 不同。 |
ErrorSeverity
數字
錯誤嚴重程度。採用與 Shaka Player 相同的命名配置和編號。
值 |
|
|---|---|
|
不明 |
數字 不明錯誤嚴重程度。 |
|
RECOVERABLE |
數字 發生錯誤，但播放器正在嘗試從錯誤中復原。 如果播放器最終無法復原，可能仍不會擲回 CRITICAL 錯誤。舉例來說，重試媒體片段絕不會導致 CRITICAL 錯誤 (播放器會持續重試)。 |
|
嚴重 |
數字 播放器無法復原的重大錯誤。這些會導致播放器停止播放目前的媒體項目。 |
EventType
字串
播放器事件類型。如要進一步瞭解從 MediaElement 代理的事件，請參閱 https://dev.w3.org/html5/spec-preview/media-elements.html#mediaevents。
值 |
|
|---|---|
|
全部 |
字串 這是一種特殊 ID，可用於監聽所有事件 (主要用於偵錯)。事件會是 cast.framework.events.Event 的子類別。 |
|
中止 |
字串 瀏覽器在媒體完全下載前停止擷取媒體時觸發，但不是因為發生錯誤。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
CAN_PLAY |
字串 瀏覽器可以繼續播放短片，但預估載入的資料不足，無法在不停止緩衝的情況下播放短片，直到結束為止。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
CAN_PLAY_THROUGH |
字串 當瀏覽器預估可以播放短片至結束，而不會因緩衝處理而停止時，就會觸發。請注意，瀏覽器預估值僅與目前播放的短片有關 (也就是說，如果目前播放的是廣告短片，瀏覽器只會預估廣告短片，而不會預估完整內容)。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
DURATION_CHANGE |
字串 MediaElement 的 duration 屬性變更時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
EMPTIED |
字串 媒體內容清空時觸發。舉例來說，呼叫 load() 重設 MediaElement 時，就會發生這種情況。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
已結束 |
字串 媒體片段播放完畢時觸發。這不包括短片因錯誤或停止要求而停止播放的情況。如果廣告存在，則每個廣告最多觸發一次，主要內容最多觸發一次。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。如要瞭解媒體何時播放完畢，建議您使用 |
|
LOADED_DATA |
字串 瀏覽器載入媒體剪輯片段的第一個影格後，就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
LOADED_METADATA |
字串 瀏覽器載入短片的中繼資料後，就會觸發這個事件。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
LOAD_START |
字串 瀏覽器開始尋找剪輯片段的媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 在播放暫停時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaPauseEvent 中。 |
|
玩樂 |
字串 在播放準備開始時 (例如暫停後) 觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
播放中 |
字串 在播放開始時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
進度 |
字串 在瀏覽器擷取媒體資料時觸發。如果您使用自動調整位元率串流 (例如 HLS、DASH、SMOOTH)，建議改用 |
|
RATE_CHANGE |
字串 播放速率更新時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
SEEKED |
字串 跳轉完成時觸發。如果媒體暫停時跳轉結束，則不會觸發此事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
尋求 |
字串 在媒體跳轉時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
STALLED |
字串 瀏覽器嘗試擷取媒體資料，但未收到回應時觸發。
|
|
TIME_UPDATE |
字串 媒體播放期間會定期觸發。每當 currentTime 屬性變更時，系統就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 瀏覽器刻意不擷取媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
待執行 |
字串 瀏覽器等待下一個影格可用而停止播放時，就會觸發這個事件。 |
|
BITRATE_CHANGED |
字串 播放媒體的位元率變更時 (例如變更有效音軌，或因應網路狀況選擇不同的位元率)，就會觸發這個事件。事件為 cast.framework.events.BitrateChangedEvent。 |
|
BREAK_STARTED |
字串 在廣告插播中的第一個廣告片段開始載入時觸發。 事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_ENDED |
字串 在廣告插播中的最後一個廣告插播片段結束時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_LOADING |
字串 在廣告插播片段開始載入時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_STARTED |
字串 在廣告插播片段開始時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_ENDED |
字串 在插播片段結束時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
緩衝處理中 |
字串 在播放因緩衝而停止，或緩衝完成後重新開始時觸發。事件為 cast.framework.events.BufferingEvent。 |
|
TIME_DRIFTED |
字串 當播放器回報的目前時間，與根據播放器狀態和播放速率估算的目前時間不符時，就會觸發這個事件。事件為 cast.framework.events.TimeDriftedEvent。 |
|
CACHE_LOADED |
字串 Fastplay 預先快取的內容載入完成時，就會觸發這個事件。事件為 cast.framework.events.CacheLoadedEvent。 |
|
CACHE_HIT |
字串 使用 FastPlay 預先快取的內容時，系統會觸發這個事件。事件為 cast.framework.events.CacheItemEvent。 |
|
CACHE_INSERTED |
字串 Fastplay 快取單一網址時觸發。事件為 cast.framework.events.CacheItemEvent。 |
|
CLIP_STARTED |
字串 任何剪輯片段首次開始播放時觸發。包括廣告插播片段，以及廣告插播片段之間的主要內容片段。如要查看廣告插播片段的開始時間，請使用 Event is a {@link cast.framework.events.Event。 |
|
CLIP_ENDED |
字串 任何剪輯片段結束時觸發。包括插播片段和插播片段之間的主要內容片段。如要查看廣告插播片段何時結束，請使用 |
|
EMSG |
字串 在區隔中找到 emsg 時觸發。事件為 cast.framework.events.EmsgEvent。 |
|
錯誤 |
字串 發生錯誤時觸發。事件為 cast.framework.events.ErrorEvent。 |
|
ID3 |
字串 遇到 ID3 標記時觸發。這項事件只會針對 HLS 內容觸發。事件為 cast.framework.events.Id3Event。 |
|
MEDIA_STATUS |
字串 在傳送包含目前媒體狀態的外送訊息前觸發。事件為 cast.framework.events.MediaStatusEvent。 |
|
CUSTOM_STATE |
字串 傳送自訂狀態訊息時觸發。 事件為 cast.framework.events.CustomStateEvent。 |
|
MEDIA_INFORMATION_CHANGED |
字串 在播放期間變更媒體資訊時觸發。 例如播放現場直播電台，且曲目中繼資料變更時。事件為 cast.framework.events.MediaInformationChangedEvent |
|
MEDIA_FINISHED |
字串 媒體播放完畢時觸發。包括下列情況：串流中沒有可播放的內容、使用者要求停止，或發生錯誤。如果使用佇列，則每當佇列項目完成時，系統就會觸發這個事件。事件為 cast.framework.events.MediaFinishedEvent。 |
|
PLAYER_PRELOADING |
字串 播放器開始處理預先載入要求時觸發。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_PRELOADING_CANCELLED |
字串 如果播放器取消預先載入，就會觸發這個事件。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_LOAD_COMPLETE |
字串 播放器處理完載入要求並準備播放時，就會觸發這個事件。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_LOADING |
字串 在播放器開始處理載入要求時觸發。由於播放器尚未要求媒體資料，因此這項事件會在 |
|
SEGMENT_DOWNLOADED |
字串 在片段下載完成時觸發。只有在自適應串流內容 (HLS、DASH 或 Smooth) 才會觸發。事件為 cast.framework.events.SegmentDownloadedEvent。 |
|
SESSION_DATA |
字串 使用 Shaka Player 時，系統會針對 HLS EXT-X-SESSION-DATA 標記觸發這個事件。事件為 cast.framework.events.SessionDataEvent。 |
|
REQUEST_GET_STATUS |
字串 收到 |
|
REQUEST_SEEK |
字串 收到 |
|
REQUEST_LOAD |
字串 收到 |
|
REQUEST_PRELOAD |
字串 收到 |
|
REQUEST_STOP |
字串 收到 |
|
REQUEST_PAUSE |
字串 收到 |
|
REQUEST_PRECACHE |
字串 收到 |
|
REQUEST_PLAY |
字串 收到 |
|
REQUEST_SKIP_AD |
字串 收到 |
|
REQUEST_PLAY_AGAIN |
字串 收到 |
|
REQUEST_PLAYBACK_RATE_CHANGE |
字串 收到 |
|
REQUEST_VOLUME_CHANGE |
字串 收到 |
|
REQUEST_EDIT_TRACKS_INFO |
字串 收到 EDIT_TRACKS_INFO 訊息時觸發。事件為 cast.framework.events.RequestEvent。 |
|
REQUEST_EDIT_AUDIO_TRACKS |
字串 收到 EDIT_AUDIO_TRACKS 訊息時觸發。事件為 cast.framework.events.RequestEvent。 |
|
REQUEST_SET_CREDENTIALS |
字串 收到 |
|
REQUEST_LOAD_BY_ENTITY |
字串 收到 |
|
REQUEST_USER_ACTION |
字串 收到 |
|
REQUEST_DISPLAY_STATUS |
字串 收到 |
|
REQUEST_CUSTOM_COMMAND |
字串 收到 |
|
REQUEST_FOCUS_STATE |
字串 收到 |
|
REQUEST_QUEUE_LOAD |
字串 收到 |
|
REQUEST_QUEUE_INSERT |
字串 收到 |
|
REQUEST_QUEUE_UPDATE |
字串 收到 |
|
REQUEST_QUEUE_REMOVE |
字串 收到 |
|
REQUEST_QUEUE_REORDER |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEM_RANGE |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEMS |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEM_IDS |
字串 收到 |
|
TRACKS_CHANGED |
字串 載入完成後，如果可用的音軌有所變更，就會觸發這個事件。 |
|
LIVE_IS_MOVING_WINDOW_CHANGED |
字串 當直播可跳轉範圍 isMovingWindow 變更時，更具體地說，當移動視窗變更為展開視窗時，或反之亦然，就會觸發。事件為 cast.framework.events.LiveStatusEvent。 |
|
LIVE_ENDED |
字串 直播剛結束時觸發。事件為 cast.framework.events.LiveStatusEvent。 |
|
TIMED_METADATA_CHANGED |
字串 在 DASH (EventStream) 或 HLS (EXT-X-DATERANGE) 中找到定時中繼資料時，如果直播內容中出現新的定時中繼資料，系統會在 PLAYER_LOAD_COMPLETE 之後觸發這個事件。事件為 cast.framework.events.TimedMetadataEvent。 |
|
TIMED_METADATA_ENTER |
字串 播放頭進入 DASH 中的時間軸區域或到達 EXT-X-DATERANGE 標記時觸發。事件為 cast.framework.events.TimedMetadataEvent。 |
|
TIMED_METADATA_EXIT |
字串 播放頭在 DASH 中離開時間軸區域，或離開 EXT-X-DATERANGE 標記時觸發。事件為 cast.framework.events.TimedMetadataEvent。 |
屬性
DetailedErrorCode
數字
接收端 SDK 指派的代碼，說明發生的錯誤。
值 |
|
|---|---|
|
MEDIA_UNKNOWN |
數字 HTMLMediaElement 擲回錯誤，但 CAF 無法辨識特定錯誤時傳回。 |
|
MEDIA_ABORTED |
數字 使用者代理程式根據使用者要求，中止媒體資源擷取程序時傳回。 |
|
MEDIA_DECODE |
數字 在資源確定可用後，如果解碼媒體資源時發生錯誤，就會傳回這個值。 |
|
MEDIA_NETWORK |
數字 在資源確定可用後，如果網路錯誤導致使用者代理程式停止擷取媒體資源，就會傳回這個值。 |
|
MEDIA_SRC_NOT_SUPPORTED |
數字 當 src 屬性指定的媒體資源不合適時，系統會傳回這個值。 |
|
SOURCE_BUFFER_FAILURE |
數字 無法將來源緩衝區新增至 MediaSource 時傳回。 |
|
MEDIAKEYS_UNKNOWN |
數字 媒體金鑰發生不明錯誤時傳回。 |
|
MEDIAKEYS_NETWORK |
數字 因網路問題導致媒體金鑰失敗時傳回。 |
|
MEDIAKEYS_UNSUPPORTED |
數字 無法建立 MediaKeySession 物件時傳回。 |
|
MEDIAKEYS_WEBCRYPTO |
數字 加密失敗時傳回。 |
|
NETWORK_UNKNOWN |
數字 發生不明網路問題時傳回。 |
|
SEGMENT_NETWORK |
數字 無法下載片段時傳回。 |
|
HLS_NETWORK_MASTER_PLAYLIST |
數字 無法下載 HLS 主要播放清單時傳回。 |
|
HLS_NETWORK_PLAYLIST |
數字 無法下載 HTTP 即時串流播放清單時傳回。 |
|
HLS_NETWORK_NO_KEY_RESPONSE |
數字 無法下載 HLS 金鑰時傳回。 |
|
HLS_NETWORK_KEY_LOAD |
數字 在傳送 HLS 金鑰要求前失敗時傳回。 |
|
HLS_NETWORK_INVALID_SEGMENT |
數字 HLS 區隔無效時傳回。 |
|
HLS_SEGMENT_PARSING |
數字 無法剖析 HLS 區隔時傳回。 |
|
DASH_NETWORK |
數字 處理 DASH 串流時發生不明網路錯誤，就會傳回這個錯誤。 |
|
DASH_NO_INIT |
數字 DASH 串流缺少 init 時傳回。 |
|
SMOOTH_NETWORK |
數字 處理 Smooth 串流時發生不明網路錯誤，就會傳回這個錯誤。 |
|
SMOOTH_NO_MEDIA_DATA |
數字 Smooth 串流缺少媒體資料時傳回。 |
|
MANIFEST_UNKNOWN |
數字 剖析資訊清單時發生不明錯誤。 |
|
HLS_MANIFEST_MASTER |
數字 剖析 HLS 主資訊清單時發生錯誤，就會傳回這個值。 |
|
HLS_MANIFEST_PLAYLIST |
數字 剖析 HLS 播放清單時發生錯誤，就會傳回這個值。 |
|
DASH_MANIFEST_UNKNOWN |
數字 剖析 DASH 資訊清單時發生不明錯誤，就會傳回這個錯誤。 |
|
DASH_MANIFEST_NO_PERIODS |
數字 DASH 資訊清單缺少時段時傳回。 |
|
DASH_MANIFEST_NO_MIMETYPE |
數字 DASH 資訊清單缺少 MimeType 時，就會傳回這個錯誤。 |
|
DASH_INVALID_SEGMENT_INFO |
數字 DASH 資訊清單含有無效的區隔資訊時，會傳回這個錯誤。 |
|
SMOOTH_MANIFEST |
數字 剖析 Smooth 資訊清單時發生錯誤，就會傳回這個值。 |
|
SEGMENT_UNKNOWN |
數字 發生不明區隔錯誤時傳回。 |
|
TEXT_UNKNOWN |
數字 文字串流發生不明錯誤。 |
|
應用程式 |
數字 在架構外發生錯誤時傳回 (例如事件處理常式擲回錯誤)。 |
|
BREAK_CLIP_LOADING_ERROR |
數字 在廣告插播片段載入攔截器失敗時傳回。 |
|
BREAK_SEEK_INTERCEPTOR_ERROR |
數字 在廣告插播跳轉攔截器失敗時傳回。 |
|
IMAGE_ERROR |
數字 無法載入圖片時傳回。 |
|
LOAD_INTERRUPTED |
數字 載入作業因卸載作業或其他載入作業而中斷。 |
|
LOAD_FAILED |
數字 載入指令失敗。 |
|
MEDIA_ERROR_MESSAGE |
數字 系統已向寄件者傳送錯誤訊息。 |
|
Generic |
數字 發生不明錯誤時傳回。 |
EndedReason
字串
播放結束的原因。
值 |
|
|---|---|
|
END_OF_STREAM |
字串 目前串流已結束，因此停止播放。 |
|
錯誤 |
字串 發生錯誤，因此播放已結束。 |
|
已停止 |
字串 由於某項操作強制停止目前的串流，因此播放已結束。 |
|
INTERRUPTED |
字串 載入新項目，因此結束播放。 |
|
略過數 |
字串 因略過廣告操作而結束播放。 |
|
BREAK_SWITCH |
字串 因切換拼接廣告插播而結束播放。 |
|
PRELOAD_INTERRUPTED |
字串 現有的預先載入播放器遭到中斷或取代，因此播放作業已結束。這可區分預先載入取消和主動播放器取消 (STOPPED)。 |
|
LOAD_CANCELLED |
字串 並行載入要求在完成前取消，因此播放作業已結束。這可區分待處理的載入取消作業和進行中的串流中斷作業 (INTERRUPTED)。 |
|
SENDER_STOPPED |
字串 播放作業已結束，因為傳送端發出明確的 STOP 要求。這項資訊比一般 STOPPED 原因更精細。 |
|
LOAD_INTERRUPTED |
字串 播放作業結束，因為新的媒體載入作業中斷了使用中的播放器。這比使用中的串流一般 INTERRUPTED 原因更精細。 |
|
BREAK_INTERRUPTED |
字串 插播播放器中斷 (例如透過跳轉略過廣告插播)，因此播放結束。這可區分廣告插播中斷和標準媒體中斷 (INTERRUPTED)。 |
|
BREAK_RESOLVED |
字串 插播播放器已成功解析主要內容時間長度，因此播放已結束。這與一般廣告邊界切換 (BREAK_SWITCH) 不同。 |
ErrorSeverity
數字
錯誤嚴重程度。採用與 Shaka Player 相同的命名配置和編號。
值 |
|
|---|---|
|
不明 |
數字 不明錯誤嚴重程度。 |
|
RECOVERABLE |
數字 發生錯誤，但播放器正在嘗試從錯誤中復原。 如果播放器最終無法復原，可能仍不會擲回 CRITICAL 錯誤。舉例來說，重試媒體片段絕不會導致 CRITICAL 錯誤 (播放器會持續重試)。 |
|
嚴重 |
數字 播放器無法復原的重大錯誤。這些會導致播放器停止播放目前的媒體項目。 |
EventType
字串
播放器事件類型。如要進一步瞭解從 MediaElement 代理的事件，請參閱 https://dev.w3.org/html5/spec-preview/media-elements.html#mediaevents。
值 |
|
|---|---|
|
全部 |
字串 這是一種特殊 ID，可用於監聽所有事件 (主要用於偵錯)。事件會是 cast.framework.events.Event 的子類別。 |
|
中止 |
字串 瀏覽器在媒體完全下載前停止擷取媒體時觸發，但不是因為發生錯誤。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
CAN_PLAY |
字串 瀏覽器可以繼續播放短片，但預估載入的資料不足，無法在不停止緩衝的情況下播放短片，直到結束為止。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
CAN_PLAY_THROUGH |
字串 當瀏覽器預估可以播放短片至結束，而不會因緩衝處理而停止時，就會觸發。請注意，瀏覽器預估值僅與目前播放的短片有關 (也就是說，如果目前播放的是廣告短片，瀏覽器只會預估廣告短片，而不會預估完整內容)。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
DURATION_CHANGE |
字串 MediaElement 的 duration 屬性變更時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
EMPTIED |
字串 媒體內容清空時觸發。舉例來說，呼叫 load() 重設 MediaElement 時，就會發生這種情況。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
已結束 |
字串 媒體片段播放完畢時觸發。這不包括短片因錯誤或停止要求而停止播放的情況。如果廣告存在，則每個廣告最多觸發一次，主要內容最多觸發一次。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。如要瞭解媒體何時播放完畢，建議您使用 |
|
LOADED_DATA |
字串 瀏覽器載入媒體剪輯片段的第一個影格後，就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
LOADED_METADATA |
字串 瀏覽器載入短片的中繼資料後，就會觸發這個事件。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
LOAD_START |
字串 瀏覽器開始尋找剪輯片段的媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 在播放暫停時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaPauseEvent 中。 |
|
玩樂 |
字串 在準備開始播放時 (例如暫停後) 觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
播放中 |
字串 在播放開始時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
進度 |
字串 瀏覽器擷取媒體資料時觸發。如果您使用自動調整位元率串流 (例如 HLS、DASH、SMOOTH)，建議改用 |
|
RATE_CHANGE |
字串 播放速率更新時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
SEEKED |
字串 跳轉完成時觸發。如果媒體暫停時跳轉結束，則不會觸發。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
尋求 |
字串 在搜尋媒體時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
STALLED |
字串 瀏覽器嘗試擷取媒體資料，但未收到回應時觸發。
|
|
TIME_UPDATE |
字串 媒體播放期間會定期觸發。每當 currentTime 屬性變更時，系統就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 瀏覽器刻意不擷取媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
待執行 |
字串 瀏覽器等待下一個影格可用而停止播放時，就會觸發這個事件。 |
|
BITRATE_CHANGED |
字串 播放媒體的位元率變更時 (例如變更有效音軌，或因應網路狀況選擇不同的位元率)，就會觸發這個事件。事件為 cast.framework.events.BitrateChangedEvent。 |
|
BREAK_STARTED |
字串 在廣告插播中的第一個廣告片段開始載入時觸發。 事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_ENDED |
字串 在廣告插播中的最後一個廣告插播片段結束時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_LOADING |
字串 在廣告插播片段開始載入時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_STARTED |
字串 插播片段開始時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_ENDED |
字串 在插播片段結束時觸發。事件為 cast.framework.events.BreaksEvent。 |
|
緩衝處理中 |
字串 在播放因緩衝處理而停止，或在緩衝處理完成後重新開始時觸發。事件為 cast.framework.events.BufferingEvent。 |
|
TIME_DRIFTED |
字串 當播放器回報的目前時間，與根據播放器狀態和播放速率估算的目前時間不符時，就會觸發這個事件。事件為 cast.framework.events.TimeDriftedEvent。 |
|
CACHE_LOADED |
字串 Fastplay 預先快取的內容載入完成時，就會觸發這個事件。事件為 cast.framework.events.CacheLoadedEvent。 |
|
CACHE_HIT |
字串 使用 FastPlay 預先快取的內容時，系統會觸發這個事件。事件為 cast.framework.events.CacheItemEvent。 |
|
CACHE_INSERTED |
字串 Fastplay 快取單一網址時觸發。事件為 cast.framework.events.CacheItemEvent。 |
|
CLIP_STARTED |
字串 任何剪輯片段首次開始播放時觸發。包括廣告插播片段，以及廣告插播片段之間的主要內容片段。如要查看廣告插播片段的開始時間，請使用 Event is a {@link cast.framework.events.Event。 |
|
CLIP_ENDED |
字串 任何剪輯片段結束時觸發。包括插播片段和插播片段之間的主要內容片段。如要查看廣告插播片段何時結束，請使用 |
|
EMSG |
字串 在區隔中找到 emsg 時觸發。事件為 cast.framework.events.EmsgEvent。 |
|
錯誤 |
字串 發生錯誤時觸發。事件為 cast.framework.events.ErrorEvent。 |
|
ID3 |
字串 遇到 ID3 標記時觸發。這項事件只會針對 HLS 內容觸發。事件為 cast.framework.events.Id3Event。 |
|
MEDIA_STATUS |
字串 在傳送包含目前媒體狀態的外送訊息前觸發。事件為 cast.framework.events.MediaStatusEvent。 |
|
CUSTOM_STATE |
字串 傳送自訂狀態訊息時觸發。 事件為 cast.framework.events.CustomStateEvent。 |
|
MEDIA_INFORMATION_CHANGED |
字串 在播放期間變更媒體資訊時觸發。 例如播放現場直播電台，且曲目中繼資料變更時。事件為 cast.framework.events.MediaInformationChangedEvent |
|
MEDIA_FINISHED |
字串 媒體播放完畢時觸發。包括下列情況：串流中沒有可播放的內容、使用者要求停止，或發生錯誤。如果使用佇列，則每當佇列項目完成時，系統就會觸發這個事件。事件為 cast.framework.events.MediaFinishedEvent。 |
|
PLAYER_PRELOADING |
字串 播放器開始處理預先載入要求時觸發。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_PRELOADING_CANCELLED |
字串 如果播放器取消預先載入，就會觸發這個事件。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_LOAD_COMPLETE |
字串 播放器處理完載入要求並準備播放時，就會觸發這個事件。事件為 cast.framework.events.LoadEvent。 |
|
PLAYER_LOADING |
字串 在播放器開始處理載入要求時觸發。由於播放器尚未要求媒體資料，因此這項事件會在 |
|
SEGMENT_DOWNLOADED |
字串 在片段下載完成時觸發。只有在自適應串流內容 (HLS、DASH 或 Smooth) 才會觸發。事件為 cast.framework.events.SegmentDownloadedEvent。 |
|
SESSION_DATA |
字串 使用 Shaka Player 時，系統會針對 HLS EXT-X-SESSION-DATA 標記觸發這個事件。事件為 cast.framework.events.SessionDataEvent。 |
|
REQUEST_GET_STATUS |
字串 收到 |
|
REQUEST_SEEK |
字串 收到 |
|
REQUEST_LOAD |
字串 收到 |
|
REQUEST_PRELOAD |
字串 收到 |
|
REQUEST_STOP |
字串 收到 |
|
REQUEST_PAUSE |
字串 收到 |
|
REQUEST_PRECACHE |
字串 收到 |
|
REQUEST_PLAY |
字串 收到 |
|
REQUEST_SKIP_AD |
字串 收到 |
|
REQUEST_PLAY_AGAIN |
字串 收到 |
|
REQUEST_PLAYBACK_RATE_CHANGE |
字串 收到 |
|
REQUEST_VOLUME_CHANGE |
字串 收到 |
|
REQUEST_EDIT_TRACKS_INFO |
字串 收到 EDIT_TRACKS_INFO 訊息時觸發。事件為 cast.framework.events.RequestEvent。 |
|
REQUEST_EDIT_AUDIO_TRACKS |
字串 收到 EDIT_AUDIO_TRACKS 訊息時觸發。事件為 cast.framework.events.RequestEvent。 |
|
REQUEST_SET_CREDENTIALS |
字串 收到 |
|
REQUEST_LOAD_BY_ENTITY |
字串 收到 |
|
REQUEST_USER_ACTION |
字串 收到 |
|
REQUEST_DISPLAY_STATUS |
字串 收到 |
|
REQUEST_CUSTOM_COMMAND |
字串 收到 |
|
REQUEST_FOCUS_STATE |
字串 收到 |
|
REQUEST_QUEUE_LOAD |
字串 收到 |
|
REQUEST_QUEUE_INSERT |
字串 收到 |
|
REQUEST_QUEUE_UPDATE |
字串 收到 |
|
REQUEST_QUEUE_REMOVE |
字串 收到 |
|
REQUEST_QUEUE_REORDER |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEM_RANGE |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEMS |
字串 收到 |
|
REQUEST_QUEUE_GET_ITEM_IDS |
字串 收到 |
|
TRACKS_CHANGED |
字串 載入完成後，如果可用的音軌有所變更，就會觸發這個事件。 |
|
LIVE_IS_MOVING_WINDOW_CHANGED |
字串 當直播可跳轉範圍 isMovingWindow 變更時，更具體地說，當移動視窗變更為展開視窗時，或反之亦然，就會觸發。事件為 cast.framework.events.LiveStatusEvent。 |
|
LIVE_ENDED |
字串 直播剛結束時觸發。事件為 cast.framework.events.LiveStatusEvent。 |
|
TIMED_METADATA_CHANGED |
字串 在 DASH (EventStream) 或 HLS (EXT-X-DATERANGE) 中找到定時中繼資料時，如果直播內容中出現新的定時中繼資料，系統會在 PLAYER_LOAD_COMPLETE 之後觸發這個事件。事件為 cast.framework.events.TimedMetadataEvent。 |
|
TIMED_METADATA_ENTER |
字串 播放頭進入 DASH 中的時間軸區域或到達 EXT-X-DATERANGE 標記時觸發。事件為 cast.framework.events.TimedMetadataEvent。 |
|
TIMED_METADATA_EXIT |
字串 播放頭在 DASH 中離開時間軸區域，或離開 EXT-X-DATERANGE 標記時觸發。事件為 cast.framework.events.TimedMetadataEvent。 |