hls.js 1.5.14-0.canary.10598 → 1.5.14-0.canary.10602

package/README.md

@@ -393,6 +393,28 @@ To check for native browser support first and then fallback to HLS.js, swap thes
 </script>
 ```
 
+#### Ensure correct time in video
+
+HLS transcoding of an original video file often pushes the time of the first frame a bit. If you depend on having an exact match of frame times between original video and HLS stream, you need to account for this:
+
+```javascript
+let tOffset = 0;
+const getAppendedOffset = (eventName, { frag }) => {
+  if (frag.type === 'main' && frag.sn !== 'initSegment' && frag.elementaryStreams.video) {
+    const { start, startDTS, startPTS, maxStartPTS, elementaryStreams } = frag;
+    tOffset = elementaryStreams.video.startPTS - start;
+    hls.off(Hls.Events.BUFFER_APPENDED, getAppendedOffset);
+    console.log('video timestamp offset:', tOffset, { start, startDTS, startPTS, maxStartPTS, elementaryStreams });
+  }
+}
+hls.on(Hls.Events.BUFFER_APPENDED, getAppendedOffset);
+// and account for this offset, for example like this:
+const video = document.querySelector('video');
+video.addEventListener('timeupdate', () => setTime(Math.max(0, video.currentTime - tOffset))
+const seek = (t) => video.currentTime = t + tOffset;
+const getDuration = () => video.duration - tOffset;
+```
+
 For more embed and API examples see [docs/API.md](./docs/API.md).
 
 ## CORS

package/dist/hls.d.mts

@@ -1395,6 +1395,7 @@ declare class Hls implements HlsEventEmitter {
      */
     static getMediaSource(): typeof MediaSource | undefined;
     static get Events(): typeof Events;
+    static get MetadataSchema(): typeof MetadataSchema;
     static get ErrorTypes(): typeof ErrorTypes;
     static get ErrorDetails(): typeof ErrorDetails;
     /**
@@ -2445,6 +2446,7 @@ export declare type MediaPlaylistType = MainPlaylistType | SubtitlePlaylistType;
 export declare type MetadataControllerConfig = {
     enableDateRangeMetadataCues: boolean;
     enableEmsgMetadataCues: boolean;
+    enableEmsgKLVMetadata: boolean;
     enableID3MetadataCues: boolean;
 };
 
@@ -2457,10 +2459,11 @@ export declare interface MetadataSample {
     type: MetadataSchema;
 }
 
-export declare const enum MetadataSchema {
+export declare enum MetadataSchema {
     audioId3 = "org.id3",
     dateRange = "com.apple.quicktime.HLS",
-    emsg = "https://aomedia.org/emsg/ID3"
+    emsg = "https://aomedia.org/emsg/ID3",
+    misbklv = "urn:misb:KLV:bin:1910.1"
 }
 
 export declare type MP4RemuxerConfig = {

package/dist/hls.d.ts

@@ -1395,6 +1395,7 @@ declare class Hls implements HlsEventEmitter {
      */
     static getMediaSource(): typeof MediaSource | undefined;
     static get Events(): typeof Events;
+    static get MetadataSchema(): typeof MetadataSchema;
     static get ErrorTypes(): typeof ErrorTypes;
     static get ErrorDetails(): typeof ErrorDetails;
     /**
@@ -2445,6 +2446,7 @@ export declare type MediaPlaylistType = MainPlaylistType | SubtitlePlaylistType;
 export declare type MetadataControllerConfig = {
     enableDateRangeMetadataCues: boolean;
     enableEmsgMetadataCues: boolean;
+    enableEmsgKLVMetadata: boolean;
     enableID3MetadataCues: boolean;
 };
 
@@ -2457,10 +2459,11 @@ export declare interface MetadataSample {
     type: MetadataSchema;
 }
 
-export declare const enum MetadataSchema {
+export declare enum MetadataSchema {
     audioId3 = "org.id3",
     dateRange = "com.apple.quicktime.HLS",
-    emsg = "https://aomedia.org/emsg/ID3"
+    emsg = "https://aomedia.org/emsg/ID3",
+    misbklv = "urn:misb:KLV:bin:1910.1"
 }
 
 export declare type MP4RemuxerConfig = {

package/dist/hls.js

@@ -523,7 +523,7 @@
       // Some browsers don't allow to use bind on console object anyway
       // fallback to default if needed
       try {
-        newLogger.log("Debug logs enabled for \"" + context + "\" in hls.js version " + "1.5.14-0.canary.10598");
+        newLogger.log("Debug logs enabled for \"" + context + "\" in hls.js version " + "1.5.14-0.canary.10602");
       } catch (e) {
         /* log fn threw an exception. All logger methods are no-ops. */
         return createLogger();
@@ -4542,11 +4542,13 @@
     return tracks;
   }
 
-  var MetadataSchema = {
-    audioId3: "org.id3",
-    dateRange: "com.apple.quicktime.HLS",
-    emsg: "https://aomedia.org/emsg/ID3"
-  };
+  var MetadataSchema = /*#__PURE__*/function (MetadataSchema) {
+    MetadataSchema["audioId3"] = "org.id3";
+    MetadataSchema["dateRange"] = "com.apple.quicktime.HLS";
+    MetadataSchema["emsg"] = "https://aomedia.org/emsg/ID3";
+    MetadataSchema["misbklv"] = "urn:misb:KLV:bin:1910.1";
+    return MetadataSchema;
+  }({});
 
   /**
    * Decode an ID3 PRIV frame.
@@ -12177,6 +12179,7 @@
       };
     };
     _proto.extractID3Track = function extractID3Track(videoTrack, timeOffset) {
+      var _this = this;
       var id3Track = this.id3Track;
       if (videoTrack.samples.length) {
         var emsgs = findBox(videoTrack.samples, ['emsg']);
@@ -12199,6 +12202,16 @@
                 type: MetadataSchema.emsg,
                 duration: duration
               });
+            } else if (_this.config.enableEmsgKLVMetadata && emsgInfo.schemeIdUri.startsWith('urn:misb:KLV:bin:1910.1')) {
+              var _pts = isFiniteNumber(emsgInfo.presentationTime) ? emsgInfo.presentationTime / emsgInfo.timeScale : timeOffset + emsgInfo.presentationTimeDelta / emsgInfo.timeScale;
+              id3Track.samples.push({
+                data: emsgInfo.payload,
+                len: emsgInfo.payload.byteLength,
+                dts: _pts,
+                pts: _pts,
+                type: MetadataSchema.misbklv,
+                duration: Number.POSITIVE_INFINITY
+              });
             }
           });
         }
@@ -17311,7 +17324,7 @@
     return !remuxResult.audio && !remuxResult.video && !remuxResult.text && !remuxResult.id3 && !remuxResult.initSegment;
   }
 
-  var version = "1.5.14-0.canary.10598";
+  var version = "1.5.14-0.canary.10602";
 
   // ensure the worker ends up in the bundle
   // If the worker should not be included this gets aliased to empty.js
@@ -27462,6 +27475,7 @@
     cmcd: undefined,
     enableDateRangeMetadataCues: true,
     enableEmsgMetadataCues: true,
+    enableEmsgKLVMetadata: false,
     enableID3MetadataCues: true,
     useMediaCapabilities: true,
     certLoadPolicy: {
@@ -30920,6 +30934,11 @@
       get: function get() {
         return Events;
       }
+    }, {
+      key: "MetadataSchema",
+      get: function get() {
+        return MetadataSchema;
+      }
     }, {
       key: "ErrorTypes",
       get: function get() {

package/dist/hls.js.d.ts

@@ -1395,6 +1395,7 @@ declare class Hls implements HlsEventEmitter {
      */
     static getMediaSource(): typeof MediaSource | undefined;
     static get Events(): typeof Events;
+    static get MetadataSchema(): typeof MetadataSchema;
     static get ErrorTypes(): typeof ErrorTypes;
     static get ErrorDetails(): typeof ErrorDetails;
     /**
@@ -2445,6 +2446,7 @@ export declare type MediaPlaylistType = MainPlaylistType | SubtitlePlaylistType;
 export declare type MetadataControllerConfig = {
     enableDateRangeMetadataCues: boolean;
     enableEmsgMetadataCues: boolean;
+    enableEmsgKLVMetadata: boolean;
     enableID3MetadataCues: boolean;
 };
 
@@ -2457,10 +2459,11 @@ export declare interface MetadataSample {
     type: MetadataSchema;
 }
 
-export declare const enum MetadataSchema {
+export declare enum MetadataSchema {
     audioId3 = "org.id3",
     dateRange = "com.apple.quicktime.HLS",
-    emsg = "https://aomedia.org/emsg/ID3"
+    emsg = "https://aomedia.org/emsg/ID3",
+    misbklv = "urn:misb:KLV:bin:1910.1"
 }
 
 export declare type MP4RemuxerConfig = {