feat: preserveManualLevelOnError option (#7280)

brodiddev · web-flow · commit 07fcc6d7de01 · 2025-05-27T20:36:52.000-07:00
diff --git a/api-extractor/report/hls.js.api.md b/api-extractor/report/hls.js.api.md
@@ -2240,6 +2240,7 @@ export type HlsConfig = {
     ignoreDevicePixelRatio: boolean;
     maxDevicePixelRatio: number;
     preferManagedMediaSource: boolean;
+    preserveManualLevelOnError: boolean;
     timelineOffset?: number;
     ignorePlaylistParsingErrors: boolean;
     loader: {
diff --git a/src/config.ts b/src/config.ts
@@ -282,6 +282,7 @@ export type HlsConfig = {
   ignoreDevicePixelRatio: boolean;
   maxDevicePixelRatio: number;
   preferManagedMediaSource: boolean;
+  preserveManualLevelOnError: boolean;
   timelineOffset?: number;
   ignorePlaylistParsingErrors: boolean;
   loader: { new (confg: HlsConfig): Loader<LoaderContext> };
@@ -450,6 +451,7 @@ export const hlsDefaultConfig: HlsConfig = {
   interstitialAppendInPlace: true,
   interstitialLiveLookAhead: 10,
   useMediaCapabilities: __USE_MEDIA_CAPABILITIES__,
+  preserveManualLevelOnError: false,
 
   certLoadPolicy: {
     default: defaultLoadPolicy,
diff --git a/src/controller/error-controller.ts b/src/controller/error-controller.ts
@@ -341,7 +341,7 @@ export default class ErrorController
       // Search for next level to retry
       let nextLevel = -1;
       const { levels, loadLevel, minAutoLevel, maxAutoLevel } = hls;
-      if (!hls.autoLevelEnabled) {
+      if (!hls.autoLevelEnabled && !hls.config.preserveManualLevelOnError) {
         hls.loadLevel = -1;
       }
       const fragErrorType = data.frag?.type;

Original file line number	Diff line number	Diff line change
`@@ -341,7 +341,7 @@ export default class ErrorController`
`341`	`341`	`// Search for next level to retry`
`342`	`342`	`let nextLevel = -1;`
`343`	`343`	`const { levels, loadLevel, minAutoLevel, maxAutoLevel } = hls;`
`344`		`- if (!hls.autoLevelEnabled) {`
	`344`	`+ if (!hls.autoLevelEnabled && !hls.config.preserveManualLevelOnError) {`
`345`	`345`	`hls.loadLevel = -1;`
`346`	`346`	`}`
`347`	`347`	`const fragErrorType = data.frag?.type;`