回放模組
更新時間：2026-03-16 09:21:59
回放模块(playback) 負責管理直播回放物件的設定與取得，為播放器、互動重播功能提供配置與資料。
一、Api 方法概覽
| Api 方法 | 說明 |
|---|---|
| setCurrentPlaybackTarget | 設定目前的回放物件 |
| 設定後會自動觸發 CurrentPlaybackTargetUpdated 事件 | |
| getCurrentPlaybackTarget | 取得目前的回放物件 |
| getCurrentPlaybackMode | 取得目前的回放方式 |
| 根據頻道配置與進入方式判斷是單一回放還是列表回放 | |
| getSinglePlaybackTarget | 取得「單一影片」回放物件 |
| 根據頻道配置取得目前頻道的回放資訊，轉換為回放目標物件 | |
| getPlaybackList | 取得回放列表 |
| 從介面取得分頁的回放列表資料，從 v2.14.0 版本開始支援傳入 keyword 參數來搜尋影片 | |
| getPlaybackTargetById | 根據回放 id 取得回放物件 |
| 透過回放 ID 從介面取得單一回放目標物件 | |
| getChapterEnabled | 取得「是否顯示章節」 |
| getChapterList | 取得章節列表 |
| 根據回放選項取得對應的章節資料 | |
| getOutlineList | 取得智慧大綱資料 |
| 從指定 URL 取得 AI 產生的回放大綱資料 | |
| getQuestionList | 取得知識檢測資料 |
| 從指定 URL 取得 AI 產生的知識檢測/互動答題資料 | |
| getAiSubtitleList | 取得逐字稿資料 |
| 從指定 URL 取得 AI 產生的字幕逐字稿資料，依賴 AI-SDK | |
| getFastForwardBackwardEnabled | 取得「是否支援快進快退」 |
| 判斷目前頻道與回放是否支援快進快退功能 | |
| getLoopPlayEnabled | 取得是否支援循環播放 |
| 判斷目前頻道回放是否支援循環播放功能 | |
| getListLiveStartTimeEnabled | 取得是否展示回放列表開始時間 |
| 判斷回放列表是否顯示直播開始時間 |
二、Event 事件概覽
| Event 事件 | 說明 |
|---|---|
| PlaybackEvents.CurrentPlaybackTargetUpdated | 目前回放物件已更新 |
