cast. framework. events
这是 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 / 文件标识符
- 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 |
字符串 由于加载了新内容,播放已结束。 |
|
SKIPPED |
字符串 因执行跳过广告操作而停止播放。 |
|
BREAK_SWITCH |
字符串 由于切换到拼接广告插播,播放已结束。 |
ErrorSeverity
数值
错误严重程度。遵循与 Shaka Player 相同的命名方案和编号。
值 |
|
|---|---|
|
RECOVERABLE |
数值 发生了错误,但播放器正在尝试从错误中恢复。 如果播放器最终无法恢复,可能仍不会抛出 CRITICAL 错误。例如,重试媒体片段永远不会导致出现 CRITICAL 错误(播放器只会一直重试)。 |
|
危急 |
数值 播放器无法从中恢复的严重错误。这些原因会导致播放器停止播放当前媒体内容。 |
EventType
字符串
播放器事件类型。对于从 MediaElement 代理的事件,请参阅 https://dev.w3.org/html5/spec-preview/media-elements.html#mediaevents 了解详情。
值 |
|
|---|---|
|
全部 |
字符串 这是一个特殊标识符,可用于监听所有事件(主要用于调试目的)。该事件将是 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 的时长属性发生更改时触发。 此事件是从 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 中。 |
|
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 |
字符串 在快速播放预缓存的内容加载完毕时触发。事件是 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 时触发。事件是 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。 |
|
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 |
字符串 在可搜索的直播范围(即移动窗口)发生更改时触发,更具体地说,在移动窗口更改为扩展窗口或反之亦然时触发。事件是 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 |
字符串 由于加载了新内容,播放已结束。 |
|
SKIPPED |
字符串 因执行跳过广告操作而停止播放。 |
|
BREAK_SWITCH |
字符串 由于切换到拼接广告插播,播放已结束。 |
ErrorSeverity
数值
错误严重程度。遵循与 Shaka Player 相同的命名方案和编号。
值 |
|
|---|---|
|
RECOVERABLE |
数值 发生了错误,但播放器正在尝试从错误中恢复。 如果播放器最终无法恢复,可能仍不会抛出 CRITICAL 错误。例如,重试媒体片段永远不会导致出现 CRITICAL 错误(播放器只会一直重试)。 |
|
危急 |
数值 播放器无法从中恢复的严重错误。这些原因会导致播放器停止播放当前媒体内容。 |
EventType
字符串
播放器事件类型。对于从 MediaElement 代理的事件,请参阅 https://dev.w3.org/html5/spec-preview/media-elements.html#mediaevents 了解详情。
值 |
|
|---|---|
|
全部 |
字符串 这是一个特殊标识符,可用于监听所有事件(主要用于调试目的)。该事件将是 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 的时长属性发生更改时触发。 此事件是从 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 中。 |
|
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 |
字符串 在快速播放预缓存的内容加载完毕时触发。事件是 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 时触发。事件是 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。 |
|
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 |
字符串 在可搜索的直播范围(即移动窗口)发生更改时触发,更具体地说,在移动窗口更改为扩展窗口或反之亦然时触发。事件是 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。 |