feat: Added MetadataAdded event (#8282)

Author: matvp91

lib/player.js

@@ -385,6 +385,25 @@ goog.requireType('shaka.media.PresentationTimeline');
  */
 
 
+/**
+ * @event shaka.Player.MetadataAddedEvent
+ * @description Triggers when metadata associated with the stream is added.
+ * @property {string} type
+ *   'metadataadded'
+ * @property {number} startTime
+ *   The time that describes the beginning of the range of the metadata to
+ *   which the cue applies.
+ * @property {?number} endTime
+ *   The time that describes the end of the range of the metadata to which
+ *   the cue applies.
+ * @property {string} metadataType
+ *   Type of metadata. Eg: 'org.id3' or 'com.apple.quicktime.HLS'
+ * @property {shaka.extern.MetadataFrame} payload
+ *   The metadata itself
+ * @exportDoc
+ */
+
+
 /**
  * @event shaka.Player.MetadataEvent
  * @description Triggers after metadata associated with the stream is found.
@@ -3494,6 +3513,13 @@ shaka.Player = class extends shaka.util.FakeEventTarget {
     // JSON stringify produces a good ID in this case.
     region.id = JSON.stringify(region);
     this.metadataRegionTimeline_.addRegion(region);
+    const data = new Map()
+        .set('startTime', region.startTime)
+        .set('endTime', region.endTime)
+        .set('metadataType', region.schemeIdUri)
+        .set('payload', region.payload);
+    this.dispatchEvent(shaka.Player.makeEvent_(
+        shaka.util.FakeEvent.EventName.MetadataAdded, data));
   }
 
   /**

lib/util/fake_event.js

@@ -177,6 +177,7 @@ shaka.util.FakeEvent.EventName = {
   ManifestUpdated: 'manifestupdated',
   MediaQualityChanged: 'mediaqualitychanged',
   MediaSourceRecovered: 'mediasourcerecovered',
+  MetadataAdded: 'metadataadded',
   Metadata: 'metadata',
   Midpoint: 'midpoint',
   NoSpatialVideoInfoEvent: 'nospatialvideoinfo',

project-words.txt

@@ -34,6 +34,7 @@ manifestparsed
 manifestupdated
 mediaqualitychanged
 mediasourcerecovered
+metadataadded
 mozfullscreenchange
 mozfullscreenerror
 nativecontrols