Skip to content

fix(source): fallbackToSoftware 保留 Seek 旗標並略過硬解已送出的幀 - #193

Closed
purplecofe wants to merge 1 commit into
Likely7:mainfrom
purplecofe:fix/software-fallback-seek-reset
Closed

purplecofe wants to merge 1 commit into
Likely7:mainfrom
purplecofe:fix/software-fallback-seek-reset

Conversation

@purplecofe

Copy link
Copy Markdown

Why

目標:硬解中途失敗、退回軟解之後,畫面不能倒退重播,時間濾波也不能把新舊畫面混在一起。

fallbackToSoftware 在 seek 回 resumeUs(最後送出的 PTS)後設 pendingSeekFlag_ = true,函式結尾又無條件設回 false。lastPtsUs_ = INT64_MIN 也讓倒退檢查失效。所以從關鍵幀到 resumeUs 的幀會再送一次,PTS 倒退卻沒有任何重設旗標。註解說這些幀由「呼叫端的 discardBefore」丟棄,但 EngineController 的 discardBefore 只在使用者 seek 時設定,不處理這條路徑。

What changed

  • src/source/MediaFileSource.cpp
    • 刪掉結尾的 pendingSeekFlag_ = false。退回軟解後第一個送出的幀帶 Seek,歷史重設一次。這是函式開頭註解寫的原意(sweep B5)。
    • seek 回去成功時記下 resumeAfterUs_ = resumeUs。readBase 在解碼器輸出處(去隔行與 P7 配對之前)略過 PTS 不大於它的幀,遇到第一個新幀或未知 PTS 就清除。
    • 時間戳算法抽成 framePts(),out.pts 與略過判斷共用同一個算法,結果逐位元相同。
    • 使用者 seek 與重新開啟時清除 resumeAfterUs_。
  • include/veyra/source/MediaFileSource.h:新增 resumeAfterUs_。

Scope

  • 直播來源(不可 seek)和 seek 失敗的檔案不略過幀:前者從目前位置繼續,後者從頭開始。這兩種情況都只靠 Seek 旗標重設歷史。

Blast Radius

  • 只影響硬解中途退回軟解這條路徑。正常播放、使用者 seek、開檔時退回軟解(framesRead_ == 0),行為都和修正前相同。
  • framePts() 是原本程式碼原樣搬出,out.pts 的值不變。

Verification

  • macOS harness:原樣使用本分支的 framePts 與 rationalToUs,連結 FFmpeg,用 libx264 產生 open GOP、3 個 B 幀、GOP 60 的 MP4。送出 75 幀後模擬退回:flush、seek 回 resumeUs,再看接下來 40 幀。
    • 修正前:下一幀 pts_us=2000000(關鍵幀),seekFlag=0,replayed=15。
    • 修正後:下一幀 pts_us=2500000(正是 2466667 的下一幀),seekFlag=1,replayed=0。
  • 同一個檔案改用 MPEG-TS 時,seek 落在目標之後(2.47 s → 4.0 s),中間有空缺。修正前沒有任何旗標;修正後第一幀帶 Seek。
  • harness 模擬的是 fallbackToSoftware 與 readBase 的流程,不是實際類別。MediaFileSource.cpp 需要 D3D12,沒有在任何平台編譯。沒有在 Windows 上觸發真的硬解失敗。

fallbackToSoftware 在 seek 回上一個位置後設 pendingSeekFlag_=true,函式結尾又
無條件設回 false;lastPtsUs_ 也被清掉,倒退檢查失效。從關鍵幀到 resumeUs 之間
的幀會再送一次、PTS 倒退卻沒有任何重設旗標,時間濾波把新舊畫面混在一起。註解
提到的「呼叫端 discardBefore」並不處理這條路徑。

- 刪除結尾的 pendingSeekFlag_ = false,第一個重送後的幀帶 Seek 讓歷史重設
- seek 回去成功時記下 resumeAfterUs_,readBase 在解碼器輸出處略過 PTS 不大於
  它的幀,第一個新幀後清除;使用者 seek 與重新開啟也清除
- 把 frame 時間戳計算抽成 framePts,讓略過判斷與 out.pts 用同一個算法
purplecofe pushed a commit to purplecofe/Veyra-NRVideo that referenced this pull request Nov 20, 2026
@Likely7 Likely7 closed this Nov 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants