播放器模組

更新時間：2026-07-17 15:16:39

播放器模块(player) 主要負責播放器相關的 Api。

一、Api 方法概覽

Api 方法	說明
getPlayerInfo	獲取播放器資訊
setupPlayer	建立播放器
supportLiveTimeShift	是否支援直播時移
supportTimeAxisMark	是否支援時間軸標記
supportLowLatency	是否支援無延遲觀看
play	恢復影片播放
freezePlay	凍結影片播放
pause	暫停影片播放
stop	停止拉流
supportRefresh	是否支援重新整理
refresh	重新整理直播流
setVolume	設定影片音量
getCurrentVolume	取得影片音量
addBarrage	新增彈幕
setBarrageShow	設定彈幕顯示狀態
supportBarrageSpeed	是否支援彈幕速度切換
setBarrageSpeed	切換彈幕速度
supportBarrageSize	是否支援彈幕字型大小切換
setBarrageSize	切換彈幕字型大小
supportBarrageLocation	是否支援彈幕位置切換
getBarrageLocationSetting	取得彈幕位置資訊
setBarrageLocation	切換彈幕位置
supportBarrageAlpha	是否支援彈幕透明度切換
setBarrageAlpha	切換彈幕透明度
resizeBarrage	更新彈幕顯示區域
getLineCount	取得線路總數
changeLine	切換線路
getCurrentLine	取得目前線路
changeSubtitleSkinShow	改變即時字幕播放器的開關展示
getQualityLevels	取得可選的清晰度級別
changeQualityLevel	切換清晰度級別
getCurrentQualityLevel	取得播放器清晰度級別
getRateList	取得可選的倍速列表
changeRate	切換倍速
getCurrentRate	取得播放器倍速
getCurrentTime	取得回放播放時間
getDurationTime	取得回放播放總時長
seekVideo	設定播放進度
supportPlaybackVideo	是否支援回放影片
getAutoChangePlaybackEnabled	是否能自動切回放
changePlayback	切換回放
getPlayerSetting	取得播放器設定
getPlayerLogoSetting	取得播放器 logo 設定
getPlayerWarmUpSetting	取得播放器暖場設定資訊
setPlayerReplaySubtitleSelectConfig	更新播放器回放字幕選擇元件的文案和顯示狀態
setGestureDirection	設定手勢 seek 方向
destroyPlayer	銷燬播放器
getPIPEnabled	取得「是否開啟畫中畫功能」
getPIPForIOSEnabled	取得「是否開啟IOS系統畫中畫功能」
getPcPIPEnabled	取得「PC端是否開啟小窗播放功能」
supportPictureInPicture	目前播放器是否支援畫中畫
getPictureInPictureStatus	取得畫中畫狀態
enterPictureInPicture	進入畫中畫
leavePictureInPicture	退出畫中畫
togglePictureInPicture	切換畫中畫
switchDetectionByInfo	執行緩衝監測切換線路/清晰度
getLiveStreamCaptureUrl	取得直播截圖地址
getPlayerAdvertLinkData	取得播放器廣告連結資料
exitWebPageFullScreen	退出網頁全螢幕，僅點播播放器行動端和直播播放器行動端支援
requestFullscreen	進入系統全螢幕
exitFullscreen	退出系統全螢幕
toggleFullscreen	切換系統全螢幕
getFullscreenStatus	取得系統全螢幕狀態
supportFullscreen	目前播放器是否支援系統全螢幕

二、Event 事件概覽

Event 事件	說明
PlayerEvents.PlayerInfoChange	播放器資訊修改事件
PlayerEvents.PlayerWarmUpSettingChange	播放器暖場資訊更新
PlayerEvents.PlayerConfigLoaded	播放器設定資訊載入成功
PlayerEvents.PlayerInited	播放器初始化完畢
PlayerEvents.PlayerScriptLoaded	播放器指令碼載入完成
PlayerEvents.PlayerPlaying	播放器播放事件
PlayerEvents.PlayerPause	播放器暫停事件
PlayerEvents.VolumeChange	音量改變
PlayerEvents.LineChange	線路切換
PlayerEvents.QualityLevelChange	清晰度級別切換
PlayerEvents.RateChange	倍速修改
PlayerEvents.BarrageStatusChange	播放器彈幕改變
PlayerEvents.BarrageSettingClick	調起彈幕設定彈窗
PlayerEvents.TimeUpdate	播放時間改變
PlayerEvents.PlaybackOver	回放播放結束
PlayerEvents.HistoryPlay	回放續播事件
PlayerEvents.LowLatencyError	無延遲播放異常
PlayerEvents.ToggleFullScreen	切換播放器全螢幕
PlayerEvents.PlayerMarqueeError	防錄屏跑馬燈異常
PlayerEvents.PlayerTimeAxisMarkListChange	播放器打點資訊改變
PlayerEvents.PlayerHighlightsBtnClicked	播放器「精彩看點」按鈕點選事件
PlayerEvents.PlayerSubtitleSwitched	播放器「即時字幕」切換按鈕切換
PlayerEvents.PlayerUIControlDisplay	播放器 UI 控制欄顯隱事件
PlayerEvents.PlayerLoading	行動端播放器Loading顯示隱藏事件
PlayerEvents.PlayerUIReplaySubtitleChecked	回放字幕開啟和關閉指定的字幕
PlayerEvents.PlayerUIReplaySubtitleSelectBtnClick	行動端播放器點選字幕的選擇器時觸發
PlayerEvents.PlayerSetupPanelSkinInit	行動端播放器設定面板面板初始化事件
PlayerEvents.PlayerHeadAdClicked	行動端播放器頭部廣告點選事件
PlayerEvents.PlayerStopAdClicked	行動端播放器暫停廣告點選事件
PlayerEvents.PlayerStatisticsInfo	行動端播放器統計資訊
PlayerEvents.PlayerInnerTimeUpdate	播放器內部時間更新事件
PlayerEvents.PlayerSetupPanelChange	行動端播放器設定面板改變事件
PlayerEvents.PlayerLoadingDetectionUpdate	播放緩衝狀態監測更新事件
PlayerEvents.PlayerFullscreenChange	播放器全螢幕狀態改變事件
PlayerEvents.GuideStreamVideoSizeChange	導播臺推流解析度調整事件
PlayerEvents.VodPlayerServerError	點播播放器server error事件
PlayerEvents.LivePlayerError	直播播放器s2j_onPlayerError事件
PlayerEvents.EnterPictureInPicture	進入畫中畫
PlayerEvents.LeavePictureInPicture	退出畫中畫