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活動的活動資料。
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 |
數字 無法下載 HLS 播放清單時，系統會傳回這個錯誤代碼。 |
|
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 |
字串 由於切換縫合中斷，播放作業已結束。 |
ErrorSeverity
數字
錯誤嚴重性。遵循與 Shaka Player 相同的命名配置和編號。
值 |
|
|---|---|
|
RECOVERABLE |
數字 發生錯誤，但播放器正在嘗試從錯誤中復原。 如果 Player 最終無法復原，可能仍不會擲回 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 中。 |
|
已清空 |
字串 媒體變為空白時觸發。舉例來說，呼叫 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 中。 |
|
已停止 |
字串 瀏覽器嘗試擷取媒體資料，但未收到回應時觸發。 |
|
TIME_UPDATE |
字串 媒體播放期間會定期觸發。只要 currentTime 屬性變更，系統就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 瀏覽器刻意不擷取媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
待執行 |
字串 當瀏覽器等待下一個影格可用時，播放作業會停止，此時會觸發這個事件。 |
|
BITRATE_CHANGED |
字串 當播放媒體的位元率變更時觸發 (例如變更有效曲目，或因應網路狀況選擇不同位元率)。事件是 cast.framework.events.BitrateChangedEvent。 |
|
BREAK_STARTED |
字串 當中斷中的第一個中斷片段開始載入時觸發。 Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_ENDED |
字串 中斷中的最後一個片段結束時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_LOADING |
字串 中斷片段開始載入時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_STARTED |
字串 中斷片段開始播放時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_ENDED |
字串 中斷片段結束時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
緩衝處理中 |
字串 在播放因緩衝而停止，或緩衝完成後重新開始播放時觸發。事件是 cast.framework.events.BufferingEvent。 |
|
TIME_DRIFTED |
字串 當播放器回報的目前時間，與根據播放器狀態和播放速率估算的目前時間不符時，就會觸發這個事件。事件是 cast.framework.events.TimeDriftedEvent。 |
|
CACHE_LOADED |
字串 當快速播放預先快取的內容載入完畢時觸發。事件是 cast.framework.events.CacheLoadedEvent。 |
|
CACHE_HIT |
字串 使用快速播放預先快取的內容時觸發。事件是 cast.framework.events.CacheItemEvent。 |
|
CACHE_INSERTED |
字串 當快速播放功能快取單一網址時，系統會觸發這個事件。事件是 cast.framework.events.CacheItemEvent。 |
|
CLIP_STARTED |
字串 在任何剪輯片段首次開始播放時觸發。包括中斷片段和中斷片段之間的主要內容片段。如要查看中斷片段的開始時間，請使用 Event is a {@link cast.framework.events.Event. |
|
CLIP_ENDED |
字串 任何短片結束時觸發。包括插播片段和插播片段之間的主要內容片段。如要查看中斷片段的結束時間，請使用 |
|
EMSG |
字串 在區隔中找到 emsg 時觸發。Event 是 cast.framework.events.EmsgEvent。 |
|
錯誤 |
字串 發生錯誤時觸發。Event 是 cast.framework.events.ErrorEvent。 |
|
ID3 |
字串 系統偵測到 ID3 標記時觸發。這項事件只會針對 HLS 內容觸發。事件是 cast.framework.events.Id3Event。 |
|
MEDIA_STATUS |
字串 Fired before an outgoing message is sent containing current 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。 |
|
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 |
字串 當可搜尋的即時範圍 MovingWindow 變更時觸發，更具體來說，當移動視窗變更為擴展視窗或反之時觸發。事件是 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 |
數字 無法下載 HLS 播放清單時，系統會傳回這個錯誤代碼。 |
|
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 |
字串 由於切換縫合中斷，播放作業已結束。 |
ErrorSeverity
數字
錯誤嚴重性。遵循與 Shaka Player 相同的命名配置和編號。
值 |
|
|---|---|
|
RECOVERABLE |
數字 發生錯誤，但播放器正在嘗試從錯誤中復原。 如果 Player 最終無法復原，可能仍不會擲回 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 中。 |
|
已清空 |
字串 媒體變為空白時觸發。舉例來說，呼叫 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 中。 |
|
已停止 |
字串 瀏覽器嘗試擷取媒體資料，但未收到回應時觸發。 |
|
TIME_UPDATE |
字串 媒體播放期間會定期觸發。只要 currentTime 屬性變更，系統就會觸發這個事件。這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
暫停 |
字串 瀏覽器刻意不擷取媒體資料時觸發。 這個事件是從 MediaElement 轉送，並已包裝在 cast.framework.events.MediaElementEvent 中。 |
|
待執行 |
字串 當瀏覽器等待下一個影格可用時，播放作業會停止，此時會觸發這個事件。 |
|
BITRATE_CHANGED |
字串 當播放媒體的位元率變更時觸發 (例如變更有效曲目，或因應網路狀況選擇不同位元率)。事件是 cast.framework.events.BitrateChangedEvent。 |
|
BREAK_STARTED |
字串 當中斷中的第一個中斷片段開始載入時觸發。 Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_ENDED |
字串 中斷中的最後一個片段結束時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_LOADING |
字串 中斷片段開始載入時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_STARTED |
字串 中斷片段開始播放時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
BREAK_CLIP_ENDED |
字串 中斷片段結束時觸發。Event 是 cast.framework.events.BreaksEvent。 |
|
緩衝處理中 |
字串 在播放因緩衝而停止，或緩衝完成後重新開始播放時觸發。事件是 cast.framework.events.BufferingEvent。 |
|
TIME_DRIFTED |
字串 當播放器回報的目前時間，與根據播放器狀態和播放速率估算的目前時間不符時，就會觸發這個事件。事件是 cast.framework.events.TimeDriftedEvent。 |
|
CACHE_LOADED |
字串 當快速播放預先快取的內容載入完畢時觸發。事件是 cast.framework.events.CacheLoadedEvent。 |
|
CACHE_HIT |
字串 使用快速播放預先快取的內容時觸發。事件是 cast.framework.events.CacheItemEvent。 |
|
CACHE_INSERTED |
字串 當快速播放功能快取單一網址時，系統會觸發這個事件。事件是 cast.framework.events.CacheItemEvent。 |
|
CLIP_STARTED |
字串 在任何剪輯片段首次開始播放時觸發。包括中斷片段和中斷片段之間的主要內容片段。如要查看中斷片段的開始時間，請使用 Event is a {@link cast.framework.events.Event. |
|
CLIP_ENDED |
字串 任何短片結束時觸發。包括插播片段和插播片段之間的主要內容片段。如要查看中斷片段的結束時間，請使用 |
|
EMSG |
字串 在區隔中找到 emsg 時觸發。Event 是 cast.framework.events.EmsgEvent。 |
|
錯誤 |
字串 發生錯誤時觸發。Event 是 cast.framework.events.ErrorEvent。 |
|
ID3 |
字串 系統偵測到 ID3 標記時觸發。這項事件只會針對 HLS 內容觸發。事件是 cast.framework.events.Id3Event。 |
|
MEDIA_STATUS |
字串 Fired before an outgoing message is sent containing current 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。 |
|
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 |
字串 當可搜尋的即時範圍 MovingWindow 變更時觸發，更具體來說，當移動視窗變更為擴展視窗或反之時觸發。事件是 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。 |