Bug 1363667 - P1 - Add RTP Sources WebIDL r=bkelly,mjf

MozReview-Commit-ID: 61RqPKfbrDw

--HG--
extra : rebase_source : 413164df9bbabe6e93c217f33b1127ddde6716b9

dom/webidl/RTCRtpReceiver.webidl

@@ -10,6 +10,8 @@
 [Pref="media.peerconnection.enabled",
  JSImplementation="@mozilla.org/dom/rtpreceiver;1"]
 interface RTCRtpReceiver {
-  readonly attribute MediaStreamTrack track;
-  Promise<RTCStatsReport> getStats();
+  readonly attribute MediaStreamTrack   track;
+  Promise<RTCStatsReport>               getStats();
+  sequence<RTCRtpContributingSource>    getContributingSources();
+  sequence<RTCRtpSynchronizationSource> getSynchronizationSources();
 };

dom/webidl/RTCRtpSources.webidl

@@ -0,0 +1,39 @@
+/* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this file,
+ * You can obtain one at http://mozilla.org/MPL/2.0/.
+ *
+ * The origin of this IDL file is
+ * https://www.w3.org/TR/2017/CR-webrtc-20171102/
+ */
+
+// WebIDL note: RTCRtpContrinbutingSource and RTCRtpSynchronizationSource
+// are specified currently as interfaces in the spec, however there is an
+// open issue which has yet to land changing them to dictionaries.
+// See: https://github.com/w3c/webrtc-pc/issues/1533
+// and https://bugzilla.mozilla.org/show_bug.cgi?id=1419093
+
+dictionary RTCRtpContributingSource {
+    DOMHighResTimeStamp  timestamp;
+    unsigned long        source;
+    byte?                audioLevel;
+};
+
+dictionary RTCRtpSynchronizationSource {
+    DOMHighResTimeStamp  timestamp;
+    unsigned long        source;
+    byte                 audioLevel;
+};
+
+/* Hidden shared representation of Contributing and Synchronization sources */
+enum RTCRtpSourceEntryType {
+    "contributing",
+    "synchronization",
+};
+
+dictionary RTCRtpSourceEntry {
+    DOMHighResTimeStamp    timestamp;
+    unsigned long          source;
+    byte?                  audioLevel;
+    RTCRtpSourceEntryType  sourceType;
+};

dom/webidl/moz.build

@@ -995,6 +995,7 @@ if CONFIG['MOZ_WEBRTC']:
         'RTCPeerConnectionStatic.webidl',
         'RTCRtpReceiver.webidl',
         'RTCRtpSender.webidl',
+        'RTCRtpSources.webidl',
         'RTCRtpTransceiver.webidl',
         'RTCSessionDescription.webidl',
         'TransceiverImpl.webidl',