mirror of
https://github.com/mollyim/webrtc.git
synced 2025-05-14 14:20:45 +01:00
b619936dee
This is part of the work to add a selector argument to getStats(). Changes: - TakeReferencedStats() added, which traverses the stats graph and takes any stats from the report that are directly or indirectly accessible from the starting stats objects in the stats graph. The result is returned as a stats report. - GetStatsReferencedIds(), an efficient helper function for getting neighbor stats object IDs. - RTCStatsReport::Take(), removed the stats object with the given ID and returns ownership of it (so that it can be added to another report). TakeReferencedStats() is tested with a bunch of sample stats graphs. GetStatsReferencedIds() is tested in the rtcstats_integrationttest.cc, making sure the expected IDs are returned. The expected IDs are the values of the stats object members with the "Id" or "Ids" suffix. Design doc: https://docs.google.com/document/d/18BywbtXgHCjsbR5nWBedpzqDjAfXrFSTJNiADnzoK0w/edit?usp=sharing Bug: chromium:680172 Change-Id: I5da9da8250da0cb05adb864015901393a4290776 Reviewed-on: https://webrtc-review.googlesource.com/60869 Commit-Queue: Henrik Boström <hbos@webrtc.org> Reviewed-by: Taylor Brandstetter <deadbeef@webrtc.org> Cr-Commit-Position: refs/heads/master@{#22381}
43 lines
1.6 KiB
C++
43 lines
1.6 KiB
C++
/*
|
|
* 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_RTCSTATSTRAVERSAL_H_
|
|
#define PC_RTCSTATSTRAVERSAL_H_
|
|
|
|
#include <string>
|
|
#include <vector>
|
|
|
|
#include "api/stats/rtcstatsreport.h"
|
|
#include "rtc_base/scoped_ref_ptr.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_RTCSTATSTRAVERSAL_H_
|