@oddin-gg/havik-player 2.16.13 → 2.17.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.cts CHANGED
@@ -905,6 +905,17 @@ export declare interface PlaybackStats {
905
905
  /** Times the ABR ceiling was stepped down because the device kept dropping
906
906
  * frames on the rendition it played (hls.js engine only). */
907
907
  fpsDownCaps?: number;
908
+ /** Height of the highest rendition ABR may pick right now (hls.js engine
909
+ * only). Present only while a ceiling is in force; a viewer stuck at 540p
910
+ * reads it next to `levelHeight` to see the ceiling, not the network. */
911
+ maxLevelHeight?: number;
912
+ /** Which SDK-owned cap set `maxLevelHeight`: the player's pixel box, the
913
+ * caller's `maxBitrate` budget, or frame-drop capping. Present only while
914
+ * the SDK's own ceiling is applied; when two caps land on the same rung the
915
+ * first of size, bitrate, fps is reported. Omitted when the caller handed
916
+ * capping to hls.js (`capLevelToPlayerSize` / `capLevelOnFPSDrop`), even if
917
+ * `maxLevelHeight` is set from hls.js's own cap. */
918
+ capReason?: 'size' | 'bitrate' | 'fps';
908
919
  /** Bitrate of the current rendition in kbps, when known. */
909
920
  renditionBitrateKbps?: number;
910
921
  /** Duration of the most recent DRM license acquisition in ms (0 = none yet). */
package/dist/index.d.ts CHANGED
@@ -905,6 +905,17 @@ export declare interface PlaybackStats {
905
905
  /** Times the ABR ceiling was stepped down because the device kept dropping
906
906
  * frames on the rendition it played (hls.js engine only). */
907
907
  fpsDownCaps?: number;
908
+ /** Height of the highest rendition ABR may pick right now (hls.js engine
909
+ * only). Present only while a ceiling is in force; a viewer stuck at 540p
910
+ * reads it next to `levelHeight` to see the ceiling, not the network. */
911
+ maxLevelHeight?: number;
912
+ /** Which SDK-owned cap set `maxLevelHeight`: the player's pixel box, the
913
+ * caller's `maxBitrate` budget, or frame-drop capping. Present only while
914
+ * the SDK's own ceiling is applied; when two caps land on the same rung the
915
+ * first of size, bitrate, fps is reported. Omitted when the caller handed
916
+ * capping to hls.js (`capLevelToPlayerSize` / `capLevelOnFPSDrop`), even if
917
+ * `maxLevelHeight` is set from hls.js's own cap. */
918
+ capReason?: 'size' | 'bitrate' | 'fps';
908
919
  /** Bitrate of the current rendition in kbps, when known. */
909
920
  renditionBitrateKbps?: number;
910
921
  /** Duration of the most recent DRM license acquisition in ms (0 = none yet). */