@oddin-gg/havik-player 2.15.2 → 2.15.4

package/docs/API.md

@@ -265,6 +265,11 @@ don't need to set any of the live or ABR knobs:
   aren't reliably published yet; chasing that edge causes constant rebuffering.
   Set `liveLatencyTarget` lower for closer‑to‑live (more rebuffer‑prone) or
   higher for steadier playback. _Lowered from 3 s; see the migration note below._
+- **Catch‑up dead band**: the player only speeds up when it is more than
+  **0.5 s** behind its target. Smaller gaps, like the 0.1 to 0.4 s a viewer
+  typically lands behind on joining, are left alone, because even 1.05× is
+  audible as a crackle in Chrome's and Firefox's pitch correction. Once catch‑up
+  starts it runs until playback is back on target.
 - **Drift ceiling**: after a stall, the player catches up at up to **1.1×** (gentle
   enough to be invisible; it was 1.5×, which showed as the picture speeding up
   between stalls on a jittery edge) and,
@@ -315,6 +320,17 @@ can't crash the player: if you pass the count‑based `liveSyncDurationCount` /
 rejects mixing the two); if you set `liveSyncDuration` alone, a matching ceiling
 is derived above it.
 
+- **Quality steps down when the device can't decode it.** If the browser keeps
+  dropping more than 20% of frames for two 3 s checks in a row, the SDK caps
+  ABR one rendition below the one playing (counted in `fpsDownCaps`). This is
+  what keeps a laptop without hardware decoding from showing a stuttering
+  picture that drifts away from the sound. It folds into the same cap as the
+  player‑size and `maxBitrate` limits, never applies to a quality the viewer
+  pinned, and stays down for the session. Setting
+  `hlsConfig.capLevelOnFPSDrop: false` turns frame‑drop capping off; `true` runs
+  hls.js's own controller instead, whose cap a later player‑size or `maxBitrate`
+  recompute can overwrite.
+
 - **Futile catch‑up is stopped.** hls.js speeds playback up (to 1.1×) whenever
   latency sits above the target, and only lowers its ambition after a counted
   rebuffer. On an edge that is itself seconds behind, a player that keeps a
@@ -1246,6 +1262,8 @@ interface PlaybackStats {
   lowLatency?: boolean; // whether LL-HLS was detected in the manifest
   isLive?: boolean; // current media playlist is live
   atLiveEdge?: boolean; // playback is at/near the live edge
+  liveRetargets?: number; // times a futile catch-up moved the live target (hls.js engine)
+  fpsDownCaps?: number; // times quality was capped because the device dropped frames (hls.js engine)
 }
 ```
 

package/embed/index.html

@@ -28,7 +28,7 @@
            beacons endpoint can be derived and QoE analytics is silently off.
            `analytics` is honoured from the injected config only, never the query.
     -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.2/dist/havik-player.global.js" integrity="sha384-UOJXsjWTIgS9qCPAU4ddwav3Zexd4ElTzFYqOjlLrfn5HpQICTW9mvtdSu+5eAKr" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.4/dist/havik-player.global.js" integrity="sha384-KHquOQfjrHz3RnxzF+WQxpiXOiQb/ypcpe5Ny5oJmonEPggkQy+8BV5D5rrRfHkT" crossorigin="anonymous"></script>
     <script>
       HavikPlayer.bootEmbed();
     </script>

package/examples/vanilla.html

@@ -12,7 +12,7 @@
          shipped in each npm release is pinned to that release with Subresource
          Integrity, injected at publish time (scripts/inject-sri.mjs). In
          production, always use a pinned + SRI'd tag like the released copy. -->
-    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.2/dist/havik-player.global.js" integrity="sha384-UOJXsjWTIgS9qCPAU4ddwav3Zexd4ElTzFYqOjlLrfn5HpQICTW9mvtdSu+5eAKr" crossorigin="anonymous"></script>
+    <script src="https://cdn.jsdelivr.net/npm/@oddin-gg/havik-player@2.15.4/dist/havik-player.global.js" integrity="sha384-KHquOQfjrHz3RnxzF+WQxpiXOiQb/ypcpe5Ny5oJmonEPggkQy+8BV5D5rrRfHkT" crossorigin="anonymous"></script>
     <script>
       (async () => {
         const player = await HavikPlayer.createPlayer({

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oddin-gg/havik-player",
-  "version": "2.15.2",
+  "version": "2.15.4",
   "description": "Havik HTML5 player SDK — LL-HLS + DRM playback for Oddin live streams (managed, bring-your-own-player, and iframe-embed modes).",
   "type": "module",
   "sideEffects": false,