2020-08-14 16:58:22 +00:00
|
|
|
/*
|
|
|
|
* 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
|
2022-03-11 16:49:54 +00:00
|
|
|
// `ids`, returning them as a new stats report.
|
2020-08-14 16:58:22 +00:00
|
|
|
// 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);
|
|
|
|
|
2022-03-11 16:49:54 +00:00
|
|
|
// Gets pointers to the string values of any members in `stats` that are used as
|
2020-08-14 16:58:22 +00:00
|
|
|
// references for looking up other stats objects in the same report by ID. The
|
2022-03-11 16:49:54 +00:00
|
|
|
// pointers are valid for the lifetime of `stats` assumings its members are not
|
2020-08-14 16:58:22 +00:00
|
|
|
// 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_
|