@oddin-gg/havik-player 2.15.2 → 2.15.3

package/docs/API.md

@@ -315,6 +315,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 +1257,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.3/dist/havik-player.global.js" integrity="sha384-6QXvumRSWQy+koXgkH0D46YFSKo9W6Pw1Cc6AZfBWxqa8MpAc3T7HKiMHHBTGsZh" 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.3/dist/havik-player.global.js" integrity="sha384-6QXvumRSWQy+koXgkH0D46YFSKo9W6Pw1Cc6AZfBWxqa8MpAc3T7HKiMHHBTGsZh" 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.3",
   "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,