blob: 456ca72dcdf8b6be747327c6033342c1d2703202 [file] [log] [blame]
hbosdb346a72016-11-29 01:57:01 -08001/*
2 * Copyright 2016 The WebRTC project authors. All Rights Reserved.
3 *
4 * Use of this source code is governed by a BSD-style license
5 * that can be found in the LICENSE file in the root of the source
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Yves Gerey3e707812018-11-28 16:47:49 +010011#include <stdint.h>
12#include <string.h>
Jonas Olssona4d87372019-07-05 19:08:33 +020013
Henrik Boströmb6199362018-03-12 10:27:55 +010014#include <algorithm>
Yves Gerey3e707812018-11-28 16:47:49 +010015#include <memory>
hbosdb346a72016-11-29 01:57:01 -080016#include <set>
Yves Gerey3e707812018-11-28 16:47:49 +010017#include <string>
hbosdb346a72016-11-29 01:57:01 -080018#include <vector>
19
Steve Anton64b626b2019-01-28 17:25:26 -080020#include "absl/algorithm/container.h"
Steve Anton68586e82018-12-13 17:41:25 -080021#include "absl/strings/match.h"
Yves Gerey3e707812018-11-28 16:47:49 +010022#include "api/audio_codecs/audio_decoder_factory.h"
23#include "api/audio_codecs/audio_encoder_factory.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020024#include "api/audio_codecs/builtin_audio_decoder_factory.h"
25#include "api/audio_codecs/builtin_audio_encoder_factory.h"
Yves Gerey3e707812018-11-28 16:47:49 +010026#include "api/audio_options.h"
Steve Anton10542f22019-01-11 09:11:00 -080027#include "api/data_channel_interface.h"
28#include "api/peer_connection_interface.h"
29#include "api/rtp_receiver_interface.h"
30#include "api/rtp_sender_interface.h"
Mirko Bonadeid9708072019-01-25 20:26:48 +010031#include "api/scoped_refptr.h"
Steve Anton10542f22019-01-11 09:11:00 -080032#include "api/stats/rtc_stats.h"
33#include "api/stats/rtc_stats_report.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020034#include "api/stats/rtcstats_objects.h"
Steve Anton10542f22019-01-11 09:11:00 -080035#include "pc/rtc_stats_traversal.h"
36#include "pc/test/peer_connection_test_wrapper.h"
37#include "pc/test/rtc_stats_obtainer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020038#include "rtc_base/checks.h"
39#include "rtc_base/event_tracer.h"
40#include "rtc_base/gunit.h"
Steve Anton10542f22019-01-11 09:11:00 -080041#include "rtc_base/ref_counted_object.h"
Yves Gerey3e707812018-11-28 16:47:49 +010042#include "rtc_base/thread.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020043#include "rtc_base/trace_event.h"
Steve Anton10542f22019-01-11 09:11:00 -080044#include "rtc_base/virtual_socket_server.h"
Steve Anton64b626b2019-01-28 17:25:26 -080045#include "test/gmock.h"
Yves Gerey3e707812018-11-28 16:47:49 +010046#include "test/gtest.h"
hbosdb346a72016-11-29 01:57:01 -080047
Steve Anton64b626b2019-01-28 17:25:26 -080048using ::testing::Contains;
49
hbosdb346a72016-11-29 01:57:01 -080050namespace webrtc {
51
52namespace {
53
54const int64_t kGetStatsTimeoutMs = 10000;
55
ehmaldonado80c829f2017-07-18 07:35:19 -070056const unsigned char* GetCategoryEnabledHandler(const char* name) {
ehmaldonado8ab0fd82017-09-04 14:35:04 -070057 if (strcmp("webrtc_stats", name) != 0) {
58 return reinterpret_cast<const unsigned char*>("");
59 }
60 return reinterpret_cast<const unsigned char*>(name);
ehmaldonado80c829f2017-07-18 07:35:19 -070061}
62
ehmaldonado8ab0fd82017-09-04 14:35:04 -070063class RTCStatsReportTraceListener {
64 public:
65 static void SetUp() {
66 if (!traced_report_)
67 traced_report_ = new RTCStatsReportTraceListener();
68 traced_report_->last_trace_ = "";
69 SetupEventTracer(&GetCategoryEnabledHandler,
70 &RTCStatsReportTraceListener::AddTraceEventHandler);
71 }
72
73 static const std::string& last_trace() {
74 RTC_DCHECK(traced_report_);
75 return traced_report_->last_trace_;
76 }
77
78 private:
Steve Anton36b29d12017-10-30 09:57:42 -070079 static void AddTraceEventHandler(
80 char phase,
81 const unsigned char* category_enabled,
82 const char* name,
83 unsigned long long id, // NOLINT(runtime/int)
84 int num_args,
85 const char** arg_names,
86 const unsigned char* arg_types,
87 const unsigned long long* arg_values, // NOLINT(runtime/int)
88 unsigned char flags) {
ehmaldonado8ab0fd82017-09-04 14:35:04 -070089 RTC_DCHECK(traced_report_);
90 EXPECT_STREQ("webrtc_stats",
91 reinterpret_cast<const char*>(category_enabled));
92 EXPECT_STREQ("webrtc_stats", name);
93 EXPECT_EQ(1, num_args);
94 EXPECT_STREQ("report", arg_names[0]);
95 EXPECT_EQ(TRACE_VALUE_TYPE_COPY_STRING, arg_types[0]);
96
97 traced_report_->last_trace_ = reinterpret_cast<const char*>(arg_values[0]);
98 }
99
100 static RTCStatsReportTraceListener* traced_report_;
101 std::string last_trace_;
102};
103
104RTCStatsReportTraceListener* RTCStatsReportTraceListener::traced_report_ =
105 nullptr;
ehmaldonado80c829f2017-07-18 07:35:19 -0700106
Mirko Bonadei6a489f22019-04-09 15:11:12 +0200107class RTCStatsIntegrationTest : public ::testing::Test {
hbosdb346a72016-11-29 01:57:01 -0800108 public:
109 RTCStatsIntegrationTest()
tommie7251592017-07-14 14:44:46 -0700110 : network_thread_(new rtc::Thread(&virtual_socket_server_)),
111 worker_thread_(rtc::Thread::Create()) {
ehmaldonado8ab0fd82017-09-04 14:35:04 -0700112 RTCStatsReportTraceListener::SetUp();
ehmaldonado80c829f2017-07-18 07:35:19 -0700113
tommie7251592017-07-14 14:44:46 -0700114 RTC_CHECK(network_thread_->Start());
115 RTC_CHECK(worker_thread_->Start());
hbosdb346a72016-11-29 01:57:01 -0800116
117 caller_ = new rtc::RefCountedObject<PeerConnectionTestWrapper>(
tommie7251592017-07-14 14:44:46 -0700118 "caller", network_thread_.get(), worker_thread_.get());
hbosdb346a72016-11-29 01:57:01 -0800119 callee_ = new rtc::RefCountedObject<PeerConnectionTestWrapper>(
tommie7251592017-07-14 14:44:46 -0700120 "callee", network_thread_.get(), worker_thread_.get());
hbosdb346a72016-11-29 01:57:01 -0800121 }
122
123 void StartCall() {
124 // Create PeerConnections and "connect" sigslots
125 PeerConnectionInterface::RTCConfiguration config;
126 PeerConnectionInterface::IceServer ice_server;
127 ice_server.uri = "stun:1.1.1.1:3478";
128 config.servers.push_back(ice_server);
Niels Möllerf06f9232018-08-07 12:32:18 +0200129 EXPECT_TRUE(caller_->CreatePc(config, CreateBuiltinAudioEncoderFactory(),
kwiberg9e5b11e2017-04-19 03:47:57 -0700130 CreateBuiltinAudioDecoderFactory()));
Niels Möllerf06f9232018-08-07 12:32:18 +0200131 EXPECT_TRUE(callee_->CreatePc(config, CreateBuiltinAudioEncoderFactory(),
kwiberg9e5b11e2017-04-19 03:47:57 -0700132 CreateBuiltinAudioDecoderFactory()));
hbosdb346a72016-11-29 01:57:01 -0800133 PeerConnectionTestWrapper::Connect(caller_.get(), callee_.get());
134
135 // Get user media for audio and video
Niels Möller5c4ddad2019-02-12 12:30:58 +0100136 caller_->GetAndAddUserMedia(true, cricket::AudioOptions(), true);
137 callee_->GetAndAddUserMedia(true, cricket::AudioOptions(), true);
hbosdb346a72016-11-29 01:57:01 -0800138
139 // Create data channels
140 DataChannelInit init;
141 caller_->CreateDataChannel("data", init);
142 callee_->CreateDataChannel("data", init);
143
144 // Negotiate and wait for call to establish
Niels Möllerf06f9232018-08-07 12:32:18 +0200145 caller_->CreateOffer(PeerConnectionInterface::RTCOfferAnswerOptions());
hbosdb346a72016-11-29 01:57:01 -0800146 caller_->WaitForCallEstablished();
147 callee_->WaitForCallEstablished();
148 }
149
150 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller() {
151 return GetStats(caller_->pc());
152 }
Henrik Boström1df1bf82018-03-20 13:24:20 +0100153 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller(
154 rtc::scoped_refptr<RtpSenderInterface> selector) {
155 return GetStats(caller_->pc(), selector);
156 }
157 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller(
158 rtc::scoped_refptr<RtpReceiverInterface> selector) {
159 return GetStats(caller_->pc(), selector);
160 }
hbosdb346a72016-11-29 01:57:01 -0800161
162 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee() {
163 return GetStats(callee_->pc());
164 }
Henrik Boström1df1bf82018-03-20 13:24:20 +0100165 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee(
166 rtc::scoped_refptr<RtpSenderInterface> selector) {
167 return GetStats(callee_->pc(), selector);
168 }
169 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee(
170 rtc::scoped_refptr<RtpReceiverInterface> selector) {
171 return GetStats(callee_->pc(), selector);
172 }
hbosdb346a72016-11-29 01:57:01 -0800173
174 protected:
175 static rtc::scoped_refptr<const RTCStatsReport> GetStats(
176 PeerConnectionInterface* pc) {
177 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
178 RTCStatsObtainer::Create();
179 pc->GetStats(stats_obtainer);
180 EXPECT_TRUE_WAIT(stats_obtainer->report(), kGetStatsTimeoutMs);
181 return stats_obtainer->report();
182 }
183
Henrik Boström1df1bf82018-03-20 13:24:20 +0100184 template <typename T>
185 static rtc::scoped_refptr<const RTCStatsReport> GetStats(
186 PeerConnectionInterface* pc,
187 rtc::scoped_refptr<T> selector) {
188 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
189 RTCStatsObtainer::Create();
190 pc->GetStats(selector, stats_obtainer);
191 EXPECT_TRUE_WAIT(stats_obtainer->report(), kGetStatsTimeoutMs);
192 return stats_obtainer->report();
193 }
194
deadbeef98e186c2017-05-16 18:00:06 -0700195 // |network_thread_| uses |virtual_socket_server_| so they must be
196 // constructed/destructed in the correct order.
hbosdb346a72016-11-29 01:57:01 -0800197 rtc::VirtualSocketServer virtual_socket_server_;
tommie7251592017-07-14 14:44:46 -0700198 std::unique_ptr<rtc::Thread> network_thread_;
199 std::unique_ptr<rtc::Thread> worker_thread_;
hbosdb346a72016-11-29 01:57:01 -0800200 rtc::scoped_refptr<PeerConnectionTestWrapper> caller_;
201 rtc::scoped_refptr<PeerConnectionTestWrapper> callee_;
202};
203
204class RTCStatsVerifier {
205 public:
206 RTCStatsVerifier(const RTCStatsReport* report, const RTCStats* stats)
207 : report_(report), stats_(stats), all_tests_successful_(true) {
208 RTC_CHECK(report_);
209 RTC_CHECK(stats_);
210 for (const RTCStatsMemberInterface* member : stats_->Members()) {
211 untested_members_.insert(member);
212 }
213 }
214
Yves Gerey665174f2018-06-19 15:03:05 +0200215 void MarkMemberTested(const RTCStatsMemberInterface& member,
216 bool test_successful) {
hbosdb346a72016-11-29 01:57:01 -0800217 untested_members_.erase(&member);
218 all_tests_successful_ &= test_successful;
219 }
220
221 void TestMemberIsDefined(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 15:03:05 +0200222 EXPECT_TRUE(member.is_defined())
223 << stats_->type() << "." << member.name() << "[" << stats_->id()
224 << "] was undefined.";
hbosdb346a72016-11-29 01:57:01 -0800225 MarkMemberTested(member, member.is_defined());
226 }
227
228 void TestMemberIsUndefined(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 15:03:05 +0200229 EXPECT_FALSE(member.is_defined())
230 << stats_->type() << "." << member.name() << "[" << stats_->id()
231 << "] was defined (" << member.ValueToString() << ").";
hbosdb346a72016-11-29 01:57:01 -0800232 MarkMemberTested(member, !member.is_defined());
233 }
234
Yves Gerey665174f2018-06-19 15:03:05 +0200235 template <typename T>
hbos23351192017-01-02 06:52:19 -0800236 void TestMemberIsPositive(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 15:03:05 +0200237 EXPECT_TRUE(member.is_defined())
238 << stats_->type() << "." << member.name() << "[" << stats_->id()
239 << "] was undefined.";
hbos23351192017-01-02 06:52:19 -0800240 if (!member.is_defined()) {
241 MarkMemberTested(member, false);
242 return;
243 }
244 bool is_positive = *member.cast_to<RTCStatsMember<T>>() > T(0);
Yves Gerey665174f2018-06-19 15:03:05 +0200245 EXPECT_TRUE(is_positive)
246 << stats_->type() << "." << member.name() << "[" << stats_->id()
247 << "] was not positive (" << member.ValueToString() << ").";
hbos23351192017-01-02 06:52:19 -0800248 MarkMemberTested(member, is_positive);
249 }
250
Yves Gerey665174f2018-06-19 15:03:05 +0200251 template <typename T>
hbos23351192017-01-02 06:52:19 -0800252 void TestMemberIsNonNegative(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 15:03:05 +0200253 EXPECT_TRUE(member.is_defined())
254 << stats_->type() << "." << member.name() << "[" << stats_->id()
255 << "] was undefined.";
hbos23351192017-01-02 06:52:19 -0800256 if (!member.is_defined()) {
257 MarkMemberTested(member, false);
258 return;
259 }
260 bool is_non_negative = *member.cast_to<RTCStatsMember<T>>() >= T(0);
Yves Gerey665174f2018-06-19 15:03:05 +0200261 EXPECT_TRUE(is_non_negative)
262 << stats_->type() << "." << member.name() << "[" << stats_->id()
263 << "] was not non-negative (" << member.ValueToString() << ").";
hbos23351192017-01-02 06:52:19 -0800264 MarkMemberTested(member, is_non_negative);
265 }
266
Yves Gerey665174f2018-06-19 15:03:05 +0200267 void TestMemberIsIDReference(const RTCStatsMemberInterface& member,
268 const char* expected_type) {
hbosdb346a72016-11-29 01:57:01 -0800269 TestMemberIsIDReference(member, expected_type, false);
270 }
271
Yves Gerey665174f2018-06-19 15:03:05 +0200272 void TestMemberIsOptionalIDReference(const RTCStatsMemberInterface& member,
273 const char* expected_type) {
hbosdb346a72016-11-29 01:57:01 -0800274 TestMemberIsIDReference(member, expected_type, true);
275 }
276
277 bool ExpectAllMembersSuccessfullyTested() {
278 if (untested_members_.empty())
279 return all_tests_successful_;
280 for (const RTCStatsMemberInterface* member : untested_members_) {
Yves Gerey665174f2018-06-19 15:03:05 +0200281 EXPECT_TRUE(false) << stats_->type() << "." << member->name() << "["
282 << stats_->id() << "] was not tested.";
hbosdb346a72016-11-29 01:57:01 -0800283 }
284 return false;
285 }
286
287 private:
Yves Gerey665174f2018-06-19 15:03:05 +0200288 void TestMemberIsIDReference(const RTCStatsMemberInterface& member,
289 const char* expected_type,
290 bool optional) {
hbosdb346a72016-11-29 01:57:01 -0800291 if (optional && !member.is_defined()) {
292 MarkMemberTested(member, true);
293 return;
294 }
295 bool valid_reference = false;
296 if (member.is_defined()) {
297 if (member.type() == RTCStatsMemberInterface::kString) {
298 // A single ID.
299 const RTCStatsMember<std::string>& id =
300 member.cast_to<RTCStatsMember<std::string>>();
301 const RTCStats* referenced_stats = report_->Get(*id);
302 valid_reference =
303 referenced_stats && referenced_stats->type() == expected_type;
304 } else if (member.type() == RTCStatsMemberInterface::kSequenceString) {
305 // A vector of IDs.
306 valid_reference = true;
307 const RTCStatsMember<std::vector<std::string>>& ids =
308 member.cast_to<RTCStatsMember<std::vector<std::string>>>();
Mirko Bonadeic61ce0d2017-11-21 17:04:20 +0100309 for (const std::string& id : *ids) {
hbosdb346a72016-11-29 01:57:01 -0800310 const RTCStats* referenced_stats = report_->Get(id);
311 if (!referenced_stats || referenced_stats->type() != expected_type) {
312 valid_reference = false;
313 break;
314 }
315 }
316 }
317 }
Yves Gerey665174f2018-06-19 15:03:05 +0200318 EXPECT_TRUE(valid_reference)
319 << stats_->type() << "." << member.name()
320 << " is not a reference to an "
Jonas Olssonb2b20312020-01-14 12:11:31 +0100321 "existing dictionary of type "
322 << expected_type << " (value: "
Henrik Boström646fda02019-05-22 15:49:42 +0200323 << (member.is_defined() ? member.ValueToString() : "null") << ").";
hbosdb346a72016-11-29 01:57:01 -0800324 MarkMemberTested(member, valid_reference);
325 }
326
327 rtc::scoped_refptr<const RTCStatsReport> report_;
328 const RTCStats* stats_;
329 std::set<const RTCStatsMemberInterface*> untested_members_;
330 bool all_tests_successful_;
331};
332
333class RTCStatsReportVerifier {
334 public:
335 static std::set<const char*> StatsTypes() {
336 std::set<const char*> stats_types;
337 stats_types.insert(RTCCertificateStats::kType);
338 stats_types.insert(RTCCodecStats::kType);
339 stats_types.insert(RTCDataChannelStats::kType);
340 stats_types.insert(RTCIceCandidatePairStats::kType);
341 stats_types.insert(RTCLocalIceCandidateStats::kType);
342 stats_types.insert(RTCRemoteIceCandidateStats::kType);
343 stats_types.insert(RTCMediaStreamStats::kType);
344 stats_types.insert(RTCMediaStreamTrackStats::kType);
345 stats_types.insert(RTCPeerConnectionStats::kType);
346 stats_types.insert(RTCInboundRTPStreamStats::kType);
347 stats_types.insert(RTCOutboundRTPStreamStats::kType);
348 stats_types.insert(RTCTransportStats::kType);
349 return stats_types;
350 }
351
352 explicit RTCStatsReportVerifier(const RTCStatsReport* report)
Yves Gerey665174f2018-06-19 15:03:05 +0200353 : report_(report) {}
hbosdb346a72016-11-29 01:57:01 -0800354
Eldar Rello9276e2c2020-06-10 17:53:39 +0300355 void VerifyReport(std::vector<const char*> allowed_missing_stats) {
hbosdb346a72016-11-29 01:57:01 -0800356 std::set<const char*> missing_stats = StatsTypes();
357 bool verify_successful = true;
hbos338f78a2017-02-07 06:41:21 -0800358 std::vector<const RTCTransportStats*> transport_stats =
359 report_->GetStatsOfType<RTCTransportStats>();
Mirko Bonadeie12c1fe2018-07-03 12:53:23 +0200360 EXPECT_EQ(transport_stats.size(), 1U);
hbos338f78a2017-02-07 06:41:21 -0800361 std::string selected_candidate_pair_id =
362 *transport_stats[0]->selected_candidate_pair_id;
hbosdb346a72016-11-29 01:57:01 -0800363 for (const RTCStats& stats : *report_) {
364 missing_stats.erase(stats.type());
365 if (stats.type() == RTCCertificateStats::kType) {
Yves Gerey665174f2018-06-19 15:03:05 +0200366 verify_successful &=
367 VerifyRTCCertificateStats(stats.cast_to<RTCCertificateStats>());
hbosdb346a72016-11-29 01:57:01 -0800368 } else if (stats.type() == RTCCodecStats::kType) {
Yves Gerey665174f2018-06-19 15:03:05 +0200369 verify_successful &=
370 VerifyRTCCodecStats(stats.cast_to<RTCCodecStats>());
hbosdb346a72016-11-29 01:57:01 -0800371 } else if (stats.type() == RTCDataChannelStats::kType) {
Yves Gerey665174f2018-06-19 15:03:05 +0200372 verify_successful &=
373 VerifyRTCDataChannelStats(stats.cast_to<RTCDataChannelStats>());
hbosdb346a72016-11-29 01:57:01 -0800374 } else if (stats.type() == RTCIceCandidatePairStats::kType) {
375 verify_successful &= VerifyRTCIceCandidatePairStats(
hbos338f78a2017-02-07 06:41:21 -0800376 stats.cast_to<RTCIceCandidatePairStats>(),
377 stats.id() == selected_candidate_pair_id);
hbosdb346a72016-11-29 01:57:01 -0800378 } else if (stats.type() == RTCLocalIceCandidateStats::kType) {
379 verify_successful &= VerifyRTCLocalIceCandidateStats(
380 stats.cast_to<RTCLocalIceCandidateStats>());
381 } else if (stats.type() == RTCRemoteIceCandidateStats::kType) {
382 verify_successful &= VerifyRTCRemoteIceCandidateStats(
383 stats.cast_to<RTCRemoteIceCandidateStats>());
384 } else if (stats.type() == RTCMediaStreamStats::kType) {
Yves Gerey665174f2018-06-19 15:03:05 +0200385 verify_successful &=
386 VerifyRTCMediaStreamStats(stats.cast_to<RTCMediaStreamStats>());
hbosdb346a72016-11-29 01:57:01 -0800387 } else if (stats.type() == RTCMediaStreamTrackStats::kType) {
388 verify_successful &= VerifyRTCMediaStreamTrackStats(
389 stats.cast_to<RTCMediaStreamTrackStats>());
390 } else if (stats.type() == RTCPeerConnectionStats::kType) {
391 verify_successful &= VerifyRTCPeerConnectionStats(
392 stats.cast_to<RTCPeerConnectionStats>());
393 } else if (stats.type() == RTCInboundRTPStreamStats::kType) {
394 verify_successful &= VerifyRTCInboundRTPStreamStats(
395 stats.cast_to<RTCInboundRTPStreamStats>());
396 } else if (stats.type() == RTCOutboundRTPStreamStats::kType) {
397 verify_successful &= VerifyRTCOutboundRTPStreamStats(
Eldar Rello9276e2c2020-06-10 17:53:39 +0300398 stats.cast_to<RTCOutboundRTPStreamStats>());
Henrik Boström883eefc2019-05-27 13:40:25 +0200399 } else if (stats.type() == RTCRemoteInboundRtpStreamStats::kType) {
400 verify_successful &= VerifyRTCRemoteInboundRtpStreamStats(
401 stats.cast_to<RTCRemoteInboundRtpStreamStats>());
Henrik Boström646fda02019-05-22 15:49:42 +0200402 } else if (stats.type() == RTCAudioSourceStats::kType) {
403 // RTCAudioSourceStats::kType and RTCVideoSourceStats::kType both have
404 // the value "media-source", but they are distinguishable with pointer
405 // equality (==). In JavaScript they would be distinguished with |kind|.
406 verify_successful &=
407 VerifyRTCAudioSourceStats(stats.cast_to<RTCAudioSourceStats>());
408 } else if (stats.type() == RTCVideoSourceStats::kType) {
409 // RTCAudioSourceStats::kType and RTCVideoSourceStats::kType both have
410 // the value "media-source", but they are distinguishable with pointer
411 // equality (==). In JavaScript they would be distinguished with |kind|.
412 verify_successful &=
413 VerifyRTCVideoSourceStats(stats.cast_to<RTCVideoSourceStats>());
hbosdb346a72016-11-29 01:57:01 -0800414 } else if (stats.type() == RTCTransportStats::kType) {
Yves Gerey665174f2018-06-19 15:03:05 +0200415 verify_successful &=
416 VerifyRTCTransportStats(stats.cast_to<RTCTransportStats>());
hbosdb346a72016-11-29 01:57:01 -0800417 } else {
418 EXPECT_TRUE(false) << "Unrecognized stats type: " << stats.type();
419 verify_successful = false;
420 }
421 }
Henrik Boström1df1bf82018-03-20 13:24:20 +0100422 for (const char* missing : missing_stats) {
Steve Anton64b626b2019-01-28 17:25:26 -0800423 if (!absl::c_linear_search(allowed_missing_stats, missing)) {
Henrik Boström1df1bf82018-03-20 13:24:20 +0100424 verify_successful = false;
hbosdb346a72016-11-29 01:57:01 -0800425 EXPECT_TRUE(false) << "Missing expected stats type: " << missing;
426 }
427 }
Yves Gerey665174f2018-06-19 15:03:05 +0200428 EXPECT_TRUE(verify_successful)
429 << "One or more problems with the stats. This is the report:\n"
430 << report_->ToJson();
hbosdb346a72016-11-29 01:57:01 -0800431 }
432
Yves Gerey665174f2018-06-19 15:03:05 +0200433 bool VerifyRTCCertificateStats(const RTCCertificateStats& certificate) {
hbosdb346a72016-11-29 01:57:01 -0800434 RTCStatsVerifier verifier(report_, &certificate);
435 verifier.TestMemberIsDefined(certificate.fingerprint);
436 verifier.TestMemberIsDefined(certificate.fingerprint_algorithm);
437 verifier.TestMemberIsDefined(certificate.base64_certificate);
Yves Gerey665174f2018-06-19 15:03:05 +0200438 verifier.TestMemberIsOptionalIDReference(certificate.issuer_certificate_id,
439 RTCCertificateStats::kType);
hbosdb346a72016-11-29 01:57:01 -0800440 return verifier.ExpectAllMembersSuccessfullyTested();
441 }
442
Yves Gerey665174f2018-06-19 15:03:05 +0200443 bool VerifyRTCCodecStats(const RTCCodecStats& codec) {
hbosdb346a72016-11-29 01:57:01 -0800444 RTCStatsVerifier verifier(report_, &codec);
Philipp Hancke95157a02020-11-16 20:08:27 +0100445 verifier.TestMemberIsIDReference(codec.transport_id,
446 RTCTransportStats::kType);
hbosdb346a72016-11-29 01:57:01 -0800447 verifier.TestMemberIsDefined(codec.payload_type);
hbos13f54b22017-02-28 06:56:04 -0800448 verifier.TestMemberIsDefined(codec.mime_type);
hbos23351192017-01-02 06:52:19 -0800449 verifier.TestMemberIsPositive<uint32_t>(codec.clock_rate);
Johannes Kron72d69152020-02-10 14:05:55 +0100450
451 if (codec.mime_type->rfind("audio", 0) == 0)
452 verifier.TestMemberIsPositive<uint32_t>(codec.channels);
453 else
454 verifier.TestMemberIsUndefined(codec.channels);
455
456 // sdp_fmtp_line is an optional field.
457 verifier.MarkMemberTested(codec.sdp_fmtp_line, true);
hbosdb346a72016-11-29 01:57:01 -0800458 return verifier.ExpectAllMembersSuccessfullyTested();
459 }
460
Yves Gerey665174f2018-06-19 15:03:05 +0200461 bool VerifyRTCDataChannelStats(const RTCDataChannelStats& data_channel) {
hbosdb346a72016-11-29 01:57:01 -0800462 RTCStatsVerifier verifier(report_, &data_channel);
463 verifier.TestMemberIsDefined(data_channel.label);
464 verifier.TestMemberIsDefined(data_channel.protocol);
Harald Alvestrand10ef8472020-06-05 15:38:51 +0200465 verifier.TestMemberIsDefined(data_channel.data_channel_identifier);
hbosdb346a72016-11-29 01:57:01 -0800466 verifier.TestMemberIsDefined(data_channel.state);
hbos23351192017-01-02 06:52:19 -0800467 verifier.TestMemberIsNonNegative<uint32_t>(data_channel.messages_sent);
468 verifier.TestMemberIsNonNegative<uint64_t>(data_channel.bytes_sent);
469 verifier.TestMemberIsNonNegative<uint32_t>(data_channel.messages_received);
470 verifier.TestMemberIsNonNegative<uint64_t>(data_channel.bytes_received);
hbosdb346a72016-11-29 01:57:01 -0800471 return verifier.ExpectAllMembersSuccessfullyTested();
472 }
473
474 bool VerifyRTCIceCandidatePairStats(
Yves Gerey665174f2018-06-19 15:03:05 +0200475 const RTCIceCandidatePairStats& candidate_pair,
476 bool is_selected_pair) {
hbosdb346a72016-11-29 01:57:01 -0800477 RTCStatsVerifier verifier(report_, &candidate_pair);
Yves Gerey665174f2018-06-19 15:03:05 +0200478 verifier.TestMemberIsIDReference(candidate_pair.transport_id,
479 RTCTransportStats::kType);
480 verifier.TestMemberIsIDReference(candidate_pair.local_candidate_id,
481 RTCLocalIceCandidateStats::kType);
482 verifier.TestMemberIsIDReference(candidate_pair.remote_candidate_id,
483 RTCRemoteIceCandidateStats::kType);
hbos06495bc2017-01-02 08:08:18 -0800484 verifier.TestMemberIsDefined(candidate_pair.state);
485 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.priority);
hbos92eaec62017-02-27 01:38:08 -0800486 verifier.TestMemberIsDefined(candidate_pair.nominated);
hbosdb346a72016-11-29 01:57:01 -0800487 verifier.TestMemberIsDefined(candidate_pair.writable);
488 verifier.TestMemberIsUndefined(candidate_pair.readable);
hbos23351192017-01-02 06:52:19 -0800489 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.bytes_sent);
490 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.bytes_received);
hbosbf8d3e52017-02-28 06:34:47 -0800491 verifier.TestMemberIsNonNegative<double>(
492 candidate_pair.total_round_trip_time);
hbos23351192017-01-02 06:52:19 -0800493 verifier.TestMemberIsNonNegative<double>(
494 candidate_pair.current_round_trip_time);
hbos338f78a2017-02-07 06:41:21 -0800495 if (is_selected_pair) {
496 verifier.TestMemberIsNonNegative<double>(
497 candidate_pair.available_outgoing_bitrate);
deadbeef86c40a12017-06-28 09:37:23 -0700498 // A pair should be nominated in order to be selected.
499 EXPECT_TRUE(*candidate_pair.nominated);
hbos338f78a2017-02-07 06:41:21 -0800500 } else {
501 verifier.TestMemberIsUndefined(candidate_pair.available_outgoing_bitrate);
502 }
hbosdb346a72016-11-29 01:57:01 -0800503 verifier.TestMemberIsUndefined(candidate_pair.available_incoming_bitrate);
hbos23351192017-01-02 06:52:19 -0800504 verifier.TestMemberIsNonNegative<uint64_t>(
505 candidate_pair.requests_received);
506 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.requests_sent);
507 verifier.TestMemberIsNonNegative<uint64_t>(
508 candidate_pair.responses_received);
509 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.responses_sent);
hbosdb346a72016-11-29 01:57:01 -0800510 verifier.TestMemberIsUndefined(candidate_pair.retransmissions_received);
511 verifier.TestMemberIsUndefined(candidate_pair.retransmissions_sent);
512 verifier.TestMemberIsUndefined(candidate_pair.consent_requests_received);
hbos23351192017-01-02 06:52:19 -0800513 verifier.TestMemberIsNonNegative<uint64_t>(
514 candidate_pair.consent_requests_sent);
hbosdb346a72016-11-29 01:57:01 -0800515 verifier.TestMemberIsUndefined(candidate_pair.consent_responses_received);
516 verifier.TestMemberIsUndefined(candidate_pair.consent_responses_sent);
517 return verifier.ExpectAllMembersSuccessfullyTested();
518 }
519
Yves Gerey665174f2018-06-19 15:03:05 +0200520 bool VerifyRTCIceCandidateStats(const RTCIceCandidateStats& candidate) {
hbosdb346a72016-11-29 01:57:01 -0800521 RTCStatsVerifier verifier(report_, &candidate);
Yves Gerey665174f2018-06-19 15:03:05 +0200522 verifier.TestMemberIsIDReference(candidate.transport_id,
523 RTCTransportStats::kType);
hbosc3a2b7f2017-01-02 04:46:15 -0800524 verifier.TestMemberIsDefined(candidate.is_remote);
Gary Liu37e489c2017-11-21 10:49:36 -0800525 if (*candidate.is_remote) {
526 verifier.TestMemberIsUndefined(candidate.network_type);
527 } else {
528 verifier.TestMemberIsDefined(candidate.network_type);
529 }
hbosdb346a72016-11-29 01:57:01 -0800530 verifier.TestMemberIsDefined(candidate.ip);
Philipp Hanckea9ba4502021-03-22 13:22:54 +0100531 verifier.TestMemberIsDefined(candidate.address);
hbos23351192017-01-02 06:52:19 -0800532 verifier.TestMemberIsNonNegative<int32_t>(candidate.port);
hbosdb346a72016-11-29 01:57:01 -0800533 verifier.TestMemberIsDefined(candidate.protocol);
534 verifier.TestMemberIsDefined(candidate.candidate_type);
hbos23351192017-01-02 06:52:19 -0800535 verifier.TestMemberIsNonNegative<int32_t>(candidate.priority);
hbosdb346a72016-11-29 01:57:01 -0800536 verifier.TestMemberIsUndefined(candidate.url);
hbosd17a5a72017-01-02 08:09:59 -0800537 verifier.TestMemberIsDefined(candidate.deleted);
Philipp Hancke95513752018-09-27 14:40:08 +0200538 verifier.TestMemberIsUndefined(candidate.relay_protocol);
hbosdb346a72016-11-29 01:57:01 -0800539 return verifier.ExpectAllMembersSuccessfullyTested();
540 }
541
542 bool VerifyRTCLocalIceCandidateStats(
543 const RTCLocalIceCandidateStats& local_candidate) {
544 return VerifyRTCIceCandidateStats(local_candidate);
545 }
546
547 bool VerifyRTCRemoteIceCandidateStats(
548 const RTCRemoteIceCandidateStats& remote_candidate) {
549 return VerifyRTCIceCandidateStats(remote_candidate);
550 }
551
Yves Gerey665174f2018-06-19 15:03:05 +0200552 bool VerifyRTCMediaStreamStats(const RTCMediaStreamStats& media_stream) {
hbosdb346a72016-11-29 01:57:01 -0800553 RTCStatsVerifier verifier(report_, &media_stream);
554 verifier.TestMemberIsDefined(media_stream.stream_identifier);
Yves Gerey665174f2018-06-19 15:03:05 +0200555 verifier.TestMemberIsIDReference(media_stream.track_ids,
556 RTCMediaStreamTrackStats::kType);
hbosdb346a72016-11-29 01:57:01 -0800557 return verifier.ExpectAllMembersSuccessfullyTested();
558 }
559
560 bool VerifyRTCMediaStreamTrackStats(
561 const RTCMediaStreamTrackStats& media_stream_track) {
562 RTCStatsVerifier verifier(report_, &media_stream_track);
563 verifier.TestMemberIsDefined(media_stream_track.track_identifier);
564 verifier.TestMemberIsDefined(media_stream_track.remote_source);
565 verifier.TestMemberIsDefined(media_stream_track.ended);
566 verifier.TestMemberIsDefined(media_stream_track.detached);
hbos160e4a72017-01-17 02:53:23 -0800567 verifier.TestMemberIsDefined(media_stream_track.kind);
Guido Urdaneta67378412019-05-28 17:38:08 +0200568 RTC_DCHECK(media_stream_track.remote_source.is_defined());
hbosdb346a72016-11-29 01:57:01 -0800569 // Video or audio media stream track?
hbos160e4a72017-01-17 02:53:23 -0800570 if (*media_stream_track.kind == RTCMediaStreamTrackKind::kVideo) {
Henrik Boström646fda02019-05-22 15:49:42 +0200571 // The type of the referenced media source depends on kind.
hbos42f6d2f2017-01-20 03:56:50 -0800572 if (*media_stream_track.remote_source) {
Guido Urdaneta67378412019-05-28 17:38:08 +0200573 verifier.TestMemberIsUndefined(media_stream_track.media_source_id);
574 verifier.TestMemberIsNonNegative<double>(
575 media_stream_track.jitter_buffer_delay);
576 verifier.TestMemberIsNonNegative<uint64_t>(
577 media_stream_track.jitter_buffer_emitted_count);
hbosfefe0762017-01-20 06:14:25 -0800578 verifier.TestMemberIsUndefined(media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 16:35:03 +0100579 verifier.TestMemberIsUndefined(media_stream_track.huge_frames_sent);
hbos42f6d2f2017-01-20 03:56:50 -0800580 verifier.TestMemberIsNonNegative<uint32_t>(
581 media_stream_track.frames_received);
hbosf64941f2017-01-20 07:39:09 -0800582 verifier.TestMemberIsNonNegative<uint32_t>(
583 media_stream_track.frames_decoded);
hbos50cfe1f2017-01-23 07:21:55 -0800584 verifier.TestMemberIsNonNegative<uint32_t>(
585 media_stream_track.frames_dropped);
Sergey Silkin02371062019-01-31 16:45:42 +0100586 verifier.TestMemberIsNonNegative<uint32_t>(
587 media_stream_track.freeze_count);
588 verifier.TestMemberIsNonNegative<uint32_t>(
589 media_stream_track.pause_count);
590 verifier.TestMemberIsNonNegative<double>(
591 media_stream_track.total_freezes_duration);
592 verifier.TestMemberIsNonNegative<double>(
593 media_stream_track.total_pauses_duration);
594 verifier.TestMemberIsNonNegative<double>(
595 media_stream_track.total_frames_duration);
596 verifier.TestMemberIsNonNegative<double>(
597 media_stream_track.sum_squared_frame_durations);
hbos42f6d2f2017-01-20 03:56:50 -0800598 } else {
Guido Urdaneta67378412019-05-28 17:38:08 +0200599 verifier.TestMemberIsIDReference(media_stream_track.media_source_id,
600 RTCVideoSourceStats::kType);
601 // Local tracks have no jitter buffer.
602 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_delay);
603 verifier.TestMemberIsUndefined(
604 media_stream_track.jitter_buffer_emitted_count);
hbosfefe0762017-01-20 06:14:25 -0800605 verifier.TestMemberIsNonNegative<uint32_t>(
606 media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 16:35:03 +0100607 verifier.TestMemberIsNonNegative<uint32_t>(
608 media_stream_track.huge_frames_sent);
hbos42f6d2f2017-01-20 03:56:50 -0800609 verifier.TestMemberIsUndefined(media_stream_track.frames_received);
hbosf64941f2017-01-20 07:39:09 -0800610 verifier.TestMemberIsUndefined(media_stream_track.frames_decoded);
hbos50cfe1f2017-01-23 07:21:55 -0800611 verifier.TestMemberIsUndefined(media_stream_track.frames_dropped);
Sergey Silkin02371062019-01-31 16:45:42 +0100612 verifier.TestMemberIsUndefined(media_stream_track.freeze_count);
613 verifier.TestMemberIsUndefined(media_stream_track.pause_count);
614 verifier.TestMemberIsUndefined(
615 media_stream_track.total_freezes_duration);
616 verifier.TestMemberIsUndefined(
617 media_stream_track.total_pauses_duration);
618 verifier.TestMemberIsUndefined(
619 media_stream_track.total_frames_duration);
620 verifier.TestMemberIsUndefined(
621 media_stream_track.sum_squared_frame_durations);
hbos42f6d2f2017-01-20 03:56:50 -0800622 }
Guido Urdaneta67378412019-05-28 17:38:08 +0200623 // Video-only members
624 verifier.TestMemberIsNonNegative<uint32_t>(
625 media_stream_track.frame_width);
626 verifier.TestMemberIsNonNegative<uint32_t>(
627 media_stream_track.frame_height);
628 verifier.TestMemberIsUndefined(media_stream_track.frames_per_second);
hbosdb346a72016-11-29 01:57:01 -0800629 verifier.TestMemberIsUndefined(media_stream_track.frames_corrupted);
630 verifier.TestMemberIsUndefined(media_stream_track.partial_frames_lost);
631 verifier.TestMemberIsUndefined(media_stream_track.full_frames_lost);
632 // Audio-only members should be undefined
633 verifier.TestMemberIsUndefined(media_stream_track.audio_level);
634 verifier.TestMemberIsUndefined(media_stream_track.echo_return_loss);
635 verifier.TestMemberIsUndefined(
636 media_stream_track.echo_return_loss_enhancement);
zsteine76bd3a2017-07-14 12:17:49 -0700637 verifier.TestMemberIsUndefined(media_stream_track.total_audio_energy);
638 verifier.TestMemberIsUndefined(media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 17:38:08 +0200639 verifier.TestMemberIsUndefined(media_stream_track.total_samples_received);
640 verifier.TestMemberIsUndefined(media_stream_track.concealed_samples);
Henrik Boström21e99da2019-08-21 12:09:51 +0200641 verifier.TestMemberIsUndefined(
642 media_stream_track.silent_concealed_samples);
Guido Urdaneta67378412019-05-28 17:38:08 +0200643 verifier.TestMemberIsUndefined(media_stream_track.concealment_events);
Henrik Boström21e99da2019-08-21 12:09:51 +0200644 verifier.TestMemberIsUndefined(
645 media_stream_track.inserted_samples_for_deceleration);
646 verifier.TestMemberIsUndefined(
647 media_stream_track.removed_samples_for_acceleration);
Guido Urdaneta67378412019-05-28 17:38:08 +0200648 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_flushes);
649 verifier.TestMemberIsUndefined(
650 media_stream_track.delayed_packet_outage_samples);
651 verifier.TestMemberIsUndefined(
652 media_stream_track.relative_packet_arrival_delay);
653 verifier.TestMemberIsUndefined(media_stream_track.interruption_count);
654 verifier.TestMemberIsUndefined(
655 media_stream_track.total_interruption_duration);
Artem Titove618cc92020-03-11 11:18:54 +0100656 verifier.TestMemberIsUndefined(
657 media_stream_track.jitter_buffer_target_delay);
hbosdb346a72016-11-29 01:57:01 -0800658 } else {
Yves Gerey665174f2018-06-19 15:03:05 +0200659 RTC_DCHECK_EQ(*media_stream_track.kind, RTCMediaStreamTrackKind::kAudio);
Henrik Boström646fda02019-05-22 15:49:42 +0200660 // The type of the referenced media source depends on kind.
Guido Urdaneta67378412019-05-28 17:38:08 +0200661 if (*media_stream_track.remote_source) {
Henrik Boström646fda02019-05-22 15:49:42 +0200662 // Remote tracks don't have media source stats.
663 verifier.TestMemberIsUndefined(media_stream_track.media_source_id);
Guido Urdaneta67378412019-05-28 17:38:08 +0200664 verifier.TestMemberIsNonNegative<double>(
665 media_stream_track.jitter_buffer_delay);
666 verifier.TestMemberIsNonNegative<uint64_t>(
667 media_stream_track.jitter_buffer_emitted_count);
Artem Titove618cc92020-03-11 11:18:54 +0100668 verifier.TestMemberIsNonNegative<double>(
669 media_stream_track.jitter_buffer_target_delay);
Henrik Boströmd2c336f2019-07-03 17:11:10 +0200670 verifier.TestMemberIsPositive<double>(media_stream_track.audio_level);
671 verifier.TestMemberIsPositive<double>(
672 media_stream_track.total_audio_energy);
673 verifier.TestMemberIsPositive<uint64_t>(
Guido Urdaneta67378412019-05-28 17:38:08 +0200674 media_stream_track.total_samples_received);
Henrik Boströmd2c336f2019-07-03 17:11:10 +0200675 verifier.TestMemberIsPositive<double>(
676 media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 17:38:08 +0200677 verifier.TestMemberIsNonNegative<uint64_t>(
678 media_stream_track.concealed_samples);
679 verifier.TestMemberIsNonNegative<uint64_t>(
Henrik Boström21e99da2019-08-21 12:09:51 +0200680 media_stream_track.silent_concealed_samples);
681 verifier.TestMemberIsNonNegative<uint64_t>(
Guido Urdaneta67378412019-05-28 17:38:08 +0200682 media_stream_track.concealment_events);
683 verifier.TestMemberIsNonNegative<uint64_t>(
684 media_stream_track.inserted_samples_for_deceleration);
685 verifier.TestMemberIsNonNegative<uint64_t>(
686 media_stream_track.removed_samples_for_acceleration);
687 verifier.TestMemberIsNonNegative<uint64_t>(
Guido Urdaneta67378412019-05-28 17:38:08 +0200688 media_stream_track.jitter_buffer_flushes);
689 verifier.TestMemberIsNonNegative<uint64_t>(
690 media_stream_track.delayed_packet_outage_samples);
691 verifier.TestMemberIsNonNegative<double>(
692 media_stream_track.relative_packet_arrival_delay);
693 verifier.TestMemberIsNonNegative<uint32_t>(
694 media_stream_track.interruption_count);
695 verifier.TestMemberIsNonNegative<double>(
696 media_stream_track.total_interruption_duration);
697 } else {
698 verifier.TestMemberIsIDReference(media_stream_track.media_source_id,
699 RTCAudioSourceStats::kType);
700 // Local audio tracks have no jitter buffer.
701 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_delay);
702 verifier.TestMemberIsUndefined(
703 media_stream_track.jitter_buffer_emitted_count);
Artem Titove618cc92020-03-11 11:18:54 +0100704 verifier.TestMemberIsUndefined(
705 media_stream_track.jitter_buffer_target_delay);
Henrik Boströmd2c336f2019-07-03 17:11:10 +0200706 verifier.TestMemberIsUndefined(media_stream_track.audio_level);
707 verifier.TestMemberIsUndefined(media_stream_track.total_audio_energy);
Guido Urdaneta67378412019-05-28 17:38:08 +0200708 verifier.TestMemberIsUndefined(
709 media_stream_track.total_samples_received);
Henrik Boströmd2c336f2019-07-03 17:11:10 +0200710 verifier.TestMemberIsUndefined(
711 media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 17:38:08 +0200712 verifier.TestMemberIsUndefined(media_stream_track.concealed_samples);
Henrik Boström21e99da2019-08-21 12:09:51 +0200713 verifier.TestMemberIsUndefined(
714 media_stream_track.silent_concealed_samples);
Guido Urdaneta67378412019-05-28 17:38:08 +0200715 verifier.TestMemberIsUndefined(media_stream_track.concealment_events);
716 verifier.TestMemberIsUndefined(
Henrik Boström21e99da2019-08-21 12:09:51 +0200717 media_stream_track.inserted_samples_for_deceleration);
718 verifier.TestMemberIsUndefined(
719 media_stream_track.removed_samples_for_acceleration);
720 verifier.TestMemberIsUndefined(
Guido Urdaneta67378412019-05-28 17:38:08 +0200721 media_stream_track.jitter_buffer_flushes);
722 verifier.TestMemberIsUndefined(
723 media_stream_track.delayed_packet_outage_samples);
724 verifier.TestMemberIsUndefined(
725 media_stream_track.relative_packet_arrival_delay);
726 verifier.TestMemberIsUndefined(media_stream_track.interruption_count);
727 verifier.TestMemberIsUndefined(
728 media_stream_track.total_interruption_duration);
Henrik Boström646fda02019-05-22 15:49:42 +0200729 }
hbosdb346a72016-11-29 01:57:01 -0800730 // Video-only members should be undefined
731 verifier.TestMemberIsUndefined(media_stream_track.frame_width);
732 verifier.TestMemberIsUndefined(media_stream_track.frame_height);
733 verifier.TestMemberIsUndefined(media_stream_track.frames_per_second);
734 verifier.TestMemberIsUndefined(media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 16:35:03 +0100735 verifier.TestMemberIsUndefined(media_stream_track.huge_frames_sent);
hbosdb346a72016-11-29 01:57:01 -0800736 verifier.TestMemberIsUndefined(media_stream_track.frames_received);
737 verifier.TestMemberIsUndefined(media_stream_track.frames_decoded);
738 verifier.TestMemberIsUndefined(media_stream_track.frames_dropped);
739 verifier.TestMemberIsUndefined(media_stream_track.frames_corrupted);
740 verifier.TestMemberIsUndefined(media_stream_track.partial_frames_lost);
741 verifier.TestMemberIsUndefined(media_stream_track.full_frames_lost);
Sergey Silkin02371062019-01-31 16:45:42 +0100742 verifier.TestMemberIsUndefined(media_stream_track.freeze_count);
743 verifier.TestMemberIsUndefined(media_stream_track.pause_count);
744 verifier.TestMemberIsUndefined(media_stream_track.total_freezes_duration);
745 verifier.TestMemberIsUndefined(media_stream_track.total_pauses_duration);
746 verifier.TestMemberIsUndefined(media_stream_track.total_frames_duration);
747 verifier.TestMemberIsUndefined(
748 media_stream_track.sum_squared_frame_durations);
hbosdb346a72016-11-29 01:57:01 -0800749 // Audio-only members
hbos2d4d6532017-01-20 04:16:41 -0800750 // TODO(hbos): |echo_return_loss| and |echo_return_loss_enhancement| are
751 // flaky on msan bot (sometimes defined, sometimes undefined). Should the
752 // test run until available or is there a way to have it always be
753 // defined? crbug.com/627816
754 verifier.MarkMemberTested(media_stream_track.echo_return_loss, true);
Yves Gerey665174f2018-06-19 15:03:05 +0200755 verifier.MarkMemberTested(media_stream_track.echo_return_loss_enhancement,
756 true);
hbosdb346a72016-11-29 01:57:01 -0800757 }
758 return verifier.ExpectAllMembersSuccessfullyTested();
759 }
760
761 bool VerifyRTCPeerConnectionStats(
762 const RTCPeerConnectionStats& peer_connection) {
763 RTCStatsVerifier verifier(report_, &peer_connection);
hbos23351192017-01-02 06:52:19 -0800764 verifier.TestMemberIsNonNegative<uint32_t>(
765 peer_connection.data_channels_opened);
766 verifier.TestMemberIsNonNegative<uint32_t>(
767 peer_connection.data_channels_closed);
hbosdb346a72016-11-29 01:57:01 -0800768 return verifier.ExpectAllMembersSuccessfullyTested();
769 }
770
Yves Gerey665174f2018-06-19 15:03:05 +0200771 void VerifyRTCRTPStreamStats(const RTCRTPStreamStats& stream,
772 RTCStatsVerifier* verifier) {
hbosdb346a72016-11-29 01:57:01 -0800773 verifier->TestMemberIsDefined(stream.ssrc);
hbosdb346a72016-11-29 01:57:01 -0800774 verifier->TestMemberIsDefined(stream.media_type);
Philipp Hancke3bc01662018-08-28 14:55:03 +0200775 verifier->TestMemberIsDefined(stream.kind);
Yves Gerey665174f2018-06-19 15:03:05 +0200776 verifier->TestMemberIsIDReference(stream.track_id,
777 RTCMediaStreamTrackStats::kType);
778 verifier->TestMemberIsIDReference(stream.transport_id,
779 RTCTransportStats::kType);
hbos7bf53692016-12-15 03:33:35 -0800780 verifier->TestMemberIsIDReference(stream.codec_id, RTCCodecStats::kType);
hbosdb346a72016-11-29 01:57:01 -0800781 }
782
783 bool VerifyRTCInboundRTPStreamStats(
784 const RTCInboundRTPStreamStats& inbound_stream) {
785 RTCStatsVerifier verifier(report_, &inbound_stream);
786 VerifyRTCRTPStreamStats(inbound_stream, &verifier);
sakal5fec1282017-02-20 06:43:58 -0800787 if (inbound_stream.media_type.is_defined() &&
788 *inbound_stream.media_type == "video") {
789 verifier.TestMemberIsNonNegative<uint64_t>(inbound_stream.qp_sum);
Henrik Boström6b430862019-08-16 13:09:51 +0200790 verifier.TestMemberIsDefined(inbound_stream.decoder_implementation);
sakal5fec1282017-02-20 06:43:58 -0800791 } else {
hbosa51d4f32017-02-16 05:34:48 -0800792 verifier.TestMemberIsUndefined(inbound_stream.qp_sum);
Henrik Boström6b430862019-08-16 13:09:51 +0200793 verifier.TestMemberIsUndefined(inbound_stream.decoder_implementation);
sakal5fec1282017-02-20 06:43:58 -0800794 }
hbos23351192017-01-02 06:52:19 -0800795 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.packets_received);
Ivo Creusen8d8ffdb2019-04-30 09:45:21 +0200796 if (inbound_stream.media_type.is_defined() &&
797 *inbound_stream.media_type == "audio") {
798 verifier.TestMemberIsNonNegative<uint64_t>(
799 inbound_stream.fec_packets_received);
800 verifier.TestMemberIsNonNegative<uint64_t>(
801 inbound_stream.fec_packets_discarded);
Henrik Boström4a5dab02020-01-28 11:15:35 +0100802 } else {
803 verifier.TestMemberIsUndefined(inbound_stream.fec_packets_received);
804 verifier.TestMemberIsUndefined(inbound_stream.fec_packets_discarded);
Ivo Creusen8d8ffdb2019-04-30 09:45:21 +0200805 }
hbos23351192017-01-02 06:52:19 -0800806 verifier.TestMemberIsNonNegative<uint64_t>(inbound_stream.bytes_received);
Niels Möllerac0a4cb2019-10-09 15:01:33 +0200807 verifier.TestMemberIsNonNegative<uint64_t>(
808 inbound_stream.header_bytes_received);
Harald Alvestrand719487e2017-12-13 12:26:04 +0100809 // packets_lost is defined as signed, but this should never happen in
810 // this test. See RFC 3550.
811 verifier.TestMemberIsNonNegative<int32_t>(inbound_stream.packets_lost);
Henrik Boström01738c62019-04-15 17:32:00 +0200812 verifier.TestMemberIsDefined(inbound_stream.last_packet_received_timestamp);
Di Wufd1e9d12021-03-09 09:25:28 -0800813 verifier.TestMemberIsDefined(inbound_stream.is_remote);
Eldar Rello4e5bc9f2020-07-06 14:18:07 +0300814 if (inbound_stream.frames_received.ValueOrDefault(0) > 0) {
815 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frame_width);
816 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frame_height);
817 } else {
818 verifier.TestMemberIsUndefined(inbound_stream.frame_width);
819 verifier.TestMemberIsUndefined(inbound_stream.frame_height);
820 }
821 if (inbound_stream.frames_per_second.is_defined()) {
822 verifier.TestMemberIsNonNegative<double>(
823 inbound_stream.frames_per_second);
824 } else {
825 verifier.TestMemberIsUndefined(inbound_stream.frames_per_second);
826 }
827 verifier.TestMemberIsUndefined(inbound_stream.frame_bit_depth);
hbosdb346a72016-11-29 01:57:01 -0800828 if (inbound_stream.media_type.is_defined() &&
829 *inbound_stream.media_type == "video") {
Di Wu (RP Room Eng)8af6b492021-02-19 17:34:22 -0800830 verifier.TestMemberIsNonNegative<double>(inbound_stream.jitter);
Eldar Rello4e5bc9f2020-07-06 14:18:07 +0300831 verifier.TestMemberIsUndefined(inbound_stream.jitter_buffer_delay);
832 verifier.TestMemberIsUndefined(
833 inbound_stream.jitter_buffer_emitted_count);
834 verifier.TestMemberIsUndefined(inbound_stream.total_samples_received);
835 verifier.TestMemberIsUndefined(inbound_stream.concealed_samples);
836 verifier.TestMemberIsUndefined(inbound_stream.silent_concealed_samples);
837 verifier.TestMemberIsUndefined(inbound_stream.concealment_events);
838 verifier.TestMemberIsUndefined(
839 inbound_stream.inserted_samples_for_deceleration);
840 verifier.TestMemberIsUndefined(
841 inbound_stream.removed_samples_for_acceleration);
842 verifier.TestMemberIsUndefined(inbound_stream.audio_level);
843 verifier.TestMemberIsUndefined(inbound_stream.total_audio_energy);
844 verifier.TestMemberIsUndefined(inbound_stream.total_samples_duration);
845 verifier.TestMemberIsNonNegative<int32_t>(inbound_stream.frames_received);
Di Wufd1e9d12021-03-09 09:25:28 -0800846 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.fir_count);
847 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.pli_count);
848 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.nack_count);
hbosdb346a72016-11-29 01:57:01 -0800849 } else {
Di Wufd1e9d12021-03-09 09:25:28 -0800850 verifier.TestMemberIsUndefined(inbound_stream.fir_count);
851 verifier.TestMemberIsUndefined(inbound_stream.pli_count);
852 verifier.TestMemberIsUndefined(inbound_stream.nack_count);
hbos23351192017-01-02 06:52:19 -0800853 verifier.TestMemberIsNonNegative<double>(inbound_stream.jitter);
Eldar Rello4e5bc9f2020-07-06 14:18:07 +0300854 verifier.TestMemberIsNonNegative<double>(
855 inbound_stream.jitter_buffer_delay);
856 verifier.TestMemberIsNonNegative<uint64_t>(
857 inbound_stream.jitter_buffer_emitted_count);
858 verifier.TestMemberIsPositive<uint64_t>(
859 inbound_stream.total_samples_received);
860 verifier.TestMemberIsNonNegative<uint64_t>(
861 inbound_stream.concealed_samples);
862 verifier.TestMemberIsNonNegative<uint64_t>(
863 inbound_stream.silent_concealed_samples);
864 verifier.TestMemberIsNonNegative<uint64_t>(
865 inbound_stream.concealment_events);
866 verifier.TestMemberIsNonNegative<uint64_t>(
867 inbound_stream.inserted_samples_for_deceleration);
868 verifier.TestMemberIsNonNegative<uint64_t>(
869 inbound_stream.removed_samples_for_acceleration);
870 verifier.TestMemberIsPositive<double>(inbound_stream.audio_level);
871 verifier.TestMemberIsPositive<double>(inbound_stream.total_audio_energy);
872 verifier.TestMemberIsPositive<double>(
873 inbound_stream.total_samples_duration);
874 verifier.TestMemberIsUndefined(inbound_stream.frames_received);
hbosdb346a72016-11-29 01:57:01 -0800875 }
hbosa7a9be12017-03-01 01:02:45 -0800876 verifier.TestMemberIsUndefined(inbound_stream.round_trip_time);
hbosdb346a72016-11-29 01:57:01 -0800877 verifier.TestMemberIsUndefined(inbound_stream.packets_discarded);
878 verifier.TestMemberIsUndefined(inbound_stream.packets_repaired);
879 verifier.TestMemberIsUndefined(inbound_stream.burst_packets_lost);
880 verifier.TestMemberIsUndefined(inbound_stream.burst_packets_discarded);
881 verifier.TestMemberIsUndefined(inbound_stream.burst_loss_count);
882 verifier.TestMemberIsUndefined(inbound_stream.burst_discard_count);
883 verifier.TestMemberIsUndefined(inbound_stream.burst_loss_rate);
884 verifier.TestMemberIsUndefined(inbound_stream.burst_discard_rate);
885 verifier.TestMemberIsUndefined(inbound_stream.gap_loss_rate);
886 verifier.TestMemberIsUndefined(inbound_stream.gap_discard_rate);
Åsa Perssonfcf79cc2019-10-22 15:23:44 +0200887 // Test runtime too short to get an estimate (at least two RTCP sender
888 // reports need to be received).
889 verifier.MarkMemberTested(inbound_stream.estimated_playout_timestamp, true);
hbos6769c492017-01-02 08:35:13 -0800890 if (inbound_stream.media_type.is_defined() &&
891 *inbound_stream.media_type == "video") {
892 verifier.TestMemberIsDefined(inbound_stream.frames_decoded);
Rasmus Brandt2efae772019-06-27 14:29:34 +0200893 verifier.TestMemberIsDefined(inbound_stream.key_frames_decoded);
Eldar Rello4e5bc9f2020-07-06 14:18:07 +0300894 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frames_dropped);
Johannes Kronbfd343b2019-07-01 10:07:50 +0200895 verifier.TestMemberIsNonNegative<double>(
896 inbound_stream.total_decode_time);
Johannes Kron00376e12019-11-25 10:25:42 +0100897 verifier.TestMemberIsNonNegative<double>(
898 inbound_stream.total_inter_frame_delay);
899 verifier.TestMemberIsNonNegative<double>(
900 inbound_stream.total_squared_inter_frame_delay);
Henrik Boström2e069262019-04-09 13:59:31 +0200901 // The integration test is not set up to test screen share; don't require
902 // this to be present.
903 verifier.MarkMemberTested(inbound_stream.content_type, true);
hbos6769c492017-01-02 08:35:13 -0800904 } else {
905 verifier.TestMemberIsUndefined(inbound_stream.frames_decoded);
Rasmus Brandt2efae772019-06-27 14:29:34 +0200906 verifier.TestMemberIsUndefined(inbound_stream.key_frames_decoded);
Eldar Rello4e5bc9f2020-07-06 14:18:07 +0300907 verifier.TestMemberIsUndefined(inbound_stream.frames_dropped);
Johannes Kronbfd343b2019-07-01 10:07:50 +0200908 verifier.TestMemberIsUndefined(inbound_stream.total_decode_time);
Johannes Kron00376e12019-11-25 10:25:42 +0100909 verifier.TestMemberIsUndefined(inbound_stream.total_inter_frame_delay);
910 verifier.TestMemberIsUndefined(
911 inbound_stream.total_squared_inter_frame_delay);
Henrik Boström2e069262019-04-09 13:59:31 +0200912 verifier.TestMemberIsUndefined(inbound_stream.content_type);
hbos6769c492017-01-02 08:35:13 -0800913 }
hbosdb346a72016-11-29 01:57:01 -0800914 return verifier.ExpectAllMembersSuccessfullyTested();
915 }
916
917 bool VerifyRTCOutboundRTPStreamStats(
Eldar Rello9276e2c2020-06-10 17:53:39 +0300918 const RTCOutboundRTPStreamStats& outbound_stream) {
hbosdb346a72016-11-29 01:57:01 -0800919 RTCStatsVerifier verifier(report_, &outbound_stream);
920 VerifyRTCRTPStreamStats(outbound_stream, &verifier);
hbos6769c492017-01-02 08:35:13 -0800921 if (outbound_stream.media_type.is_defined() &&
922 *outbound_stream.media_type == "video") {
Henrik Boström646fda02019-05-22 15:49:42 +0200923 verifier.TestMemberIsIDReference(outbound_stream.media_source_id,
924 RTCVideoSourceStats::kType);
Di Wufd1e9d12021-03-09 09:25:28 -0800925 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.fir_count);
926 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.pli_count);
927 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.nack_count);
Henrik Boströma0ff50c2020-05-05 15:54:46 +0200928 if (*outbound_stream.frames_encoded > 0) {
929 verifier.TestMemberIsNonNegative<uint64_t>(outbound_stream.qp_sum);
930 } else {
931 verifier.TestMemberIsUndefined(outbound_stream.qp_sum);
932 }
hbos6769c492017-01-02 08:35:13 -0800933 } else {
Di Wufd1e9d12021-03-09 09:25:28 -0800934 verifier.TestMemberIsUndefined(outbound_stream.fir_count);
935 verifier.TestMemberIsUndefined(outbound_stream.pli_count);
936 verifier.TestMemberIsUndefined(outbound_stream.nack_count);
Henrik Boström646fda02019-05-22 15:49:42 +0200937 verifier.TestMemberIsIDReference(outbound_stream.media_source_id,
938 RTCAudioSourceStats::kType);
hbos6769c492017-01-02 08:35:13 -0800939 verifier.TestMemberIsUndefined(outbound_stream.qp_sum);
940 }
Di Wufd1e9d12021-03-09 09:25:28 -0800941 verifier.TestMemberIsDefined(outbound_stream.is_remote);
Henrik Boström4f40fa52019-12-19 13:27:27 +0100942 verifier.TestMemberIsOptionalIDReference(
943 outbound_stream.remote_id, RTCRemoteInboundRtpStreamStats::kType);
hbos23351192017-01-02 06:52:19 -0800944 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.packets_sent);
Henrik Boströmcf96e0f2019-04-17 13:51:53 +0200945 verifier.TestMemberIsNonNegative<uint64_t>(
946 outbound_stream.retransmitted_packets_sent);
hbos23351192017-01-02 06:52:19 -0800947 verifier.TestMemberIsNonNegative<uint64_t>(outbound_stream.bytes_sent);
Henrik Boströmcf96e0f2019-04-17 13:51:53 +0200948 verifier.TestMemberIsNonNegative<uint64_t>(
Niels Möllerac0a4cb2019-10-09 15:01:33 +0200949 outbound_stream.header_bytes_sent);
950 verifier.TestMemberIsNonNegative<uint64_t>(
Henrik Boströmcf96e0f2019-04-17 13:51:53 +0200951 outbound_stream.retransmitted_bytes_sent);
hbosdb346a72016-11-29 01:57:01 -0800952 verifier.TestMemberIsUndefined(outbound_stream.target_bitrate);
hbos6769c492017-01-02 08:35:13 -0800953 if (outbound_stream.media_type.is_defined() &&
954 *outbound_stream.media_type == "video") {
955 verifier.TestMemberIsDefined(outbound_stream.frames_encoded);
Rasmus Brandt2efae772019-06-27 14:29:34 +0200956 verifier.TestMemberIsDefined(outbound_stream.key_frames_encoded);
Henrik Boströmf71362f2019-04-08 16:14:23 +0200957 verifier.TestMemberIsNonNegative<double>(
958 outbound_stream.total_encode_time);
Henrik Boström23aff9b2019-05-20 15:15:38 +0200959 verifier.TestMemberIsNonNegative<uint64_t>(
960 outbound_stream.total_encoded_bytes_target);
Henrik Boström9fe18342019-05-16 18:38:20 +0200961 verifier.TestMemberIsNonNegative<double>(
962 outbound_stream.total_packet_send_delay);
Henrik Boströmce33b6a2019-05-28 17:42:38 +0200963 verifier.TestMemberIsDefined(outbound_stream.quality_limitation_reason);
Evan Shrubsolecc62b162019-09-09 11:26:45 +0200964 verifier.TestMemberIsNonNegative<uint32_t>(
965 outbound_stream.quality_limitation_resolution_changes);
Henrik Boström2e069262019-04-09 13:59:31 +0200966 // The integration test is not set up to test screen share; don't require
967 // this to be present.
968 verifier.MarkMemberTested(outbound_stream.content_type, true);
Henrik Boström6b430862019-08-16 13:09:51 +0200969 verifier.TestMemberIsDefined(outbound_stream.encoder_implementation);
Eldar Rello9276e2c2020-06-10 17:53:39 +0300970 // Unless an implementation-specific amount of time has passed and at
971 // least one frame has been encoded, undefined is reported. Because it
972 // is hard to tell what is the case here, we treat FPS as optional.
973 // TODO(hbos): Update the tests to run until all implemented metrics
974 // should be populated.
975 if (outbound_stream.frames_per_second.is_defined()) {
976 verifier.TestMemberIsNonNegative<double>(
977 outbound_stream.frames_per_second);
Henrik Boströma0ff50c2020-05-05 15:54:46 +0200978 } else {
979 verifier.TestMemberIsUndefined(outbound_stream.frames_per_second);
Henrik Boströma0ff50c2020-05-05 15:54:46 +0200980 }
Eldar Rello9276e2c2020-06-10 17:53:39 +0300981 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frame_height);
982 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frame_width);
983 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frames_sent);
984 verifier.TestMemberIsNonNegative<uint32_t>(
985 outbound_stream.huge_frames_sent);
986 verifier.MarkMemberTested(outbound_stream.rid, true);
hbos6769c492017-01-02 08:35:13 -0800987 } else {
988 verifier.TestMemberIsUndefined(outbound_stream.frames_encoded);
Rasmus Brandt2efae772019-06-27 14:29:34 +0200989 verifier.TestMemberIsUndefined(outbound_stream.key_frames_encoded);
Henrik Boströmf71362f2019-04-08 16:14:23 +0200990 verifier.TestMemberIsUndefined(outbound_stream.total_encode_time);
Henrik Boström23aff9b2019-05-20 15:15:38 +0200991 verifier.TestMemberIsUndefined(
992 outbound_stream.total_encoded_bytes_target);
Henrik Boström9fe18342019-05-16 18:38:20 +0200993 // TODO(https://crbug.com/webrtc/10635): Implement for audio as well.
994 verifier.TestMemberIsUndefined(outbound_stream.total_packet_send_delay);
Henrik Boströmce33b6a2019-05-28 17:42:38 +0200995 verifier.TestMemberIsUndefined(outbound_stream.quality_limitation_reason);
Evan Shrubsolecc62b162019-09-09 11:26:45 +0200996 verifier.TestMemberIsUndefined(
997 outbound_stream.quality_limitation_resolution_changes);
Henrik Boström2e069262019-04-09 13:59:31 +0200998 verifier.TestMemberIsUndefined(outbound_stream.content_type);
Henrik Boström6b430862019-08-16 13:09:51 +0200999 // TODO(hbos): Implement for audio as well.
1000 verifier.TestMemberIsUndefined(outbound_stream.encoder_implementation);
Henrik Boströma0ff50c2020-05-05 15:54:46 +02001001 verifier.TestMemberIsUndefined(outbound_stream.rid);
1002 verifier.TestMemberIsUndefined(outbound_stream.frames_per_second);
1003 verifier.TestMemberIsUndefined(outbound_stream.frame_height);
1004 verifier.TestMemberIsUndefined(outbound_stream.frame_width);
1005 verifier.TestMemberIsUndefined(outbound_stream.frames_sent);
1006 verifier.TestMemberIsUndefined(outbound_stream.huge_frames_sent);
hbos6769c492017-01-02 08:35:13 -08001007 }
hbosdb346a72016-11-29 01:57:01 -08001008 return verifier.ExpectAllMembersSuccessfullyTested();
1009 }
1010
Henrik Boström883eefc2019-05-27 13:40:25 +02001011 bool VerifyRTCRemoteInboundRtpStreamStats(
1012 const RTCRemoteInboundRtpStreamStats& remote_inbound_stream) {
1013 RTCStatsVerifier verifier(report_, &remote_inbound_stream);
1014 verifier.TestMemberIsDefined(remote_inbound_stream.ssrc);
1015 verifier.TestMemberIsDefined(remote_inbound_stream.kind);
1016 verifier.TestMemberIsIDReference(remote_inbound_stream.transport_id,
1017 RTCTransportStats::kType);
1018 verifier.TestMemberIsIDReference(remote_inbound_stream.codec_id,
1019 RTCCodecStats::kType);
1020 verifier.TestMemberIsDefined(remote_inbound_stream.packets_lost);
Di Wu86f04ad2021-02-28 23:36:03 -08001021 verifier.TestMemberIsDefined(remote_inbound_stream.fraction_lost);
Henrik Boström883eefc2019-05-27 13:40:25 +02001022 // Note that the existance of RTCCodecStats is needed for |codec_id| and
1023 // |jitter| to be present.
1024 verifier.TestMemberIsNonNegative<double>(remote_inbound_stream.jitter);
1025 verifier.TestMemberIsIDReference(remote_inbound_stream.local_id,
1026 RTCOutboundRTPStreamStats::kType);
1027 verifier.TestMemberIsNonNegative<double>(
1028 remote_inbound_stream.round_trip_time);
Di Wu88a51b22021-03-01 11:22:06 -08001029 verifier.TestMemberIsNonNegative<double>(
1030 remote_inbound_stream.total_round_trip_time);
1031 verifier.TestMemberIsNonNegative<int32_t>(
1032 remote_inbound_stream.round_trip_time_measurements);
Henrik Boström883eefc2019-05-27 13:40:25 +02001033 return verifier.ExpectAllMembersSuccessfullyTested();
1034 }
1035
Henrik Boström646fda02019-05-22 15:49:42 +02001036 void VerifyRTCMediaSourceStats(const RTCMediaSourceStats& media_source,
1037 RTCStatsVerifier* verifier) {
1038 verifier->TestMemberIsDefined(media_source.track_identifier);
1039 verifier->TestMemberIsDefined(media_source.kind);
1040 if (media_source.kind.is_defined()) {
1041 EXPECT_TRUE((*media_source.kind == "audio" &&
1042 media_source.type() == RTCAudioSourceStats::kType) ||
1043 (*media_source.kind == "video" &&
1044 media_source.type() == RTCVideoSourceStats::kType));
1045 }
1046 }
1047
1048 bool VerifyRTCAudioSourceStats(const RTCAudioSourceStats& audio_source) {
1049 RTCStatsVerifier verifier(report_, &audio_source);
1050 VerifyRTCMediaSourceStats(audio_source, &verifier);
Henrik Boström262bbae2019-09-13 11:34:55 +02001051 // Audio level, unlike audio energy, only gets updated at a certain
1052 // frequency, so we don't require that one to be positive to avoid a race
1053 // (https://crbug.com/webrtc/10962).
1054 verifier.TestMemberIsNonNegative<double>(audio_source.audio_level);
Henrik Boströmd2c336f2019-07-03 17:11:10 +02001055 verifier.TestMemberIsPositive<double>(audio_source.total_audio_energy);
1056 verifier.TestMemberIsPositive<double>(audio_source.total_samples_duration);
Henrik Boström646fda02019-05-22 15:49:42 +02001057 return verifier.ExpectAllMembersSuccessfullyTested();
1058 }
1059
1060 bool VerifyRTCVideoSourceStats(const RTCVideoSourceStats& video_source) {
1061 RTCStatsVerifier verifier(report_, &video_source);
1062 VerifyRTCMediaSourceStats(video_source, &verifier);
1063 // TODO(hbos): This integration test uses fakes that doesn't support
1064 // VideoTrackSourceInterface::Stats. When this is fixed we should
1065 // TestMemberIsNonNegative<uint32_t>() for |width| and |height| instead to
1066 // reflect real code.
1067 verifier.TestMemberIsUndefined(video_source.width);
1068 verifier.TestMemberIsUndefined(video_source.height);
Di Wu668dbf62021-02-27 00:29:15 -08001069 verifier.TestMemberIsNonNegative<uint32_t>(video_source.frames);
Henrik Boström646fda02019-05-22 15:49:42 +02001070 verifier.TestMemberIsNonNegative<uint32_t>(video_source.frames_per_second);
1071 return verifier.ExpectAllMembersSuccessfullyTested();
1072 }
1073
Yves Gerey665174f2018-06-19 15:03:05 +02001074 bool VerifyRTCTransportStats(const RTCTransportStats& transport) {
hbosdb346a72016-11-29 01:57:01 -08001075 RTCStatsVerifier verifier(report_, &transport);
hbos23351192017-01-02 06:52:19 -08001076 verifier.TestMemberIsNonNegative<uint64_t>(transport.bytes_sent);
Artem Titovedacbd52020-07-06 16:06:37 +02001077 verifier.TestMemberIsNonNegative<uint64_t>(transport.packets_sent);
hbos23351192017-01-02 06:52:19 -08001078 verifier.TestMemberIsNonNegative<uint64_t>(transport.bytes_received);
Artem Titovedacbd52020-07-06 16:06:37 +02001079 verifier.TestMemberIsNonNegative<uint64_t>(transport.packets_received);
Yves Gerey665174f2018-06-19 15:03:05 +02001080 verifier.TestMemberIsOptionalIDReference(transport.rtcp_transport_stats_id,
1081 RTCTransportStats::kType);
hbos7064d592017-01-16 07:38:02 -08001082 verifier.TestMemberIsDefined(transport.dtls_state);
Yves Gerey665174f2018-06-19 15:03:05 +02001083 verifier.TestMemberIsIDReference(transport.selected_candidate_pair_id,
1084 RTCIceCandidatePairStats::kType);
1085 verifier.TestMemberIsIDReference(transport.local_certificate_id,
1086 RTCCertificateStats::kType);
1087 verifier.TestMemberIsIDReference(transport.remote_certificate_id,
1088 RTCCertificateStats::kType);
Harald Alvestrand5cb78072019-10-28 09:51:17 +01001089 verifier.TestMemberIsDefined(transport.tls_version);
1090 verifier.TestMemberIsDefined(transport.dtls_cipher);
1091 verifier.TestMemberIsDefined(transport.srtp_cipher);
Jonas Oreland149dc722019-08-28 08:10:27 +02001092 verifier.TestMemberIsPositive<uint32_t>(
1093 transport.selected_candidate_pair_changes);
hbosdb346a72016-11-29 01:57:01 -08001094 return verifier.ExpectAllMembersSuccessfullyTested();
1095 }
1096
1097 private:
1098 rtc::scoped_refptr<const RTCStatsReport> report_;
1099};
1100
Mirko Bonadei5eb43b42021-01-18 13:24:40 +01001101#ifdef WEBRTC_HAVE_SCTP
hbosdb346a72016-11-29 01:57:01 -08001102TEST_F(RTCStatsIntegrationTest, GetStatsFromCaller) {
1103 StartCall();
1104
1105 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCaller();
Eldar Rello9276e2c2020-06-10 17:53:39 +03001106 RTCStatsReportVerifier(report.get()).VerifyReport({});
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001107
Henrik Boströma0ff50c2020-05-05 15:54:46 +02001108#if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 14:35:04 -07001109 EXPECT_EQ(report->ToJson(), RTCStatsReportTraceListener::last_trace());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001110 #endif
hbosdb346a72016-11-29 01:57:01 -08001111}
1112
1113TEST_F(RTCStatsIntegrationTest, GetStatsFromCallee) {
1114 StartCall();
1115
1116 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCallee();
Eldar Rello9276e2c2020-06-10 17:53:39 +03001117 RTCStatsReportVerifier(report.get()).VerifyReport({});
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001118
Henrik Boströma0ff50c2020-05-05 15:54:46 +02001119#if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 14:35:04 -07001120 EXPECT_EQ(report->ToJson(), RTCStatsReportTraceListener::last_trace());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001121 #endif
hbosdb346a72016-11-29 01:57:01 -08001122}
1123
Henrik Boström1df1bf82018-03-20 13:24:20 +01001124// These tests exercise the integration of the stats selection algorithm inside
1125// of PeerConnection. See rtcstatstraveral_unittest.cc for more detailed stats
1126// traversal tests on particular stats graphs.
1127TEST_F(RTCStatsIntegrationTest, GetStatsWithSenderSelector) {
1128 StartCall();
1129 ASSERT_FALSE(caller_->pc()->GetSenders().empty());
1130 rtc::scoped_refptr<const RTCStatsReport> report =
1131 GetStatsFromCaller(caller_->pc()->GetSenders()[0]);
1132 std::vector<const char*> allowed_missing_stats = {
1133 // TODO(hbos): Include RTC[Audio/Video]ReceiverStats when implemented.
1134 // TODO(hbos): Include RTCRemoteOutboundRtpStreamStats when implemented.
1135 // TODO(hbos): Include RTCRtpContributingSourceStats when implemented.
Jonas Olssona4d87372019-07-05 19:08:33 +02001136 RTCInboundRTPStreamStats::kType,
1137 RTCPeerConnectionStats::kType,
1138 RTCMediaStreamStats::kType,
1139 RTCDataChannelStats::kType,
Henrik Boström1df1bf82018-03-20 13:24:20 +01001140 };
Eldar Rello9276e2c2020-06-10 17:53:39 +03001141 RTCStatsReportVerifier(report.get()).VerifyReport(allowed_missing_stats);
Henrik Boström1df1bf82018-03-20 13:24:20 +01001142 EXPECT_TRUE(report->size());
1143}
1144
1145TEST_F(RTCStatsIntegrationTest, GetStatsWithReceiverSelector) {
1146 StartCall();
1147
1148 ASSERT_FALSE(caller_->pc()->GetReceivers().empty());
1149 rtc::scoped_refptr<const RTCStatsReport> report =
1150 GetStatsFromCaller(caller_->pc()->GetReceivers()[0]);
1151 std::vector<const char*> allowed_missing_stats = {
1152 // TODO(hbos): Include RTC[Audio/Video]SenderStats when implemented.
1153 // TODO(hbos): Include RTCRemoteInboundRtpStreamStats when implemented.
1154 // TODO(hbos): Include RTCRtpContributingSourceStats when implemented.
Jonas Olssona4d87372019-07-05 19:08:33 +02001155 RTCOutboundRTPStreamStats::kType,
1156 RTCPeerConnectionStats::kType,
1157 RTCMediaStreamStats::kType,
1158 RTCDataChannelStats::kType,
Henrik Boström1df1bf82018-03-20 13:24:20 +01001159 };
Eldar Rello9276e2c2020-06-10 17:53:39 +03001160 RTCStatsReportVerifier(report.get()).VerifyReport(allowed_missing_stats);
Henrik Boström1df1bf82018-03-20 13:24:20 +01001161 EXPECT_TRUE(report->size());
1162}
1163
1164TEST_F(RTCStatsIntegrationTest, GetStatsWithInvalidSenderSelector) {
1165 StartCall();
1166
1167 ASSERT_FALSE(callee_->pc()->GetSenders().empty());
1168 // The selector is invalid for the caller because it belongs to the callee.
1169 auto invalid_selector = callee_->pc()->GetSenders()[0];
1170 rtc::scoped_refptr<const RTCStatsReport> report =
1171 GetStatsFromCaller(invalid_selector);
1172 EXPECT_FALSE(report->size());
1173}
1174
1175TEST_F(RTCStatsIntegrationTest, GetStatsWithInvalidReceiverSelector) {
1176 StartCall();
1177
1178 ASSERT_FALSE(callee_->pc()->GetReceivers().empty());
1179 // The selector is invalid for the caller because it belongs to the callee.
1180 auto invalid_selector = callee_->pc()->GetReceivers()[0];
1181 rtc::scoped_refptr<const RTCStatsReport> report =
1182 GetStatsFromCaller(invalid_selector);
1183 EXPECT_FALSE(report->size());
1184}
1185
Yves Gerey59cfd352018-11-26 16:22:20 +01001186// TODO(bugs.webrtc.org/10041) For now this is equivalent to the following
1187// test GetsStatsWhileClosingPeerConnection, because pc() is closed by
1188// PeerConnectionTestWrapper. See: bugs.webrtc.org/9847
Yves Gereyb5bb5132018-11-14 18:00:14 +01001189TEST_F(RTCStatsIntegrationTest,
Yves Gerey59cfd352018-11-26 16:22:20 +01001190 DISABLED_GetStatsWhileDestroyingPeerConnection) {
hbosb78306a2016-12-19 05:06:57 -08001191 StartCall();
1192
1193 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
1194 RTCStatsObtainer::Create();
1195 caller_->pc()->GetStats(stats_obtainer);
1196 // This will destroy the peer connection.
1197 caller_ = nullptr;
1198 // Any pending stats requests should have completed in the act of destroying
1199 // the peer connection.
Steve Anton25cfeb92018-04-26 11:44:00 -07001200 ASSERT_TRUE(stats_obtainer->report());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001201 #if RTC_TRACE_EVENTS_ENABLED
Steve Anton25cfeb92018-04-26 11:44:00 -07001202 EXPECT_EQ(stats_obtainer->report()->ToJson(),
1203 RTCStatsReportTraceListener::last_trace());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001204 #endif
Steve Anton25cfeb92018-04-26 11:44:00 -07001205}
1206
1207TEST_F(RTCStatsIntegrationTest, GetsStatsWhileClosingPeerConnection) {
1208 StartCall();
1209
1210 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
1211 RTCStatsObtainer::Create();
1212 caller_->pc()->GetStats(stats_obtainer);
1213 caller_->pc()->Close();
1214
1215 ASSERT_TRUE(stats_obtainer->report());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001216 #if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 14:35:04 -07001217 EXPECT_EQ(stats_obtainer->report()->ToJson(),
1218 RTCStatsReportTraceListener::last_trace());
Doudou Kisabaka2dec4962019-11-28 14:24:31 +01001219 #endif
hbosb78306a2016-12-19 05:06:57 -08001220}
Henrik Boströmb6199362018-03-12 10:27:55 +01001221
1222// GetStatsReferencedIds() is optimized to recognize what is or isn't a
1223// referenced ID based on dictionary type information and knowing what members
1224// are used as references, as opposed to iterating all members to find the ones
1225// with the "Id" or "Ids" suffix. As such, GetStatsReferencedIds() is tested as
1226// an integration test instead of a unit test in order to guard against adding
1227// new references and forgetting to update GetStatsReferencedIds().
1228TEST_F(RTCStatsIntegrationTest, GetStatsReferencedIds) {
1229 StartCall();
1230
1231 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCallee();
1232 for (const RTCStats& stats : *report) {
1233 // Find all references by looking at all string members with the "Id" or
1234 // "Ids" suffix.
1235 std::set<const std::string*> expected_ids;
1236 for (const auto* member : stats.Members()) {
1237 if (!member->is_defined())
1238 continue;
1239 if (member->type() == RTCStatsMemberInterface::kString) {
Steve Anton68586e82018-12-13 17:41:25 -08001240 if (absl::EndsWith(member->name(), "Id")) {
Henrik Boströmb6199362018-03-12 10:27:55 +01001241 const auto& id = member->cast_to<const RTCStatsMember<std::string>>();
1242 expected_ids.insert(&(*id));
1243 }
1244 } else if (member->type() == RTCStatsMemberInterface::kSequenceString) {
Steve Anton68586e82018-12-13 17:41:25 -08001245 if (absl::EndsWith(member->name(), "Ids")) {
Henrik Boströmb6199362018-03-12 10:27:55 +01001246 const auto& ids =
1247 member->cast_to<const RTCStatsMember<std::vector<std::string>>>();
1248 for (const std::string& id : *ids)
1249 expected_ids.insert(&id);
1250 }
1251 }
1252 }
1253
1254 std::vector<const std::string*> neighbor_ids = GetStatsReferencedIds(stats);
1255 EXPECT_EQ(neighbor_ids.size(), expected_ids.size());
1256 for (const std::string* neighbor_id : neighbor_ids) {
Steve Anton64b626b2019-01-28 17:25:26 -08001257 EXPECT_THAT(expected_ids, Contains(neighbor_id));
Henrik Boströmb6199362018-03-12 10:27:55 +01001258 }
1259 for (const std::string* expected_id : expected_ids) {
Steve Anton64b626b2019-01-28 17:25:26 -08001260 EXPECT_THAT(neighbor_ids, Contains(expected_id));
Henrik Boströmb6199362018-03-12 10:27:55 +01001261 }
1262 }
1263}
Mirko Bonadei5eb43b42021-01-18 13:24:40 +01001264#endif // WEBRTC_HAVE_SCTP
hbosb78306a2016-12-19 05:06:57 -08001265
hbosdb346a72016-11-29 01:57:01 -08001266} // namespace
1267
1268} // namespace webrtc