summaryrefslogtreecommitdiffstats
path: root/third_party/libwebrtc/pc/rtc_stats_traversal.h
diff options
context:
space:
mode:
Diffstat (limited to 'third_party/libwebrtc/pc/rtc_stats_traversal.h')
-rw-r--r--third_party/libwebrtc/pc/rtc_stats_traversal.h44
1 files changed, 44 insertions, 0 deletions
diff --git a/third_party/libwebrtc/pc/rtc_stats_traversal.h b/third_party/libwebrtc/pc/rtc_stats_traversal.h
new file mode 100644
index 0000000000..ec4d51cc52
--- /dev/null
+++ b/third_party/libwebrtc/pc/rtc_stats_traversal.h
@@ -0,0 +1,44 @@
+/*
+ * Copyright 2018 The WebRTC Project Authors. All rights reserved.
+ *
+ * Use of this source code is governed by a BSD-style license
+ * that can be found in the LICENSE file in the root of the source
+ * tree. An additional intellectual property rights grant can be found
+ * in the file PATENTS. All contributing project authors may
+ * be found in the AUTHORS file in the root of the source tree.
+ */
+
+#ifndef PC_RTC_STATS_TRAVERSAL_H_
+#define PC_RTC_STATS_TRAVERSAL_H_
+
+#include <string>
+#include <vector>
+
+#include "api/scoped_refptr.h"
+#include "api/stats/rtc_stats.h"
+#include "api/stats/rtc_stats_report.h"
+
+namespace webrtc {
+
+// Traverses the stats graph, taking all stats objects that are directly or
+// indirectly accessible from and including the stats objects identified by
+// `ids`, returning them as a new stats report.
+// This is meant to be used to implement the stats selection algorithm.
+// https://w3c.github.io/webrtc-pc/#dfn-stats-selection-algorithm
+rtc::scoped_refptr<RTCStatsReport> TakeReferencedStats(
+ rtc::scoped_refptr<RTCStatsReport> report,
+ const std::vector<std::string>& ids);
+
+// Gets pointers to the string values of any members in `stats` that are used as
+// references for looking up other stats objects in the same report by ID. The
+// pointers are valid for the lifetime of `stats` assumings its members are not
+// modified.
+//
+// For example, RTCCodecStats contains "transportId"
+// (RTCCodecStats::transport_id) referencing an RTCTransportStats.
+// https://w3c.github.io/webrtc-stats/#dom-rtccodecstats-transportid
+std::vector<const std::string*> GetStatsReferencedIds(const RTCStats& stats);
+
+} // namespace webrtc
+
+#endif // PC_RTC_STATS_TRAVERSAL_H_