dom/webidl/RTCStatsReport.webidl

   1 /* -*- Mode: IDL; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
   2 /* This Source Code Form is subject to the terms of the Mozilla Public
   3  * License, v. 2.0. If a copy of the MPL was not distributed with this file,
   4  * You can obtain one at http://mozilla.org/MPL/2.0/.
   5  *
   6  * The origin of this IDL file is
   7  * http://dev.w3.org/2011/webrtc/editor/webrtc.html#rtcstatsreport-object
   8  * http://www.w3.org/2011/04/webrtc/wiki/Stats
   9  * https://www.w3.org/TR/webrtc-stats/
  10  */
  11
  12 enum RTCStatsType {
  13   "codec",
  14   "inbound-rtp",
  15   "outbound-rtp",
  16   "remote-inbound-rtp",
  17   "remote-outbound-rtp",
  18   "media-source",
  19   "peer-connection",
  20   "csrc",
  21   "data-channel",
  22   "session",
  23   "track",
  24   "transport",
  25   "candidate-pair",
  26   "local-candidate",
  27   "remote-candidate"
  28 };
  29
  30 dictionary RTCStats {
  31   DOMHighResTimeStamp timestamp;
  32   RTCStatsType type;
  33   DOMString id;
  34 };
  35
  36 dictionary RTCRtpStreamStats : RTCStats {
  37   required unsigned long ssrc;
  38   required DOMString kind;
  39   DOMString mediaType;
  40   DOMString transportId;
  41   DOMString codecId;
  42 };
  43
  44 dictionary RTCCodecStats : RTCStats {
  45   required unsigned long payloadType;
  46   RTCCodecType  codecType;
  47   required DOMString     transportId;
  48   required DOMString     mimeType;
  49   unsigned long clockRate;
  50   unsigned long channels;
  51   DOMString     sdpFmtpLine;
  52 };
  53
  54 enum RTCCodecType {
  55   "encode",
  56   "decode",
  57 };
  58
  59 dictionary RTCReceivedRtpStreamStats: RTCRtpStreamStats {
  60   unsigned long long packetsReceived;
  61   long long packetsLost;
  62   double jitter;
  63   unsigned long discardedPackets; // non-standard alias for packetsDiscarded
  64   unsigned long packetsDiscarded;
  65 };
  66
  67 dictionary RTCInboundRtpStreamStats : RTCReceivedRtpStreamStats {
  68   required DOMString trackIdentifier;
  69   DOMString remoteId;
  70   unsigned long framesDecoded;
  71   unsigned long framesDropped;
  72   unsigned long frameWidth;
  73   unsigned long frameHeight;
  74   double framesPerSecond;
  75   unsigned long long qpSum;
  76   double totalDecodeTime;
  77   double totalInterFrameDelay;
  78   double totalSquaredInterFrameDelay;
  79   DOMHighResTimeStamp lastPacketReceivedTimestamp;
  80   unsigned long long headerBytesReceived;
  81   unsigned long long fecPacketsReceived;
  82   unsigned long long fecPacketsDiscarded;
  83   unsigned long long bytesReceived;
  84   unsigned long nackCount;
  85   unsigned long firCount;
  86   unsigned long pliCount;
  87   double totalProcessingDelay;
  88   // Always missing from libwebrtc
  89   // DOMHighResTimeStamp  estimatedPlayoutTimestamp;
  90   double jitterBufferDelay;
  91   unsigned long long jitterBufferEmittedCount;
  92   unsigned long long totalSamplesReceived;
  93   unsigned long long concealedSamples;
  94   unsigned long long silentConcealedSamples;
  95   unsigned long long concealmentEvents;
  96   unsigned long long insertedSamplesForDeceleration;
  97   unsigned long long removedSamplesForAcceleration;
  98   double audioLevel;
  99   double totalAudioEnergy;
 100   double totalSamplesDuration;
 101   unsigned long framesReceived;
 102 };
 103
 104 dictionary RTCRemoteInboundRtpStreamStats : RTCReceivedRtpStreamStats {
 105   DOMString localId;
 106   double roundTripTime;
 107   double totalRoundTripTime;
 108   double fractionLost;
 109   unsigned long long roundTripTimeMeasurements;
 110 };
 111
 112 dictionary RTCSentRtpStreamStats : RTCRtpStreamStats {
 113   unsigned long packetsSent;
 114   unsigned long long bytesSent;
 115 };
 116
 117 dictionary RTCOutboundRtpStreamStats : RTCSentRtpStreamStats {
 118   DOMString remoteId;
 119   unsigned long framesEncoded;
 120   unsigned long long qpSum;
 121   unsigned long nackCount;
 122   unsigned long firCount;
 123   unsigned long pliCount;
 124   unsigned long long headerBytesSent;
 125   unsigned long long retransmittedPacketsSent;
 126   unsigned long long retransmittedBytesSent;
 127   unsigned long long totalEncodedBytesTarget;
 128   unsigned long frameWidth;
 129   unsigned long frameHeight;
 130   double framesPerSecond;
 131   unsigned long framesSent;
 132   unsigned long hugeFramesSent;
 133   double totalEncodeTime;
 134 };
 135
 136 dictionary RTCRemoteOutboundRtpStreamStats : RTCSentRtpStreamStats {
 137   DOMString localId;
 138   DOMHighResTimeStamp remoteTimestamp;
 139 };
 140
 141 dictionary RTCMediaSourceStats : RTCStats {
 142   required DOMString trackIdentifier;
 143   required DOMString kind;
 144 };
 145
 146 dictionary RTCVideoSourceStats : RTCMediaSourceStats {
 147   unsigned long   width;
 148   unsigned long   height;
 149   unsigned long   frames;
 150   double          framesPerSecond;
 151 };
 152
 153 dictionary RTCPeerConnectionStats : RTCStats {
 154   unsigned long dataChannelsOpened;
 155   unsigned long dataChannelsClosed;
 156 };
 157
 158 dictionary RTCRTPContributingSourceStats : RTCStats {
 159   unsigned long contributorSsrc;
 160   DOMString     inboundRtpStreamId;
 161 };
 162
 163 dictionary RTCDataChannelStats : RTCStats {
 164   DOMString           label;
 165   DOMString           protocol;
 166   long                dataChannelIdentifier;
 167   // RTCTransportId is not yet implemented - Bug 1225723
 168   // DOMString transportId;
 169   RTCDataChannelState state;
 170   unsigned long       messagesSent;
 171   unsigned long long  bytesSent;
 172   unsigned long       messagesReceived;
 173   unsigned long long  bytesReceived;
 174 };
 175
 176 enum RTCStatsIceCandidatePairState {
 177   "frozen",
 178   "waiting",
 179   "inprogress",
 180   "failed",
 181   "succeeded",
 182   "cancelled"
 183 };
 184
 185 dictionary RTCIceCandidatePairStats : RTCStats {
 186   DOMString transportId;
 187   DOMString localCandidateId;
 188   DOMString remoteCandidateId;
 189   RTCStatsIceCandidatePairState state;
 190   unsigned long long priority;
 191   boolean nominated;
 192   boolean writable;
 193   boolean readable;
 194   unsigned long long bytesSent;
 195   unsigned long long bytesReceived;
 196   DOMHighResTimeStamp lastPacketSentTimestamp;
 197   DOMHighResTimeStamp lastPacketReceivedTimestamp;
 198   boolean selected;
 199   [ChromeOnly]
 200   unsigned long componentId; // moz
 201 };
 202
 203 dictionary RTCIceCandidateStats : RTCStats {
 204   DOMString address;
 205   long port;
 206   DOMString protocol;
 207   RTCIceCandidateType candidateType;
 208   long priority;
 209   DOMString relayProtocol;
 210   // Because we use this internally but don't support RTCIceCandidateStats,
 211   // we need to keep the field as ChromeOnly. Bug 1225723
 212   [ChromeOnly]
 213   DOMString transportId;
 214   [ChromeOnly]
 215   DOMString proxied;
 216 };
 217
 218 // This is for tracking the frame rate in about:webrtc
 219 dictionary RTCVideoFrameHistoryEntryInternal {
 220   required unsigned long       width;
 221   required unsigned long       height;
 222   required unsigned long       rotationAngle;
 223   required DOMHighResTimeStamp firstFrameTimestamp;
 224   required DOMHighResTimeStamp lastFrameTimestamp;
 225   required unsigned long long  consecutiveFrames;
 226   required unsigned long       localSsrc;
 227   required unsigned long       remoteSsrc;
 228 };
 229
 230 // Collection over the entries for a single track for about:webrtc
 231 dictionary RTCVideoFrameHistoryInternal {
 232   required DOMString                          trackIdentifier;
 233   sequence<RTCVideoFrameHistoryEntryInternal> entries = [];
 234 };
 235
 236 // Collection over the libwebrtc bandwidth estimation stats
 237 dictionary RTCBandwidthEstimationInternal {
 238   required DOMString  trackIdentifier;
 239   long                sendBandwidthBps;    // Estimated available send bandwidth
 240   long                maxPaddingBps;       // Cumulative configured max padding
 241   long                receiveBandwidthBps; // Estimated available receive bandwidth
 242   long                pacerDelayMs;
 243   long                rttMs;
 244 };
 245
 246 // This is used by about:webrtc to report SDP parsing errors
 247 dictionary RTCSdpParsingErrorInternal {
 248   required unsigned long lineNumber;
 249   required DOMString     error;
 250 };
 251
 252 // This is for tracking the flow of SDP for about:webrtc
 253 dictionary RTCSdpHistoryEntryInternal {
 254   required DOMHighResTimeStamp         timestamp;
 255   required boolean                     isLocal;
 256   required DOMString                   sdp;
 257   sequence<RTCSdpParsingErrorInternal> errors = [];
 258 };
 259
 260 // This is intended to be a list of dictionaries that inherit from RTCStats
 261 // (with some raw ICE candidates thrown in). Unfortunately, we cannot simply
 262 // store a sequence<RTCStats> because of slicing. So, we have to have a
 263 // separate list for each type. Used in c++ gecko code.
 264 dictionary RTCStatsCollection {
 265   sequence<RTCInboundRtpStreamStats>        inboundRtpStreamStats = [];
 266   sequence<RTCOutboundRtpStreamStats>       outboundRtpStreamStats = [];
 267   sequence<RTCRemoteInboundRtpStreamStats>  remoteInboundRtpStreamStats = [];
 268   sequence<RTCRemoteOutboundRtpStreamStats> remoteOutboundRtpStreamStats = [];
 269   sequence<RTCMediaSourceStats>             mediaSourceStats = [];
 270   sequence<RTCVideoSourceStats>             videoSourceStats = [];
 271   sequence<RTCPeerConnectionStats>          peerConnectionStats = [];
 272   sequence<RTCRTPContributingSourceStats>   rtpContributingSourceStats = [];
 273   sequence<RTCIceCandidatePairStats>        iceCandidatePairStats = [];
 274   sequence<RTCIceCandidateStats>            iceCandidateStats = [];
 275   sequence<RTCIceCandidateStats>            trickledIceCandidateStats = [];
 276   sequence<RTCDataChannelStats>             dataChannelStats = [];
 277   sequence<RTCCodecStats>                   codecStats = [];
 278
 279   // For internal use only
 280   sequence<DOMString>                       rawLocalCandidates = [];
 281   sequence<DOMString>                       rawRemoteCandidates = [];
 282   sequence<RTCVideoFrameHistoryInternal>    videoFrameHistories = [];
 283   sequence<RTCBandwidthEstimationInternal>  bandwidthEstimations = [];
 284 };
 285
 286 // Details that about:webrtc can display about configured ICE servers
 287 dictionary RTCIceServerInternal {
 288   sequence<DOMString> urls = [];
 289   required boolean    credentialProvided;
 290   required boolean    userNameProvided;
 291 };
 292
 293 // Details that about:webrtc can display about the RTCConfiguration
 294 // Chrome only
 295 dictionary RTCConfigurationInternal {
 296   RTCBundlePolicy                bundlePolicy;
 297   required boolean               certificatesProvided;
 298   sequence<RTCIceServerInternal> iceServers = [];
 299   RTCIceTransportPolicy          iceTransportPolicy;
 300   required boolean               peerIdentityProvided;
 301   DOMString                      sdpSemantics;
 302 };
 303
 304 dictionary RTCSdpHistoryInternal {
 305   required DOMString pcid;
 306   sequence<RTCSdpHistoryEntryInternal> sdpHistory = [];
 307 };
 308
 309 // A collection of RTCStats dictionaries, plus some other info. Used by
 310 // WebrtcGlobalInformation for about:webrtc, and telemetry.
 311 dictionary RTCStatsReportInternal : RTCStatsCollection {
 312   required DOMString                        pcid;
 313   required unsigned long                    browserId;
 314   RTCConfigurationInternal                  configuration;
 315   DOMString                                 jsepSessionErrors;
 316   // TODO demux from RTCStatsReportInternal in bug 1830824
 317   sequence<RTCSdpHistoryEntryInternal>      sdpHistory = [];
 318   required DOMHighResTimeStamp              timestamp;
 319   double                                    callDurationMs;
 320   required unsigned long                    iceRestarts;
 321   required unsigned long                    iceRollbacks;
 322   boolean                                   offerer; // Is the PC the offerer
 323   required boolean                          closed; // Is the PC now closed
 324 };
 325
 326 [Pref="media.peerconnection.enabled",
 327  Exposed=Window]
 328 interface RTCStatsReport {
 329
 330   // TODO(bug 1586109): Remove this once we no longer need to be able to
 331   // construct empty RTCStatsReports from JS.
 332   [ChromeOnly]
 333   constructor();
 334
 335   readonly maplike<DOMString, object>;
 336 };