blob: 598395af94974ea9e7269fad054ba9a1dc95bb6b [file] [log] [blame]
hbosdb346a72016-11-29 09:57:011/*
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 15:47:4911#include <stdint.h>
12#include <string.h>
Jonas Olssona4d87372019-07-05 17:08:3313
Yves Gerey3e707812018-11-28 15:47:4914#include <memory>
hbosdb346a72016-11-29 09:57:0115#include <set>
Yves Gerey3e707812018-11-28 15:47:4916#include <string>
hbosdb346a72016-11-29 09:57:0117#include <vector>
18
Steve Anton64b626b2019-01-29 01:25:2619#include "absl/algorithm/container.h"
Steve Anton68586e82018-12-14 01:41:2520#include "absl/strings/match.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3121#include "api/audio_codecs/builtin_audio_decoder_factory.h"
22#include "api/audio_codecs/builtin_audio_encoder_factory.h"
Yves Gerey3e707812018-11-28 15:47:4923#include "api/audio_options.h"
Steve Anton10542f22019-01-11 17:11:0024#include "api/data_channel_interface.h"
25#include "api/peer_connection_interface.h"
26#include "api/rtp_receiver_interface.h"
27#include "api/rtp_sender_interface.h"
Mirko Bonadeid9708072019-01-25 19:26:4828#include "api/scoped_refptr.h"
Steve Anton10542f22019-01-11 17:11:0029#include "api/stats/rtc_stats.h"
30#include "api/stats/rtc_stats_report.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3131#include "api/stats/rtcstats_objects.h"
Steve Anton10542f22019-01-11 17:11:0032#include "pc/rtc_stats_traversal.h"
33#include "pc/test/peer_connection_test_wrapper.h"
34#include "pc/test/rtc_stats_obtainer.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3135#include "rtc_base/checks.h"
36#include "rtc_base/event_tracer.h"
37#include "rtc_base/gunit.h"
Steve Anton10542f22019-01-11 17:11:0038#include "rtc_base/ref_counted_object.h"
Yves Gerey3e707812018-11-28 15:47:4939#include "rtc_base/thread.h"
Mirko Bonadei92ea95e2017-09-15 04:47:3140#include "rtc_base/trace_event.h"
Steve Anton10542f22019-01-11 17:11:0041#include "rtc_base/virtual_socket_server.h"
Steve Anton64b626b2019-01-29 01:25:2642#include "test/gmock.h"
Yves Gerey3e707812018-11-28 15:47:4943#include "test/gtest.h"
hbosdb346a72016-11-29 09:57:0144
Steve Anton64b626b2019-01-29 01:25:2645using ::testing::Contains;
46
hbosdb346a72016-11-29 09:57:0147namespace webrtc {
48
49namespace {
50
51const int64_t kGetStatsTimeoutMs = 10000;
52
ehmaldonado80c829f2017-07-18 14:35:1953const unsigned char* GetCategoryEnabledHandler(const char* name) {
ehmaldonado8ab0fd82017-09-04 21:35:0454 if (strcmp("webrtc_stats", name) != 0) {
55 return reinterpret_cast<const unsigned char*>("");
56 }
57 return reinterpret_cast<const unsigned char*>(name);
ehmaldonado80c829f2017-07-18 14:35:1958}
59
ehmaldonado8ab0fd82017-09-04 21:35:0460class RTCStatsReportTraceListener {
61 public:
62 static void SetUp() {
63 if (!traced_report_)
64 traced_report_ = new RTCStatsReportTraceListener();
65 traced_report_->last_trace_ = "";
66 SetupEventTracer(&GetCategoryEnabledHandler,
67 &RTCStatsReportTraceListener::AddTraceEventHandler);
68 }
69
70 static const std::string& last_trace() {
71 RTC_DCHECK(traced_report_);
72 return traced_report_->last_trace_;
73 }
74
75 private:
Steve Anton36b29d12017-10-30 16:57:4276 static void AddTraceEventHandler(
77 char phase,
78 const unsigned char* category_enabled,
79 const char* name,
80 unsigned long long id, // NOLINT(runtime/int)
81 int num_args,
82 const char** arg_names,
83 const unsigned char* arg_types,
84 const unsigned long long* arg_values, // NOLINT(runtime/int)
85 unsigned char flags) {
ehmaldonado8ab0fd82017-09-04 21:35:0486 RTC_DCHECK(traced_report_);
87 EXPECT_STREQ("webrtc_stats",
88 reinterpret_cast<const char*>(category_enabled));
89 EXPECT_STREQ("webrtc_stats", name);
90 EXPECT_EQ(1, num_args);
91 EXPECT_STREQ("report", arg_names[0]);
92 EXPECT_EQ(TRACE_VALUE_TYPE_COPY_STRING, arg_types[0]);
93
94 traced_report_->last_trace_ = reinterpret_cast<const char*>(arg_values[0]);
95 }
96
97 static RTCStatsReportTraceListener* traced_report_;
98 std::string last_trace_;
99};
100
101RTCStatsReportTraceListener* RTCStatsReportTraceListener::traced_report_ =
102 nullptr;
ehmaldonado80c829f2017-07-18 14:35:19103
Mirko Bonadei6a489f22019-04-09 13:11:12104class RTCStatsIntegrationTest : public ::testing::Test {
hbosdb346a72016-11-29 09:57:01105 public:
106 RTCStatsIntegrationTest()
tommie7251592017-07-14 21:44:46107 : network_thread_(new rtc::Thread(&virtual_socket_server_)),
108 worker_thread_(rtc::Thread::Create()) {
ehmaldonado8ab0fd82017-09-04 21:35:04109 RTCStatsReportTraceListener::SetUp();
ehmaldonado80c829f2017-07-18 14:35:19110
tommie7251592017-07-14 21:44:46111 RTC_CHECK(network_thread_->Start());
112 RTC_CHECK(worker_thread_->Start());
hbosdb346a72016-11-29 09:57:01113
Tommi87f70902021-04-27 12:43:08114 caller_ = rtc::make_ref_counted<PeerConnectionTestWrapper>(
tommie7251592017-07-14 21:44:46115 "caller", network_thread_.get(), worker_thread_.get());
Tommi87f70902021-04-27 12:43:08116 callee_ = rtc::make_ref_counted<PeerConnectionTestWrapper>(
tommie7251592017-07-14 21:44:46117 "callee", network_thread_.get(), worker_thread_.get());
hbosdb346a72016-11-29 09:57:01118 }
119
120 void StartCall() {
121 // Create PeerConnections and "connect" sigslots
122 PeerConnectionInterface::RTCConfiguration config;
Henrik Boström62995db2022-01-03 08:58:10123 config.sdp_semantics = SdpSemantics::kUnifiedPlan;
hbosdb346a72016-11-29 09:57:01124 PeerConnectionInterface::IceServer ice_server;
125 ice_server.uri = "stun:1.1.1.1:3478";
126 config.servers.push_back(ice_server);
Niels Möllerf06f9232018-08-07 10:32:18127 EXPECT_TRUE(caller_->CreatePc(config, CreateBuiltinAudioEncoderFactory(),
kwiberg9e5b11e2017-04-19 10:47:57128 CreateBuiltinAudioDecoderFactory()));
Niels Möllerf06f9232018-08-07 10:32:18129 EXPECT_TRUE(callee_->CreatePc(config, CreateBuiltinAudioEncoderFactory(),
kwiberg9e5b11e2017-04-19 10:47:57130 CreateBuiltinAudioDecoderFactory()));
hbosdb346a72016-11-29 09:57:01131 PeerConnectionTestWrapper::Connect(caller_.get(), callee_.get());
132
133 // Get user media for audio and video
Niels Möller5c4ddad2019-02-12 11:30:58134 caller_->GetAndAddUserMedia(true, cricket::AudioOptions(), true);
135 callee_->GetAndAddUserMedia(true, cricket::AudioOptions(), true);
hbosdb346a72016-11-29 09:57:01136
137 // Create data channels
138 DataChannelInit init;
139 caller_->CreateDataChannel("data", init);
140 callee_->CreateDataChannel("data", init);
141
142 // Negotiate and wait for call to establish
Niels Möllerf06f9232018-08-07 10:32:18143 caller_->CreateOffer(PeerConnectionInterface::RTCOfferAnswerOptions());
hbosdb346a72016-11-29 09:57:01144 caller_->WaitForCallEstablished();
145 callee_->WaitForCallEstablished();
146 }
147
148 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller() {
149 return GetStats(caller_->pc());
150 }
Henrik Boström1df1bf82018-03-20 12:24:20151 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller(
152 rtc::scoped_refptr<RtpSenderInterface> selector) {
153 return GetStats(caller_->pc(), selector);
154 }
155 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCaller(
156 rtc::scoped_refptr<RtpReceiverInterface> selector) {
157 return GetStats(caller_->pc(), selector);
158 }
hbosdb346a72016-11-29 09:57:01159
160 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee() {
161 return GetStats(callee_->pc());
162 }
Henrik Boström1df1bf82018-03-20 12:24:20163 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee(
164 rtc::scoped_refptr<RtpSenderInterface> selector) {
165 return GetStats(callee_->pc(), selector);
166 }
167 rtc::scoped_refptr<const RTCStatsReport> GetStatsFromCallee(
168 rtc::scoped_refptr<RtpReceiverInterface> selector) {
169 return GetStats(callee_->pc(), selector);
170 }
hbosdb346a72016-11-29 09:57:01171
172 protected:
173 static rtc::scoped_refptr<const RTCStatsReport> GetStats(
174 PeerConnectionInterface* pc) {
175 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
176 RTCStatsObtainer::Create();
Niels Möllerafb246b2022-04-20 12:26:50177 pc->GetStats(stats_obtainer.get());
178 EXPECT_TRUE_WAIT(stats_obtainer->report() != nullptr, kGetStatsTimeoutMs);
hbosdb346a72016-11-29 09:57:01179 return stats_obtainer->report();
180 }
181
Henrik Boström1df1bf82018-03-20 12:24:20182 template <typename T>
183 static rtc::scoped_refptr<const RTCStatsReport> GetStats(
184 PeerConnectionInterface* pc,
185 rtc::scoped_refptr<T> selector) {
186 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
187 RTCStatsObtainer::Create();
188 pc->GetStats(selector, stats_obtainer);
Niels Möllerafb246b2022-04-20 12:26:50189 EXPECT_TRUE_WAIT(stats_obtainer->report() != nullptr, kGetStatsTimeoutMs);
Henrik Boström1df1bf82018-03-20 12:24:20190 return stats_obtainer->report();
191 }
192
Artem Titov880fa812021-07-30 20:30:23193 // `network_thread_` uses `virtual_socket_server_` so they must be
deadbeef98e186c2017-05-17 01:00:06194 // constructed/destructed in the correct order.
hbosdb346a72016-11-29 09:57:01195 rtc::VirtualSocketServer virtual_socket_server_;
tommie7251592017-07-14 21:44:46196 std::unique_ptr<rtc::Thread> network_thread_;
197 std::unique_ptr<rtc::Thread> worker_thread_;
hbosdb346a72016-11-29 09:57:01198 rtc::scoped_refptr<PeerConnectionTestWrapper> caller_;
199 rtc::scoped_refptr<PeerConnectionTestWrapper> callee_;
200};
201
202class RTCStatsVerifier {
203 public:
204 RTCStatsVerifier(const RTCStatsReport* report, const RTCStats* stats)
205 : report_(report), stats_(stats), all_tests_successful_(true) {
206 RTC_CHECK(report_);
207 RTC_CHECK(stats_);
208 for (const RTCStatsMemberInterface* member : stats_->Members()) {
209 untested_members_.insert(member);
210 }
211 }
212
Yves Gerey665174f2018-06-19 13:03:05213 void MarkMemberTested(const RTCStatsMemberInterface& member,
214 bool test_successful) {
hbosdb346a72016-11-29 09:57:01215 untested_members_.erase(&member);
216 all_tests_successful_ &= test_successful;
217 }
218
219 void TestMemberIsDefined(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 13:03:05220 EXPECT_TRUE(member.is_defined())
221 << stats_->type() << "." << member.name() << "[" << stats_->id()
222 << "] was undefined.";
hbosdb346a72016-11-29 09:57:01223 MarkMemberTested(member, member.is_defined());
224 }
225
226 void TestMemberIsUndefined(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 13:03:05227 EXPECT_FALSE(member.is_defined())
228 << stats_->type() << "." << member.name() << "[" << stats_->id()
229 << "] was defined (" << member.ValueToString() << ").";
hbosdb346a72016-11-29 09:57:01230 MarkMemberTested(member, !member.is_defined());
231 }
232
Yves Gerey665174f2018-06-19 13:03:05233 template <typename T>
hbos23351192017-01-02 14:52:19234 void TestMemberIsPositive(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 13:03:05235 EXPECT_TRUE(member.is_defined())
236 << stats_->type() << "." << member.name() << "[" << stats_->id()
237 << "] was undefined.";
hbos23351192017-01-02 14:52:19238 if (!member.is_defined()) {
239 MarkMemberTested(member, false);
240 return;
241 }
242 bool is_positive = *member.cast_to<RTCStatsMember<T>>() > T(0);
Yves Gerey665174f2018-06-19 13:03:05243 EXPECT_TRUE(is_positive)
244 << stats_->type() << "." << member.name() << "[" << stats_->id()
245 << "] was not positive (" << member.ValueToString() << ").";
hbos23351192017-01-02 14:52:19246 MarkMemberTested(member, is_positive);
247 }
248
Yves Gerey665174f2018-06-19 13:03:05249 template <typename T>
hbos23351192017-01-02 14:52:19250 void TestMemberIsNonNegative(const RTCStatsMemberInterface& member) {
Yves Gerey665174f2018-06-19 13:03:05251 EXPECT_TRUE(member.is_defined())
252 << stats_->type() << "." << member.name() << "[" << stats_->id()
253 << "] was undefined.";
hbos23351192017-01-02 14:52:19254 if (!member.is_defined()) {
255 MarkMemberTested(member, false);
256 return;
257 }
258 bool is_non_negative = *member.cast_to<RTCStatsMember<T>>() >= T(0);
Yves Gerey665174f2018-06-19 13:03:05259 EXPECT_TRUE(is_non_negative)
260 << stats_->type() << "." << member.name() << "[" << stats_->id()
261 << "] was not non-negative (" << member.ValueToString() << ").";
hbos23351192017-01-02 14:52:19262 MarkMemberTested(member, is_non_negative);
263 }
264
Yves Gerey665174f2018-06-19 13:03:05265 void TestMemberIsIDReference(const RTCStatsMemberInterface& member,
266 const char* expected_type) {
hbosdb346a72016-11-29 09:57:01267 TestMemberIsIDReference(member, expected_type, false);
268 }
269
Yves Gerey665174f2018-06-19 13:03:05270 void TestMemberIsOptionalIDReference(const RTCStatsMemberInterface& member,
271 const char* expected_type) {
hbosdb346a72016-11-29 09:57:01272 TestMemberIsIDReference(member, expected_type, true);
273 }
274
275 bool ExpectAllMembersSuccessfullyTested() {
276 if (untested_members_.empty())
277 return all_tests_successful_;
278 for (const RTCStatsMemberInterface* member : untested_members_) {
Yves Gerey665174f2018-06-19 13:03:05279 EXPECT_TRUE(false) << stats_->type() << "." << member->name() << "["
280 << stats_->id() << "] was not tested.";
hbosdb346a72016-11-29 09:57:01281 }
282 return false;
283 }
284
285 private:
Yves Gerey665174f2018-06-19 13:03:05286 void TestMemberIsIDReference(const RTCStatsMemberInterface& member,
287 const char* expected_type,
288 bool optional) {
hbosdb346a72016-11-29 09:57:01289 if (optional && !member.is_defined()) {
290 MarkMemberTested(member, true);
291 return;
292 }
293 bool valid_reference = false;
294 if (member.is_defined()) {
295 if (member.type() == RTCStatsMemberInterface::kString) {
296 // A single ID.
297 const RTCStatsMember<std::string>& id =
298 member.cast_to<RTCStatsMember<std::string>>();
299 const RTCStats* referenced_stats = report_->Get(*id);
300 valid_reference =
301 referenced_stats && referenced_stats->type() == expected_type;
302 } else if (member.type() == RTCStatsMemberInterface::kSequenceString) {
303 // A vector of IDs.
304 valid_reference = true;
305 const RTCStatsMember<std::vector<std::string>>& ids =
306 member.cast_to<RTCStatsMember<std::vector<std::string>>>();
Mirko Bonadeic61ce0d2017-11-21 16:04:20307 for (const std::string& id : *ids) {
hbosdb346a72016-11-29 09:57:01308 const RTCStats* referenced_stats = report_->Get(id);
309 if (!referenced_stats || referenced_stats->type() != expected_type) {
310 valid_reference = false;
311 break;
312 }
313 }
314 }
315 }
Yves Gerey665174f2018-06-19 13:03:05316 EXPECT_TRUE(valid_reference)
317 << stats_->type() << "." << member.name()
318 << " is not a reference to an "
Jonas Olssonb2b20312020-01-14 11:11:31319 "existing dictionary of type "
320 << expected_type << " (value: "
Henrik Boström646fda02019-05-22 13:49:42321 << (member.is_defined() ? member.ValueToString() : "null") << ").";
hbosdb346a72016-11-29 09:57:01322 MarkMemberTested(member, valid_reference);
323 }
324
325 rtc::scoped_refptr<const RTCStatsReport> report_;
326 const RTCStats* stats_;
327 std::set<const RTCStatsMemberInterface*> untested_members_;
328 bool all_tests_successful_;
329};
330
331class RTCStatsReportVerifier {
332 public:
333 static std::set<const char*> StatsTypes() {
334 std::set<const char*> stats_types;
335 stats_types.insert(RTCCertificateStats::kType);
336 stats_types.insert(RTCCodecStats::kType);
337 stats_types.insert(RTCDataChannelStats::kType);
338 stats_types.insert(RTCIceCandidatePairStats::kType);
339 stats_types.insert(RTCLocalIceCandidateStats::kType);
340 stats_types.insert(RTCRemoteIceCandidateStats::kType);
341 stats_types.insert(RTCMediaStreamStats::kType);
342 stats_types.insert(RTCMediaStreamTrackStats::kType);
343 stats_types.insert(RTCPeerConnectionStats::kType);
344 stats_types.insert(RTCInboundRTPStreamStats::kType);
345 stats_types.insert(RTCOutboundRTPStreamStats::kType);
346 stats_types.insert(RTCTransportStats::kType);
347 return stats_types;
348 }
349
350 explicit RTCStatsReportVerifier(const RTCStatsReport* report)
Yves Gerey665174f2018-06-19 13:03:05351 : report_(report) {}
hbosdb346a72016-11-29 09:57:01352
Eldar Rello9276e2c2020-06-10 14:53:39353 void VerifyReport(std::vector<const char*> allowed_missing_stats) {
hbosdb346a72016-11-29 09:57:01354 std::set<const char*> missing_stats = StatsTypes();
355 bool verify_successful = true;
hbos338f78a2017-02-07 14:41:21356 std::vector<const RTCTransportStats*> transport_stats =
357 report_->GetStatsOfType<RTCTransportStats>();
Mirko Bonadeie12c1fe2018-07-03 10:53:23358 EXPECT_EQ(transport_stats.size(), 1U);
hbos338f78a2017-02-07 14:41:21359 std::string selected_candidate_pair_id =
360 *transport_stats[0]->selected_candidate_pair_id;
hbosdb346a72016-11-29 09:57:01361 for (const RTCStats& stats : *report_) {
362 missing_stats.erase(stats.type());
363 if (stats.type() == RTCCertificateStats::kType) {
Yves Gerey665174f2018-06-19 13:03:05364 verify_successful &=
365 VerifyRTCCertificateStats(stats.cast_to<RTCCertificateStats>());
hbosdb346a72016-11-29 09:57:01366 } else if (stats.type() == RTCCodecStats::kType) {
Yves Gerey665174f2018-06-19 13:03:05367 verify_successful &=
368 VerifyRTCCodecStats(stats.cast_to<RTCCodecStats>());
hbosdb346a72016-11-29 09:57:01369 } else if (stats.type() == RTCDataChannelStats::kType) {
Yves Gerey665174f2018-06-19 13:03:05370 verify_successful &=
371 VerifyRTCDataChannelStats(stats.cast_to<RTCDataChannelStats>());
hbosdb346a72016-11-29 09:57:01372 } else if (stats.type() == RTCIceCandidatePairStats::kType) {
373 verify_successful &= VerifyRTCIceCandidatePairStats(
hbos338f78a2017-02-07 14:41:21374 stats.cast_to<RTCIceCandidatePairStats>(),
375 stats.id() == selected_candidate_pair_id);
hbosdb346a72016-11-29 09:57:01376 } else if (stats.type() == RTCLocalIceCandidateStats::kType) {
377 verify_successful &= VerifyRTCLocalIceCandidateStats(
378 stats.cast_to<RTCLocalIceCandidateStats>());
379 } else if (stats.type() == RTCRemoteIceCandidateStats::kType) {
380 verify_successful &= VerifyRTCRemoteIceCandidateStats(
381 stats.cast_to<RTCRemoteIceCandidateStats>());
382 } else if (stats.type() == RTCMediaStreamStats::kType) {
Yves Gerey665174f2018-06-19 13:03:05383 verify_successful &=
384 VerifyRTCMediaStreamStats(stats.cast_to<RTCMediaStreamStats>());
hbosdb346a72016-11-29 09:57:01385 } else if (stats.type() == RTCMediaStreamTrackStats::kType) {
386 verify_successful &= VerifyRTCMediaStreamTrackStats(
387 stats.cast_to<RTCMediaStreamTrackStats>());
388 } else if (stats.type() == RTCPeerConnectionStats::kType) {
389 verify_successful &= VerifyRTCPeerConnectionStats(
390 stats.cast_to<RTCPeerConnectionStats>());
391 } else if (stats.type() == RTCInboundRTPStreamStats::kType) {
392 verify_successful &= VerifyRTCInboundRTPStreamStats(
393 stats.cast_to<RTCInboundRTPStreamStats>());
394 } else if (stats.type() == RTCOutboundRTPStreamStats::kType) {
395 verify_successful &= VerifyRTCOutboundRTPStreamStats(
Eldar Rello9276e2c2020-06-10 14:53:39396 stats.cast_to<RTCOutboundRTPStreamStats>());
Henrik Boström883eefc2019-05-27 11:40:25397 } else if (stats.type() == RTCRemoteInboundRtpStreamStats::kType) {
398 verify_successful &= VerifyRTCRemoteInboundRtpStreamStats(
399 stats.cast_to<RTCRemoteInboundRtpStreamStats>());
Alessio Bazzicaf7b1b952021-03-23 16:23:04400 } else if (stats.type() == RTCRemoteOutboundRtpStreamStats::kType) {
401 verify_successful &= VerifyRTCRemoteOutboundRTPStreamStats(
402 stats.cast_to<RTCRemoteOutboundRtpStreamStats>());
Henrik Boström646fda02019-05-22 13:49:42403 } else if (stats.type() == RTCAudioSourceStats::kType) {
404 // RTCAudioSourceStats::kType and RTCVideoSourceStats::kType both have
405 // the value "media-source", but they are distinguishable with pointer
Artem Titov880fa812021-07-30 20:30:23406 // equality (==). In JavaScript they would be distinguished with `kind`.
Henrik Boström646fda02019-05-22 13:49:42407 verify_successful &=
408 VerifyRTCAudioSourceStats(stats.cast_to<RTCAudioSourceStats>());
409 } else if (stats.type() == RTCVideoSourceStats::kType) {
410 // RTCAudioSourceStats::kType and RTCVideoSourceStats::kType both have
411 // the value "media-source", but they are distinguishable with pointer
Artem Titov880fa812021-07-30 20:30:23412 // equality (==). In JavaScript they would be distinguished with `kind`.
Henrik Boström646fda02019-05-22 13:49:42413 verify_successful &=
414 VerifyRTCVideoSourceStats(stats.cast_to<RTCVideoSourceStats>());
hbosdb346a72016-11-29 09:57:01415 } else if (stats.type() == RTCTransportStats::kType) {
Yves Gerey665174f2018-06-19 13:03:05416 verify_successful &=
417 VerifyRTCTransportStats(stats.cast_to<RTCTransportStats>());
hbosdb346a72016-11-29 09:57:01418 } else {
419 EXPECT_TRUE(false) << "Unrecognized stats type: " << stats.type();
420 verify_successful = false;
421 }
422 }
Henrik Boström1df1bf82018-03-20 12:24:20423 for (const char* missing : missing_stats) {
Steve Anton64b626b2019-01-29 01:25:26424 if (!absl::c_linear_search(allowed_missing_stats, missing)) {
Henrik Boström1df1bf82018-03-20 12:24:20425 verify_successful = false;
hbosdb346a72016-11-29 09:57:01426 EXPECT_TRUE(false) << "Missing expected stats type: " << missing;
427 }
428 }
Yves Gerey665174f2018-06-19 13:03:05429 EXPECT_TRUE(verify_successful)
430 << "One or more problems with the stats. This is the report:\n"
431 << report_->ToJson();
hbosdb346a72016-11-29 09:57:01432 }
433
Yves Gerey665174f2018-06-19 13:03:05434 bool VerifyRTCCertificateStats(const RTCCertificateStats& certificate) {
Niels Möllerafb246b2022-04-20 12:26:50435 RTCStatsVerifier verifier(report_.get(), &certificate);
hbosdb346a72016-11-29 09:57:01436 verifier.TestMemberIsDefined(certificate.fingerprint);
437 verifier.TestMemberIsDefined(certificate.fingerprint_algorithm);
438 verifier.TestMemberIsDefined(certificate.base64_certificate);
Yves Gerey665174f2018-06-19 13:03:05439 verifier.TestMemberIsOptionalIDReference(certificate.issuer_certificate_id,
440 RTCCertificateStats::kType);
hbosdb346a72016-11-29 09:57:01441 return verifier.ExpectAllMembersSuccessfullyTested();
442 }
443
Yves Gerey665174f2018-06-19 13:03:05444 bool VerifyRTCCodecStats(const RTCCodecStats& codec) {
Niels Möllerafb246b2022-04-20 12:26:50445 RTCStatsVerifier verifier(report_.get(), &codec);
Philipp Hancke95157a02020-11-16 19:08:27446 verifier.TestMemberIsIDReference(codec.transport_id,
447 RTCTransportStats::kType);
hbosdb346a72016-11-29 09:57:01448 verifier.TestMemberIsDefined(codec.payload_type);
hbos13f54b22017-02-28 14:56:04449 verifier.TestMemberIsDefined(codec.mime_type);
hbos23351192017-01-02 14:52:19450 verifier.TestMemberIsPositive<uint32_t>(codec.clock_rate);
Johannes Kron72d69152020-02-10 13:05:55451
452 if (codec.mime_type->rfind("audio", 0) == 0)
453 verifier.TestMemberIsPositive<uint32_t>(codec.channels);
454 else
455 verifier.TestMemberIsUndefined(codec.channels);
456
457 // sdp_fmtp_line is an optional field.
458 verifier.MarkMemberTested(codec.sdp_fmtp_line, true);
hbosdb346a72016-11-29 09:57:01459 return verifier.ExpectAllMembersSuccessfullyTested();
460 }
461
Yves Gerey665174f2018-06-19 13:03:05462 bool VerifyRTCDataChannelStats(const RTCDataChannelStats& data_channel) {
Niels Möllerafb246b2022-04-20 12:26:50463 RTCStatsVerifier verifier(report_.get(), &data_channel);
hbosdb346a72016-11-29 09:57:01464 verifier.TestMemberIsDefined(data_channel.label);
465 verifier.TestMemberIsDefined(data_channel.protocol);
Harald Alvestrand10ef8472020-06-05 13:38:51466 verifier.TestMemberIsDefined(data_channel.data_channel_identifier);
hbosdb346a72016-11-29 09:57:01467 verifier.TestMemberIsDefined(data_channel.state);
hbos23351192017-01-02 14:52:19468 verifier.TestMemberIsNonNegative<uint32_t>(data_channel.messages_sent);
469 verifier.TestMemberIsNonNegative<uint64_t>(data_channel.bytes_sent);
470 verifier.TestMemberIsNonNegative<uint32_t>(data_channel.messages_received);
471 verifier.TestMemberIsNonNegative<uint64_t>(data_channel.bytes_received);
hbosdb346a72016-11-29 09:57:01472 return verifier.ExpectAllMembersSuccessfullyTested();
473 }
474
475 bool VerifyRTCIceCandidatePairStats(
Yves Gerey665174f2018-06-19 13:03:05476 const RTCIceCandidatePairStats& candidate_pair,
477 bool is_selected_pair) {
Niels Möllerafb246b2022-04-20 12:26:50478 RTCStatsVerifier verifier(report_.get(), &candidate_pair);
Yves Gerey665174f2018-06-19 13:03:05479 verifier.TestMemberIsIDReference(candidate_pair.transport_id,
480 RTCTransportStats::kType);
481 verifier.TestMemberIsIDReference(candidate_pair.local_candidate_id,
482 RTCLocalIceCandidateStats::kType);
483 verifier.TestMemberIsIDReference(candidate_pair.remote_candidate_id,
484 RTCRemoteIceCandidateStats::kType);
hbos06495bc2017-01-02 16:08:18485 verifier.TestMemberIsDefined(candidate_pair.state);
486 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.priority);
hbos92eaec62017-02-27 09:38:08487 verifier.TestMemberIsDefined(candidate_pair.nominated);
hbosdb346a72016-11-29 09:57:01488 verifier.TestMemberIsDefined(candidate_pair.writable);
489 verifier.TestMemberIsUndefined(candidate_pair.readable);
Taylor Brandstetter79326ea2021-09-28 22:09:53490 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.packets_sent);
491 verifier.TestMemberIsNonNegative<uint64_t>(
492 candidate_pair.packets_discarded_on_send);
493 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.packets_received);
hbos23351192017-01-02 14:52:19494 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.bytes_sent);
Taylor Brandstetter79326ea2021-09-28 22:09:53495 verifier.TestMemberIsNonNegative<uint64_t>(
496 candidate_pair.bytes_discarded_on_send);
hbos23351192017-01-02 14:52:19497 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.bytes_received);
hbosbf8d3e52017-02-28 14:34:47498 verifier.TestMemberIsNonNegative<double>(
499 candidate_pair.total_round_trip_time);
hbos23351192017-01-02 14:52:19500 verifier.TestMemberIsNonNegative<double>(
501 candidate_pair.current_round_trip_time);
hbos338f78a2017-02-07 14:41:21502 if (is_selected_pair) {
503 verifier.TestMemberIsNonNegative<double>(
504 candidate_pair.available_outgoing_bitrate);
deadbeef86c40a12017-06-28 16:37:23505 // A pair should be nominated in order to be selected.
506 EXPECT_TRUE(*candidate_pair.nominated);
hbos338f78a2017-02-07 14:41:21507 } else {
508 verifier.TestMemberIsUndefined(candidate_pair.available_outgoing_bitrate);
509 }
hbosdb346a72016-11-29 09:57:01510 verifier.TestMemberIsUndefined(candidate_pair.available_incoming_bitrate);
hbos23351192017-01-02 14:52:19511 verifier.TestMemberIsNonNegative<uint64_t>(
512 candidate_pair.requests_received);
513 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.requests_sent);
514 verifier.TestMemberIsNonNegative<uint64_t>(
515 candidate_pair.responses_received);
516 verifier.TestMemberIsNonNegative<uint64_t>(candidate_pair.responses_sent);
hbosdb346a72016-11-29 09:57:01517 verifier.TestMemberIsUndefined(candidate_pair.retransmissions_received);
518 verifier.TestMemberIsUndefined(candidate_pair.retransmissions_sent);
519 verifier.TestMemberIsUndefined(candidate_pair.consent_requests_received);
hbos23351192017-01-02 14:52:19520 verifier.TestMemberIsNonNegative<uint64_t>(
521 candidate_pair.consent_requests_sent);
hbosdb346a72016-11-29 09:57:01522 verifier.TestMemberIsUndefined(candidate_pair.consent_responses_received);
523 verifier.TestMemberIsUndefined(candidate_pair.consent_responses_sent);
Jonas Oreland0d13bbd2022-03-02 10:17:36524
hbosdb346a72016-11-29 09:57:01525 return verifier.ExpectAllMembersSuccessfullyTested();
526 }
527
Yves Gerey665174f2018-06-19 13:03:05528 bool VerifyRTCIceCandidateStats(const RTCIceCandidateStats& candidate) {
Niels Möllerafb246b2022-04-20 12:26:50529 RTCStatsVerifier verifier(report_.get(), &candidate);
Yves Gerey665174f2018-06-19 13:03:05530 verifier.TestMemberIsIDReference(candidate.transport_id,
531 RTCTransportStats::kType);
hbosc3a2b7f2017-01-02 12:46:15532 verifier.TestMemberIsDefined(candidate.is_remote);
Gary Liu37e489c2017-11-21 18:49:36533 if (*candidate.is_remote) {
534 verifier.TestMemberIsUndefined(candidate.network_type);
Jonas Oreland0d13bbd2022-03-02 10:17:36535 verifier.TestMemberIsUndefined(candidate.network_adapter_type);
536 verifier.TestMemberIsUndefined(candidate.vpn);
Gary Liu37e489c2017-11-21 18:49:36537 } else {
538 verifier.TestMemberIsDefined(candidate.network_type);
Jonas Oreland0d13bbd2022-03-02 10:17:36539 verifier.TestMemberIsDefined(candidate.network_adapter_type);
540 verifier.TestMemberIsDefined(candidate.vpn);
Gary Liu37e489c2017-11-21 18:49:36541 }
hbosdb346a72016-11-29 09:57:01542 verifier.TestMemberIsDefined(candidate.ip);
Philipp Hanckea9ba4502021-03-22 12:22:54543 verifier.TestMemberIsDefined(candidate.address);
hbos23351192017-01-02 14:52:19544 verifier.TestMemberIsNonNegative<int32_t>(candidate.port);
hbosdb346a72016-11-29 09:57:01545 verifier.TestMemberIsDefined(candidate.protocol);
546 verifier.TestMemberIsDefined(candidate.candidate_type);
hbos23351192017-01-02 14:52:19547 verifier.TestMemberIsNonNegative<int32_t>(candidate.priority);
hbosdb346a72016-11-29 09:57:01548 verifier.TestMemberIsUndefined(candidate.url);
Philipp Hancke95513752018-09-27 12:40:08549 verifier.TestMemberIsUndefined(candidate.relay_protocol);
hbosdb346a72016-11-29 09:57:01550 return verifier.ExpectAllMembersSuccessfullyTested();
551 }
552
553 bool VerifyRTCLocalIceCandidateStats(
554 const RTCLocalIceCandidateStats& local_candidate) {
555 return VerifyRTCIceCandidateStats(local_candidate);
556 }
557
558 bool VerifyRTCRemoteIceCandidateStats(
559 const RTCRemoteIceCandidateStats& remote_candidate) {
560 return VerifyRTCIceCandidateStats(remote_candidate);
561 }
562
Yves Gerey665174f2018-06-19 13:03:05563 bool VerifyRTCMediaStreamStats(const RTCMediaStreamStats& media_stream) {
Niels Möllerafb246b2022-04-20 12:26:50564 RTCStatsVerifier verifier(report_.get(), &media_stream);
hbosdb346a72016-11-29 09:57:01565 verifier.TestMemberIsDefined(media_stream.stream_identifier);
Yves Gerey665174f2018-06-19 13:03:05566 verifier.TestMemberIsIDReference(media_stream.track_ids,
567 RTCMediaStreamTrackStats::kType);
hbosdb346a72016-11-29 09:57:01568 return verifier.ExpectAllMembersSuccessfullyTested();
569 }
570
571 bool VerifyRTCMediaStreamTrackStats(
572 const RTCMediaStreamTrackStats& media_stream_track) {
Niels Möllerafb246b2022-04-20 12:26:50573 RTCStatsVerifier verifier(report_.get(), &media_stream_track);
hbosdb346a72016-11-29 09:57:01574 verifier.TestMemberIsDefined(media_stream_track.track_identifier);
575 verifier.TestMemberIsDefined(media_stream_track.remote_source);
576 verifier.TestMemberIsDefined(media_stream_track.ended);
577 verifier.TestMemberIsDefined(media_stream_track.detached);
hbos160e4a72017-01-17 10:53:23578 verifier.TestMemberIsDefined(media_stream_track.kind);
Guido Urdaneta67378412019-05-28 15:38:08579 RTC_DCHECK(media_stream_track.remote_source.is_defined());
hbosdb346a72016-11-29 09:57:01580 // Video or audio media stream track?
hbos160e4a72017-01-17 10:53:23581 if (*media_stream_track.kind == RTCMediaStreamTrackKind::kVideo) {
Henrik Boström646fda02019-05-22 13:49:42582 // The type of the referenced media source depends on kind.
hbos42f6d2f2017-01-20 11:56:50583 if (*media_stream_track.remote_source) {
Guido Urdaneta67378412019-05-28 15:38:08584 verifier.TestMemberIsUndefined(media_stream_track.media_source_id);
585 verifier.TestMemberIsNonNegative<double>(
586 media_stream_track.jitter_buffer_delay);
587 verifier.TestMemberIsNonNegative<uint64_t>(
588 media_stream_track.jitter_buffer_emitted_count);
hbosfefe0762017-01-20 14:14:25589 verifier.TestMemberIsUndefined(media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 15:35:03590 verifier.TestMemberIsUndefined(media_stream_track.huge_frames_sent);
hbos42f6d2f2017-01-20 11:56:50591 verifier.TestMemberIsNonNegative<uint32_t>(
592 media_stream_track.frames_received);
hbosf64941f2017-01-20 15:39:09593 verifier.TestMemberIsNonNegative<uint32_t>(
594 media_stream_track.frames_decoded);
hbos50cfe1f2017-01-23 15:21:55595 verifier.TestMemberIsNonNegative<uint32_t>(
596 media_stream_track.frames_dropped);
Sergey Silkin02371062019-01-31 15:45:42597 verifier.TestMemberIsNonNegative<uint32_t>(
598 media_stream_track.freeze_count);
599 verifier.TestMemberIsNonNegative<uint32_t>(
600 media_stream_track.pause_count);
601 verifier.TestMemberIsNonNegative<double>(
602 media_stream_track.total_freezes_duration);
603 verifier.TestMemberIsNonNegative<double>(
604 media_stream_track.total_pauses_duration);
605 verifier.TestMemberIsNonNegative<double>(
606 media_stream_track.total_frames_duration);
607 verifier.TestMemberIsNonNegative<double>(
608 media_stream_track.sum_squared_frame_durations);
hbos42f6d2f2017-01-20 11:56:50609 } else {
Guido Urdaneta67378412019-05-28 15:38:08610 verifier.TestMemberIsIDReference(media_stream_track.media_source_id,
611 RTCVideoSourceStats::kType);
612 // Local tracks have no jitter buffer.
613 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_delay);
614 verifier.TestMemberIsUndefined(
615 media_stream_track.jitter_buffer_emitted_count);
hbosfefe0762017-01-20 14:14:25616 verifier.TestMemberIsNonNegative<uint32_t>(
617 media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 15:35:03618 verifier.TestMemberIsNonNegative<uint32_t>(
619 media_stream_track.huge_frames_sent);
hbos42f6d2f2017-01-20 11:56:50620 verifier.TestMemberIsUndefined(media_stream_track.frames_received);
hbosf64941f2017-01-20 15:39:09621 verifier.TestMemberIsUndefined(media_stream_track.frames_decoded);
hbos50cfe1f2017-01-23 15:21:55622 verifier.TestMemberIsUndefined(media_stream_track.frames_dropped);
Sergey Silkin02371062019-01-31 15:45:42623 verifier.TestMemberIsUndefined(media_stream_track.freeze_count);
624 verifier.TestMemberIsUndefined(media_stream_track.pause_count);
625 verifier.TestMemberIsUndefined(
626 media_stream_track.total_freezes_duration);
627 verifier.TestMemberIsUndefined(
628 media_stream_track.total_pauses_duration);
629 verifier.TestMemberIsUndefined(
630 media_stream_track.total_frames_duration);
631 verifier.TestMemberIsUndefined(
632 media_stream_track.sum_squared_frame_durations);
hbos42f6d2f2017-01-20 11:56:50633 }
Guido Urdaneta67378412019-05-28 15:38:08634 // Video-only members
635 verifier.TestMemberIsNonNegative<uint32_t>(
636 media_stream_track.frame_width);
637 verifier.TestMemberIsNonNegative<uint32_t>(
638 media_stream_track.frame_height);
639 verifier.TestMemberIsUndefined(media_stream_track.frames_per_second);
hbosdb346a72016-11-29 09:57:01640 verifier.TestMemberIsUndefined(media_stream_track.frames_corrupted);
641 verifier.TestMemberIsUndefined(media_stream_track.partial_frames_lost);
642 verifier.TestMemberIsUndefined(media_stream_track.full_frames_lost);
643 // Audio-only members should be undefined
644 verifier.TestMemberIsUndefined(media_stream_track.audio_level);
645 verifier.TestMemberIsUndefined(media_stream_track.echo_return_loss);
646 verifier.TestMemberIsUndefined(
647 media_stream_track.echo_return_loss_enhancement);
zsteine76bd3a2017-07-14 19:17:49648 verifier.TestMemberIsUndefined(media_stream_track.total_audio_energy);
649 verifier.TestMemberIsUndefined(media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 15:38:08650 verifier.TestMemberIsUndefined(media_stream_track.total_samples_received);
651 verifier.TestMemberIsUndefined(media_stream_track.concealed_samples);
Henrik Boström21e99da2019-08-21 10:09:51652 verifier.TestMemberIsUndefined(
653 media_stream_track.silent_concealed_samples);
Guido Urdaneta67378412019-05-28 15:38:08654 verifier.TestMemberIsUndefined(media_stream_track.concealment_events);
Henrik Boström21e99da2019-08-21 10:09:51655 verifier.TestMemberIsUndefined(
656 media_stream_track.inserted_samples_for_deceleration);
657 verifier.TestMemberIsUndefined(
658 media_stream_track.removed_samples_for_acceleration);
Guido Urdaneta67378412019-05-28 15:38:08659 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_flushes);
660 verifier.TestMemberIsUndefined(
661 media_stream_track.delayed_packet_outage_samples);
662 verifier.TestMemberIsUndefined(
663 media_stream_track.relative_packet_arrival_delay);
664 verifier.TestMemberIsUndefined(media_stream_track.interruption_count);
665 verifier.TestMemberIsUndefined(
666 media_stream_track.total_interruption_duration);
Artem Titove618cc92020-03-11 10:18:54667 verifier.TestMemberIsUndefined(
668 media_stream_track.jitter_buffer_target_delay);
hbosdb346a72016-11-29 09:57:01669 } else {
Yves Gerey665174f2018-06-19 13:03:05670 RTC_DCHECK_EQ(*media_stream_track.kind, RTCMediaStreamTrackKind::kAudio);
Henrik Boström646fda02019-05-22 13:49:42671 // The type of the referenced media source depends on kind.
Guido Urdaneta67378412019-05-28 15:38:08672 if (*media_stream_track.remote_source) {
Henrik Boström646fda02019-05-22 13:49:42673 // Remote tracks don't have media source stats.
674 verifier.TestMemberIsUndefined(media_stream_track.media_source_id);
Guido Urdaneta67378412019-05-28 15:38:08675 verifier.TestMemberIsNonNegative<double>(
676 media_stream_track.jitter_buffer_delay);
677 verifier.TestMemberIsNonNegative<uint64_t>(
678 media_stream_track.jitter_buffer_emitted_count);
Artem Titove618cc92020-03-11 10:18:54679 verifier.TestMemberIsNonNegative<double>(
680 media_stream_track.jitter_buffer_target_delay);
Henrik Boströmd2c336f2019-07-03 15:11:10681 verifier.TestMemberIsPositive<double>(media_stream_track.audio_level);
682 verifier.TestMemberIsPositive<double>(
683 media_stream_track.total_audio_energy);
684 verifier.TestMemberIsPositive<uint64_t>(
Guido Urdaneta67378412019-05-28 15:38:08685 media_stream_track.total_samples_received);
Henrik Boströmd2c336f2019-07-03 15:11:10686 verifier.TestMemberIsPositive<double>(
687 media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 15:38:08688 verifier.TestMemberIsNonNegative<uint64_t>(
689 media_stream_track.concealed_samples);
690 verifier.TestMemberIsNonNegative<uint64_t>(
Henrik Boström21e99da2019-08-21 10:09:51691 media_stream_track.silent_concealed_samples);
692 verifier.TestMemberIsNonNegative<uint64_t>(
Guido Urdaneta67378412019-05-28 15:38:08693 media_stream_track.concealment_events);
694 verifier.TestMemberIsNonNegative<uint64_t>(
695 media_stream_track.inserted_samples_for_deceleration);
696 verifier.TestMemberIsNonNegative<uint64_t>(
697 media_stream_track.removed_samples_for_acceleration);
698 verifier.TestMemberIsNonNegative<uint64_t>(
Guido Urdaneta67378412019-05-28 15:38:08699 media_stream_track.jitter_buffer_flushes);
700 verifier.TestMemberIsNonNegative<uint64_t>(
701 media_stream_track.delayed_packet_outage_samples);
702 verifier.TestMemberIsNonNegative<double>(
703 media_stream_track.relative_packet_arrival_delay);
704 verifier.TestMemberIsNonNegative<uint32_t>(
705 media_stream_track.interruption_count);
706 verifier.TestMemberIsNonNegative<double>(
707 media_stream_track.total_interruption_duration);
708 } else {
709 verifier.TestMemberIsIDReference(media_stream_track.media_source_id,
710 RTCAudioSourceStats::kType);
711 // Local audio tracks have no jitter buffer.
712 verifier.TestMemberIsUndefined(media_stream_track.jitter_buffer_delay);
713 verifier.TestMemberIsUndefined(
714 media_stream_track.jitter_buffer_emitted_count);
Artem Titove618cc92020-03-11 10:18:54715 verifier.TestMemberIsUndefined(
716 media_stream_track.jitter_buffer_target_delay);
Henrik Boströmd2c336f2019-07-03 15:11:10717 verifier.TestMemberIsUndefined(media_stream_track.audio_level);
718 verifier.TestMemberIsUndefined(media_stream_track.total_audio_energy);
Guido Urdaneta67378412019-05-28 15:38:08719 verifier.TestMemberIsUndefined(
720 media_stream_track.total_samples_received);
Henrik Boströmd2c336f2019-07-03 15:11:10721 verifier.TestMemberIsUndefined(
722 media_stream_track.total_samples_duration);
Guido Urdaneta67378412019-05-28 15:38:08723 verifier.TestMemberIsUndefined(media_stream_track.concealed_samples);
Henrik Boström21e99da2019-08-21 10:09:51724 verifier.TestMemberIsUndefined(
725 media_stream_track.silent_concealed_samples);
Guido Urdaneta67378412019-05-28 15:38:08726 verifier.TestMemberIsUndefined(media_stream_track.concealment_events);
727 verifier.TestMemberIsUndefined(
Henrik Boström21e99da2019-08-21 10:09:51728 media_stream_track.inserted_samples_for_deceleration);
729 verifier.TestMemberIsUndefined(
730 media_stream_track.removed_samples_for_acceleration);
731 verifier.TestMemberIsUndefined(
Guido Urdaneta67378412019-05-28 15:38:08732 media_stream_track.jitter_buffer_flushes);
733 verifier.TestMemberIsUndefined(
734 media_stream_track.delayed_packet_outage_samples);
735 verifier.TestMemberIsUndefined(
736 media_stream_track.relative_packet_arrival_delay);
737 verifier.TestMemberIsUndefined(media_stream_track.interruption_count);
738 verifier.TestMemberIsUndefined(
739 media_stream_track.total_interruption_duration);
Henrik Boström646fda02019-05-22 13:49:42740 }
hbosdb346a72016-11-29 09:57:01741 // Video-only members should be undefined
742 verifier.TestMemberIsUndefined(media_stream_track.frame_width);
743 verifier.TestMemberIsUndefined(media_stream_track.frame_height);
744 verifier.TestMemberIsUndefined(media_stream_track.frames_per_second);
745 verifier.TestMemberIsUndefined(media_stream_track.frames_sent);
Ilya Nikolaevskiy70473fc2018-02-28 15:35:03746 verifier.TestMemberIsUndefined(media_stream_track.huge_frames_sent);
hbosdb346a72016-11-29 09:57:01747 verifier.TestMemberIsUndefined(media_stream_track.frames_received);
748 verifier.TestMemberIsUndefined(media_stream_track.frames_decoded);
749 verifier.TestMemberIsUndefined(media_stream_track.frames_dropped);
750 verifier.TestMemberIsUndefined(media_stream_track.frames_corrupted);
751 verifier.TestMemberIsUndefined(media_stream_track.partial_frames_lost);
752 verifier.TestMemberIsUndefined(media_stream_track.full_frames_lost);
Sergey Silkin02371062019-01-31 15:45:42753 verifier.TestMemberIsUndefined(media_stream_track.freeze_count);
754 verifier.TestMemberIsUndefined(media_stream_track.pause_count);
755 verifier.TestMemberIsUndefined(media_stream_track.total_freezes_duration);
756 verifier.TestMemberIsUndefined(media_stream_track.total_pauses_duration);
757 verifier.TestMemberIsUndefined(media_stream_track.total_frames_duration);
758 verifier.TestMemberIsUndefined(
759 media_stream_track.sum_squared_frame_durations);
hbosdb346a72016-11-29 09:57:01760 // Audio-only members
Artem Titov880fa812021-07-30 20:30:23761 // TODO(hbos): `echo_return_loss` and `echo_return_loss_enhancement` are
hbos2d4d6532017-01-20 12:16:41762 // flaky on msan bot (sometimes defined, sometimes undefined). Should the
763 // test run until available or is there a way to have it always be
764 // defined? crbug.com/627816
765 verifier.MarkMemberTested(media_stream_track.echo_return_loss, true);
Yves Gerey665174f2018-06-19 13:03:05766 verifier.MarkMemberTested(media_stream_track.echo_return_loss_enhancement,
767 true);
hbosdb346a72016-11-29 09:57:01768 }
769 return verifier.ExpectAllMembersSuccessfullyTested();
770 }
771
772 bool VerifyRTCPeerConnectionStats(
773 const RTCPeerConnectionStats& peer_connection) {
Niels Möllerafb246b2022-04-20 12:26:50774 RTCStatsVerifier verifier(report_.get(), &peer_connection);
hbos23351192017-01-02 14:52:19775 verifier.TestMemberIsNonNegative<uint32_t>(
776 peer_connection.data_channels_opened);
777 verifier.TestMemberIsNonNegative<uint32_t>(
778 peer_connection.data_channels_closed);
hbosdb346a72016-11-29 09:57:01779 return verifier.ExpectAllMembersSuccessfullyTested();
780 }
781
Yves Gerey665174f2018-06-19 13:03:05782 void VerifyRTCRTPStreamStats(const RTCRTPStreamStats& stream,
Alessio Bazzicaf7b1b952021-03-23 16:23:04783 RTCStatsVerifier& verifier) {
784 verifier.TestMemberIsDefined(stream.ssrc);
785 verifier.TestMemberIsDefined(stream.kind);
Henrik Boström2f71b612021-03-23 14:18:55786 // Some legacy metrics are only defined for some of the RTP types in the
787 // hierarcy.
788 if (stream.type() == RTCInboundRTPStreamStats::kType ||
789 stream.type() == RTCOutboundRTPStreamStats::kType) {
Alessio Bazzicaf7b1b952021-03-23 16:23:04790 verifier.TestMemberIsDefined(stream.media_type);
791 verifier.TestMemberIsIDReference(stream.track_id,
792 RTCMediaStreamTrackStats::kType);
Henrik Boström2f71b612021-03-23 14:18:55793 } else {
Alessio Bazzicaf7b1b952021-03-23 16:23:04794 verifier.TestMemberIsUndefined(stream.media_type);
795 verifier.TestMemberIsUndefined(stream.track_id);
Henrik Boström2f71b612021-03-23 14:18:55796 }
Alessio Bazzicaf7b1b952021-03-23 16:23:04797 verifier.TestMemberIsIDReference(stream.transport_id,
798 RTCTransportStats::kType);
799 verifier.TestMemberIsIDReference(stream.codec_id, RTCCodecStats::kType);
800 }
801
802 void VerifyRTCSentRTPStreamStats(const RTCSentRtpStreamStats& sent_stream,
803 RTCStatsVerifier& verifier) {
804 VerifyRTCRTPStreamStats(sent_stream, verifier);
805 verifier.TestMemberIsDefined(sent_stream.packets_sent);
806 verifier.TestMemberIsDefined(sent_stream.bytes_sent);
hbosdb346a72016-11-29 09:57:01807 }
808
809 bool VerifyRTCInboundRTPStreamStats(
810 const RTCInboundRTPStreamStats& inbound_stream) {
Niels Möllerafb246b2022-04-20 12:26:50811 RTCStatsVerifier verifier(report_.get(), &inbound_stream);
Minyue Li28a2c632021-07-07 13:53:38812 VerifyRTCReceivedRtpStreamStats(inbound_stream, verifier,
Philipp Hanckea3b5c4e2022-04-22 13:09:54813 inbound_stream.kind.is_defined() &&
Minyue Li28a2c632021-07-07 13:53:38814 *inbound_stream.media_type == "audio");
Alessio Bazzicaf7b1b952021-03-23 16:23:04815 verifier.TestMemberIsOptionalIDReference(
816 inbound_stream.remote_id, RTCRemoteOutboundRtpStreamStats::kType);
Philipp Hanckea3b5c4e2022-04-22 13:09:54817 if (inbound_stream.kind.is_defined() &&
sakal5fec1282017-02-20 14:43:58818 *inbound_stream.media_type == "video") {
819 verifier.TestMemberIsNonNegative<uint64_t>(inbound_stream.qp_sum);
Henrik Boström6b430862019-08-16 11:09:51820 verifier.TestMemberIsDefined(inbound_stream.decoder_implementation);
sakal5fec1282017-02-20 14:43:58821 } else {
hbosa51d4f32017-02-16 13:34:48822 verifier.TestMemberIsUndefined(inbound_stream.qp_sum);
Henrik Boström6b430862019-08-16 11:09:51823 verifier.TestMemberIsUndefined(inbound_stream.decoder_implementation);
sakal5fec1282017-02-20 14:43:58824 }
hbos23351192017-01-02 14:52:19825 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.packets_received);
Philipp Hanckea3b5c4e2022-04-22 13:09:54826 if (inbound_stream.kind.is_defined() &&
Ivo Creusen8d8ffdb2019-04-30 07:45:21827 *inbound_stream.media_type == "audio") {
828 verifier.TestMemberIsNonNegative<uint64_t>(
829 inbound_stream.fec_packets_received);
830 verifier.TestMemberIsNonNegative<uint64_t>(
831 inbound_stream.fec_packets_discarded);
Henrik Boström4a5dab02020-01-28 10:15:35832 } else {
833 verifier.TestMemberIsUndefined(inbound_stream.fec_packets_received);
834 verifier.TestMemberIsUndefined(inbound_stream.fec_packets_discarded);
Ivo Creusen8d8ffdb2019-04-30 07:45:21835 }
hbos23351192017-01-02 14:52:19836 verifier.TestMemberIsNonNegative<uint64_t>(inbound_stream.bytes_received);
Niels Möllerac0a4cb2019-10-09 13:01:33837 verifier.TestMemberIsNonNegative<uint64_t>(
838 inbound_stream.header_bytes_received);
Henrik Boström01738c62019-04-15 15:32:00839 verifier.TestMemberIsDefined(inbound_stream.last_packet_received_timestamp);
Eldar Rello4e5bc9f2020-07-06 11:18:07840 if (inbound_stream.frames_received.ValueOrDefault(0) > 0) {
841 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frame_width);
842 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frame_height);
843 } else {
844 verifier.TestMemberIsUndefined(inbound_stream.frame_width);
845 verifier.TestMemberIsUndefined(inbound_stream.frame_height);
846 }
847 if (inbound_stream.frames_per_second.is_defined()) {
848 verifier.TestMemberIsNonNegative<double>(
849 inbound_stream.frames_per_second);
850 } else {
851 verifier.TestMemberIsUndefined(inbound_stream.frames_per_second);
852 }
853 verifier.TestMemberIsUndefined(inbound_stream.frame_bit_depth);
Byoungchan Lee899b29e2021-06-29 13:09:18854 verifier.TestMemberIsNonNegative<double>(
855 inbound_stream.jitter_buffer_delay);
856 verifier.TestMemberIsNonNegative<uint64_t>(
857 inbound_stream.jitter_buffer_emitted_count);
Philipp Hanckea3b5c4e2022-04-22 13:09:54858 if (inbound_stream.kind.is_defined() &&
hbosdb346a72016-11-29 09:57:01859 *inbound_stream.media_type == "video") {
Eldar Rello4e5bc9f2020-07-06 11:18:07860 verifier.TestMemberIsUndefined(inbound_stream.total_samples_received);
861 verifier.TestMemberIsUndefined(inbound_stream.concealed_samples);
862 verifier.TestMemberIsUndefined(inbound_stream.silent_concealed_samples);
863 verifier.TestMemberIsUndefined(inbound_stream.concealment_events);
864 verifier.TestMemberIsUndefined(
865 inbound_stream.inserted_samples_for_deceleration);
866 verifier.TestMemberIsUndefined(
867 inbound_stream.removed_samples_for_acceleration);
868 verifier.TestMemberIsUndefined(inbound_stream.audio_level);
869 verifier.TestMemberIsUndefined(inbound_stream.total_audio_energy);
870 verifier.TestMemberIsUndefined(inbound_stream.total_samples_duration);
871 verifier.TestMemberIsNonNegative<int32_t>(inbound_stream.frames_received);
Di Wufd1e9d12021-03-09 17:25:28872 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.fir_count);
873 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.pli_count);
874 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.nack_count);
hbosdb346a72016-11-29 09:57:01875 } else {
Di Wufd1e9d12021-03-09 17:25:28876 verifier.TestMemberIsUndefined(inbound_stream.fir_count);
877 verifier.TestMemberIsUndefined(inbound_stream.pli_count);
878 verifier.TestMemberIsUndefined(inbound_stream.nack_count);
Eldar Rello4e5bc9f2020-07-06 11:18:07879 verifier.TestMemberIsPositive<uint64_t>(
880 inbound_stream.total_samples_received);
881 verifier.TestMemberIsNonNegative<uint64_t>(
882 inbound_stream.concealed_samples);
883 verifier.TestMemberIsNonNegative<uint64_t>(
884 inbound_stream.silent_concealed_samples);
885 verifier.TestMemberIsNonNegative<uint64_t>(
886 inbound_stream.concealment_events);
887 verifier.TestMemberIsNonNegative<uint64_t>(
888 inbound_stream.inserted_samples_for_deceleration);
889 verifier.TestMemberIsNonNegative<uint64_t>(
890 inbound_stream.removed_samples_for_acceleration);
891 verifier.TestMemberIsPositive<double>(inbound_stream.audio_level);
892 verifier.TestMemberIsPositive<double>(inbound_stream.total_audio_energy);
893 verifier.TestMemberIsPositive<double>(
894 inbound_stream.total_samples_duration);
895 verifier.TestMemberIsUndefined(inbound_stream.frames_received);
hbosdb346a72016-11-29 09:57:01896 }
hbosa7a9be12017-03-01 09:02:45897 verifier.TestMemberIsUndefined(inbound_stream.round_trip_time);
hbosdb346a72016-11-29 09:57:01898 verifier.TestMemberIsUndefined(inbound_stream.packets_repaired);
899 verifier.TestMemberIsUndefined(inbound_stream.burst_packets_lost);
900 verifier.TestMemberIsUndefined(inbound_stream.burst_packets_discarded);
901 verifier.TestMemberIsUndefined(inbound_stream.burst_loss_count);
902 verifier.TestMemberIsUndefined(inbound_stream.burst_discard_count);
903 verifier.TestMemberIsUndefined(inbound_stream.burst_loss_rate);
904 verifier.TestMemberIsUndefined(inbound_stream.burst_discard_rate);
905 verifier.TestMemberIsUndefined(inbound_stream.gap_loss_rate);
906 verifier.TestMemberIsUndefined(inbound_stream.gap_discard_rate);
Åsa Perssonfcf79cc2019-10-22 13:23:44907 // Test runtime too short to get an estimate (at least two RTCP sender
908 // reports need to be received).
909 verifier.MarkMemberTested(inbound_stream.estimated_playout_timestamp, true);
Philipp Hanckea3b5c4e2022-04-22 13:09:54910 if (inbound_stream.kind.is_defined() &&
hbos6769c492017-01-02 16:35:13911 *inbound_stream.media_type == "video") {
912 verifier.TestMemberIsDefined(inbound_stream.frames_decoded);
Rasmus Brandt2efae772019-06-27 12:29:34913 verifier.TestMemberIsDefined(inbound_stream.key_frames_decoded);
Eldar Rello4e5bc9f2020-07-06 11:18:07914 verifier.TestMemberIsNonNegative<uint32_t>(inbound_stream.frames_dropped);
Johannes Kronbfd343b2019-07-01 08:07:50915 verifier.TestMemberIsNonNegative<double>(
916 inbound_stream.total_decode_time);
Johannes Kron00376e12019-11-25 09:25:42917 verifier.TestMemberIsNonNegative<double>(
Philipp Hanckea16a6a62022-04-25 10:21:30918 inbound_stream.total_processing_delay);
919 verifier.TestMemberIsNonNegative<double>(
Philipp Hancke0359ba22022-05-05 13:55:36920 inbound_stream.total_assembly_time);
921 verifier.TestMemberIsDefined(
922 inbound_stream.frames_assembled_from_multiple_packets);
923 verifier.TestMemberIsNonNegative<double>(
Johannes Kron00376e12019-11-25 09:25:42924 inbound_stream.total_inter_frame_delay);
925 verifier.TestMemberIsNonNegative<double>(
926 inbound_stream.total_squared_inter_frame_delay);
Henrik Boström2e069262019-04-09 11:59:31927 // The integration test is not set up to test screen share; don't require
928 // this to be present.
929 verifier.MarkMemberTested(inbound_stream.content_type, true);
hbos6769c492017-01-02 16:35:13930 } else {
931 verifier.TestMemberIsUndefined(inbound_stream.frames_decoded);
Rasmus Brandt2efae772019-06-27 12:29:34932 verifier.TestMemberIsUndefined(inbound_stream.key_frames_decoded);
Eldar Rello4e5bc9f2020-07-06 11:18:07933 verifier.TestMemberIsUndefined(inbound_stream.frames_dropped);
Johannes Kronbfd343b2019-07-01 08:07:50934 verifier.TestMemberIsUndefined(inbound_stream.total_decode_time);
Philipp Hanckea16a6a62022-04-25 10:21:30935 verifier.TestMemberIsUndefined(inbound_stream.total_processing_delay);
Philipp Hancke0359ba22022-05-05 13:55:36936 verifier.TestMemberIsUndefined(inbound_stream.total_assembly_time);
937 verifier.TestMemberIsUndefined(
938 inbound_stream.frames_assembled_from_multiple_packets);
Johannes Kron00376e12019-11-25 09:25:42939 verifier.TestMemberIsUndefined(inbound_stream.total_inter_frame_delay);
940 verifier.TestMemberIsUndefined(
941 inbound_stream.total_squared_inter_frame_delay);
Henrik Boström2e069262019-04-09 11:59:31942 verifier.TestMemberIsUndefined(inbound_stream.content_type);
hbos6769c492017-01-02 16:35:13943 }
hbosdb346a72016-11-29 09:57:01944 return verifier.ExpectAllMembersSuccessfullyTested();
945 }
946
947 bool VerifyRTCOutboundRTPStreamStats(
Eldar Rello9276e2c2020-06-10 14:53:39948 const RTCOutboundRTPStreamStats& outbound_stream) {
Niels Möllerafb246b2022-04-20 12:26:50949 RTCStatsVerifier verifier(report_.get(), &outbound_stream);
Alessio Bazzicaf7b1b952021-03-23 16:23:04950 VerifyRTCRTPStreamStats(outbound_stream, verifier);
Philipp Hanckea3b5c4e2022-04-22 13:09:54951 if (outbound_stream.kind.is_defined() &&
hbos6769c492017-01-02 16:35:13952 *outbound_stream.media_type == "video") {
Henrik Boström646fda02019-05-22 13:49:42953 verifier.TestMemberIsIDReference(outbound_stream.media_source_id,
954 RTCVideoSourceStats::kType);
Di Wufd1e9d12021-03-09 17:25:28955 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.fir_count);
956 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.pli_count);
Henrik Boströma0ff50c2020-05-05 13:54:46957 if (*outbound_stream.frames_encoded > 0) {
958 verifier.TestMemberIsNonNegative<uint64_t>(outbound_stream.qp_sum);
959 } else {
960 verifier.TestMemberIsUndefined(outbound_stream.qp_sum);
961 }
hbos6769c492017-01-02 16:35:13962 } else {
Di Wufd1e9d12021-03-09 17:25:28963 verifier.TestMemberIsUndefined(outbound_stream.fir_count);
964 verifier.TestMemberIsUndefined(outbound_stream.pli_count);
Henrik Boström646fda02019-05-22 13:49:42965 verifier.TestMemberIsIDReference(outbound_stream.media_source_id,
966 RTCAudioSourceStats::kType);
hbos6769c492017-01-02 16:35:13967 verifier.TestMemberIsUndefined(outbound_stream.qp_sum);
968 }
Jakob Ivarssone91c9922021-07-06 07:55:43969 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.nack_count);
Henrik Boström4f40fa52019-12-19 12:27:27970 verifier.TestMemberIsOptionalIDReference(
971 outbound_stream.remote_id, RTCRemoteInboundRtpStreamStats::kType);
hbos23351192017-01-02 14:52:19972 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.packets_sent);
Henrik Boströmcf96e0f2019-04-17 11:51:53973 verifier.TestMemberIsNonNegative<uint64_t>(
974 outbound_stream.retransmitted_packets_sent);
hbos23351192017-01-02 14:52:19975 verifier.TestMemberIsNonNegative<uint64_t>(outbound_stream.bytes_sent);
Henrik Boströmcf96e0f2019-04-17 11:51:53976 verifier.TestMemberIsNonNegative<uint64_t>(
Niels Möllerac0a4cb2019-10-09 13:01:33977 outbound_stream.header_bytes_sent);
978 verifier.TestMemberIsNonNegative<uint64_t>(
Henrik Boströmcf96e0f2019-04-17 11:51:53979 outbound_stream.retransmitted_bytes_sent);
Philipp Hanckea3b5c4e2022-04-22 13:09:54980 if (outbound_stream.kind.is_defined() &&
hbos6769c492017-01-02 16:35:13981 *outbound_stream.media_type == "video") {
982 verifier.TestMemberIsDefined(outbound_stream.frames_encoded);
Rasmus Brandt2efae772019-06-27 12:29:34983 verifier.TestMemberIsDefined(outbound_stream.key_frames_encoded);
Henrik Boströmf71362f2019-04-08 14:14:23984 verifier.TestMemberIsNonNegative<double>(
985 outbound_stream.total_encode_time);
Henrik Boström23aff9b2019-05-20 13:15:38986 verifier.TestMemberIsNonNegative<uint64_t>(
987 outbound_stream.total_encoded_bytes_target);
Henrik Boström9fe18342019-05-16 16:38:20988 verifier.TestMemberIsNonNegative<double>(
989 outbound_stream.total_packet_send_delay);
Henrik Boströmce33b6a2019-05-28 15:42:38990 verifier.TestMemberIsDefined(outbound_stream.quality_limitation_reason);
Byoungchan Lee7d235352021-05-28 12:32:04991 verifier.TestMemberIsDefined(
992 outbound_stream.quality_limitation_durations);
Evan Shrubsolecc62b162019-09-09 09:26:45993 verifier.TestMemberIsNonNegative<uint32_t>(
994 outbound_stream.quality_limitation_resolution_changes);
Henrik Boström2e069262019-04-09 11:59:31995 // The integration test is not set up to test screen share; don't require
996 // this to be present.
997 verifier.MarkMemberTested(outbound_stream.content_type, true);
Henrik Boström6b430862019-08-16 11:09:51998 verifier.TestMemberIsDefined(outbound_stream.encoder_implementation);
Eldar Rello9276e2c2020-06-10 14:53:39999 // Unless an implementation-specific amount of time has passed and at
1000 // least one frame has been encoded, undefined is reported. Because it
1001 // is hard to tell what is the case here, we treat FPS as optional.
1002 // TODO(hbos): Update the tests to run until all implemented metrics
1003 // should be populated.
1004 if (outbound_stream.frames_per_second.is_defined()) {
1005 verifier.TestMemberIsNonNegative<double>(
1006 outbound_stream.frames_per_second);
Henrik Boströma0ff50c2020-05-05 13:54:461007 } else {
1008 verifier.TestMemberIsUndefined(outbound_stream.frames_per_second);
Henrik Boströma0ff50c2020-05-05 13:54:461009 }
Eldar Rello9276e2c2020-06-10 14:53:391010 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frame_height);
1011 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frame_width);
1012 verifier.TestMemberIsNonNegative<uint32_t>(outbound_stream.frames_sent);
1013 verifier.TestMemberIsNonNegative<uint32_t>(
1014 outbound_stream.huge_frames_sent);
Jakob Ivarssonbf087452021-11-11 12:43:491015 verifier.TestMemberIsUndefined(outbound_stream.target_bitrate);
Eldar Rello9276e2c2020-06-10 14:53:391016 verifier.MarkMemberTested(outbound_stream.rid, true);
hbos6769c492017-01-02 16:35:131017 } else {
1018 verifier.TestMemberIsUndefined(outbound_stream.frames_encoded);
Rasmus Brandt2efae772019-06-27 12:29:341019 verifier.TestMemberIsUndefined(outbound_stream.key_frames_encoded);
Henrik Boströmf71362f2019-04-08 14:14:231020 verifier.TestMemberIsUndefined(outbound_stream.total_encode_time);
Henrik Boström23aff9b2019-05-20 13:15:381021 verifier.TestMemberIsUndefined(
1022 outbound_stream.total_encoded_bytes_target);
Henrik Boström9fe18342019-05-16 16:38:201023 // TODO(https://crbug.com/webrtc/10635): Implement for audio as well.
1024 verifier.TestMemberIsUndefined(outbound_stream.total_packet_send_delay);
Henrik Boströmce33b6a2019-05-28 15:42:381025 verifier.TestMemberIsUndefined(outbound_stream.quality_limitation_reason);
Evan Shrubsolecc62b162019-09-09 09:26:451026 verifier.TestMemberIsUndefined(
Byoungchan Lee7d235352021-05-28 12:32:041027 outbound_stream.quality_limitation_durations);
1028 verifier.TestMemberIsUndefined(
Evan Shrubsolecc62b162019-09-09 09:26:451029 outbound_stream.quality_limitation_resolution_changes);
Henrik Boström2e069262019-04-09 11:59:311030 verifier.TestMemberIsUndefined(outbound_stream.content_type);
Henrik Boström6b430862019-08-16 11:09:511031 // TODO(hbos): Implement for audio as well.
1032 verifier.TestMemberIsUndefined(outbound_stream.encoder_implementation);
Henrik Boströma0ff50c2020-05-05 13:54:461033 verifier.TestMemberIsUndefined(outbound_stream.rid);
1034 verifier.TestMemberIsUndefined(outbound_stream.frames_per_second);
1035 verifier.TestMemberIsUndefined(outbound_stream.frame_height);
1036 verifier.TestMemberIsUndefined(outbound_stream.frame_width);
1037 verifier.TestMemberIsUndefined(outbound_stream.frames_sent);
1038 verifier.TestMemberIsUndefined(outbound_stream.huge_frames_sent);
Jakob Ivarssonbf087452021-11-11 12:43:491039 verifier.TestMemberIsNonNegative<double>(outbound_stream.target_bitrate);
hbos6769c492017-01-02 16:35:131040 }
hbosdb346a72016-11-29 09:57:011041 return verifier.ExpectAllMembersSuccessfullyTested();
1042 }
1043
Henrik Boström2f71b612021-03-23 14:18:551044 void VerifyRTCReceivedRtpStreamStats(
1045 const RTCReceivedRtpStreamStats& received_rtp,
Minyue Li28a2c632021-07-07 13:53:381046 RTCStatsVerifier& verifier,
1047 bool packets_discarded_defined) {
Henrik Boström2f71b612021-03-23 14:18:551048 VerifyRTCRTPStreamStats(received_rtp, verifier);
Alessio Bazzicaf7b1b952021-03-23 16:23:041049 verifier.TestMemberIsNonNegative<double>(received_rtp.jitter);
1050 verifier.TestMemberIsDefined(received_rtp.packets_lost);
Minyue Li28a2c632021-07-07 13:53:381051 if (packets_discarded_defined) {
1052 verifier.TestMemberIsNonNegative<uint64_t>(
1053 received_rtp.packets_discarded);
1054 } else {
1055 verifier.TestMemberIsUndefined(received_rtp.packets_discarded);
1056 }
Henrik Boström2f71b612021-03-23 14:18:551057 }
1058
Henrik Boström883eefc2019-05-27 11:40:251059 bool VerifyRTCRemoteInboundRtpStreamStats(
1060 const RTCRemoteInboundRtpStreamStats& remote_inbound_stream) {
Niels Möllerafb246b2022-04-20 12:26:501061 RTCStatsVerifier verifier(report_.get(), &remote_inbound_stream);
Minyue Li28a2c632021-07-07 13:53:381062 VerifyRTCReceivedRtpStreamStats(remote_inbound_stream, verifier, false);
Di Wu86f04ad2021-03-01 07:36:031063 verifier.TestMemberIsDefined(remote_inbound_stream.fraction_lost);
Henrik Boström883eefc2019-05-27 11:40:251064 verifier.TestMemberIsIDReference(remote_inbound_stream.local_id,
1065 RTCOutboundRTPStreamStats::kType);
1066 verifier.TestMemberIsNonNegative<double>(
1067 remote_inbound_stream.round_trip_time);
Di Wu88a51b22021-03-01 19:22:061068 verifier.TestMemberIsNonNegative<double>(
1069 remote_inbound_stream.total_round_trip_time);
1070 verifier.TestMemberIsNonNegative<int32_t>(
1071 remote_inbound_stream.round_trip_time_measurements);
Henrik Boström883eefc2019-05-27 11:40:251072 return verifier.ExpectAllMembersSuccessfullyTested();
1073 }
1074
Alessio Bazzicaf7b1b952021-03-23 16:23:041075 bool VerifyRTCRemoteOutboundRTPStreamStats(
1076 const RTCRemoteOutboundRtpStreamStats& remote_outbound_stream) {
Niels Möllerafb246b2022-04-20 12:26:501077 RTCStatsVerifier verifier(report_.get(), &remote_outbound_stream);
Alessio Bazzicaf7b1b952021-03-23 16:23:041078 VerifyRTCRTPStreamStats(remote_outbound_stream, verifier);
1079 VerifyRTCSentRTPStreamStats(remote_outbound_stream, verifier);
1080 verifier.TestMemberIsIDReference(remote_outbound_stream.local_id,
1081 RTCOutboundRTPStreamStats::kType);
1082 verifier.TestMemberIsNonNegative<double>(
1083 remote_outbound_stream.remote_timestamp);
1084 verifier.TestMemberIsDefined(remote_outbound_stream.reports_sent);
1085 return verifier.ExpectAllMembersSuccessfullyTested();
1086 }
1087
Henrik Boström646fda02019-05-22 13:49:421088 void VerifyRTCMediaSourceStats(const RTCMediaSourceStats& media_source,
1089 RTCStatsVerifier* verifier) {
1090 verifier->TestMemberIsDefined(media_source.track_identifier);
1091 verifier->TestMemberIsDefined(media_source.kind);
1092 if (media_source.kind.is_defined()) {
1093 EXPECT_TRUE((*media_source.kind == "audio" &&
1094 media_source.type() == RTCAudioSourceStats::kType) ||
1095 (*media_source.kind == "video" &&
1096 media_source.type() == RTCVideoSourceStats::kType));
1097 }
1098 }
1099
1100 bool VerifyRTCAudioSourceStats(const RTCAudioSourceStats& audio_source) {
Niels Möllerafb246b2022-04-20 12:26:501101 RTCStatsVerifier verifier(report_.get(), &audio_source);
Henrik Boström646fda02019-05-22 13:49:421102 VerifyRTCMediaSourceStats(audio_source, &verifier);
Henrik Boström262bbae2019-09-13 09:34:551103 // Audio level, unlike audio energy, only gets updated at a certain
1104 // frequency, so we don't require that one to be positive to avoid a race
1105 // (https://crbug.com/webrtc/10962).
1106 verifier.TestMemberIsNonNegative<double>(audio_source.audio_level);
Henrik Boströmd2c336f2019-07-03 15:11:101107 verifier.TestMemberIsPositive<double>(audio_source.total_audio_energy);
1108 verifier.TestMemberIsPositive<double>(audio_source.total_samples_duration);
Artem Titov880fa812021-07-30 20:30:231109 // TODO(hbos): `echo_return_loss` and `echo_return_loss_enhancement` are
Taylor Brandstetter64851c02021-06-24 20:32:501110 // flaky on msan bot (sometimes defined, sometimes undefined). Should the
1111 // test run until available or is there a way to have it always be
1112 // defined? crbug.com/627816
1113 verifier.MarkMemberTested(audio_source.echo_return_loss, true);
1114 verifier.MarkMemberTested(audio_source.echo_return_loss_enhancement, true);
Henrik Boström646fda02019-05-22 13:49:421115 return verifier.ExpectAllMembersSuccessfullyTested();
1116 }
1117
1118 bool VerifyRTCVideoSourceStats(const RTCVideoSourceStats& video_source) {
Niels Möllerafb246b2022-04-20 12:26:501119 RTCStatsVerifier verifier(report_.get(), &video_source);
Henrik Boström646fda02019-05-22 13:49:421120 VerifyRTCMediaSourceStats(video_source, &verifier);
1121 // TODO(hbos): This integration test uses fakes that doesn't support
1122 // VideoTrackSourceInterface::Stats. When this is fixed we should
Artem Titov880fa812021-07-30 20:30:231123 // TestMemberIsNonNegative<uint32_t>() for `width` and `height` instead to
Henrik Boström646fda02019-05-22 13:49:421124 // reflect real code.
1125 verifier.TestMemberIsUndefined(video_source.width);
1126 verifier.TestMemberIsUndefined(video_source.height);
Di Wu668dbf62021-02-27 08:29:151127 verifier.TestMemberIsNonNegative<uint32_t>(video_source.frames);
Byoungchan Leeefe46b62021-11-10 02:23:561128 verifier.TestMemberIsNonNegative<double>(video_source.frames_per_second);
Henrik Boström646fda02019-05-22 13:49:421129 return verifier.ExpectAllMembersSuccessfullyTested();
1130 }
1131
Yves Gerey665174f2018-06-19 13:03:051132 bool VerifyRTCTransportStats(const RTCTransportStats& transport) {
Niels Möllerafb246b2022-04-20 12:26:501133 RTCStatsVerifier verifier(report_.get(), &transport);
hbos23351192017-01-02 14:52:191134 verifier.TestMemberIsNonNegative<uint64_t>(transport.bytes_sent);
Artem Titovedacbd52020-07-06 14:06:371135 verifier.TestMemberIsNonNegative<uint64_t>(transport.packets_sent);
hbos23351192017-01-02 14:52:191136 verifier.TestMemberIsNonNegative<uint64_t>(transport.bytes_received);
Artem Titovedacbd52020-07-06 14:06:371137 verifier.TestMemberIsNonNegative<uint64_t>(transport.packets_received);
Yves Gerey665174f2018-06-19 13:03:051138 verifier.TestMemberIsOptionalIDReference(transport.rtcp_transport_stats_id,
1139 RTCTransportStats::kType);
hbos7064d592017-01-16 15:38:021140 verifier.TestMemberIsDefined(transport.dtls_state);
Yves Gerey665174f2018-06-19 13:03:051141 verifier.TestMemberIsIDReference(transport.selected_candidate_pair_id,
1142 RTCIceCandidatePairStats::kType);
1143 verifier.TestMemberIsIDReference(transport.local_certificate_id,
1144 RTCCertificateStats::kType);
1145 verifier.TestMemberIsIDReference(transport.remote_certificate_id,
1146 RTCCertificateStats::kType);
Harald Alvestrand5cb78072019-10-28 08:51:171147 verifier.TestMemberIsDefined(transport.tls_version);
1148 verifier.TestMemberIsDefined(transport.dtls_cipher);
Philipp Hancke69c1df22022-04-22 13:46:241149 verifier.TestMemberIsDefined(transport.dtls_role);
Harald Alvestrand5cb78072019-10-28 08:51:171150 verifier.TestMemberIsDefined(transport.srtp_cipher);
Jonas Oreland149dc722019-08-28 06:10:271151 verifier.TestMemberIsPositive<uint32_t>(
1152 transport.selected_candidate_pair_changes);
Philipp Hanckecc1b9b02022-05-04 16:58:261153 verifier.TestMemberIsDefined(transport.ice_role);
Philipp Hancke95b1a342022-05-05 05:53:541154 verifier.TestMemberIsDefined(transport.ice_local_username_fragment);
Philipp Hancke1f491572022-05-09 15:43:311155 verifier.TestMemberIsDefined(transport.ice_state);
hbosdb346a72016-11-29 09:57:011156 return verifier.ExpectAllMembersSuccessfullyTested();
1157 }
1158
1159 private:
1160 rtc::scoped_refptr<const RTCStatsReport> report_;
1161};
1162
Mirko Bonadei5eb43b42021-01-18 12:24:401163#ifdef WEBRTC_HAVE_SCTP
hbosdb346a72016-11-29 09:57:011164TEST_F(RTCStatsIntegrationTest, GetStatsFromCaller) {
1165 StartCall();
1166
1167 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCaller();
Eldar Rello9276e2c2020-06-10 14:53:391168 RTCStatsReportVerifier(report.get()).VerifyReport({});
Doudou Kisabaka2dec4962019-11-28 13:24:311169
Henrik Boströma0ff50c2020-05-05 13:54:461170#if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 21:35:041171 EXPECT_EQ(report->ToJson(), RTCStatsReportTraceListener::last_trace());
Jianhui Daib1ba8532022-05-13 02:40:251172#endif
hbosdb346a72016-11-29 09:57:011173}
1174
1175TEST_F(RTCStatsIntegrationTest, GetStatsFromCallee) {
1176 StartCall();
1177
1178 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCallee();
Eldar Rello9276e2c2020-06-10 14:53:391179 RTCStatsReportVerifier(report.get()).VerifyReport({});
Doudou Kisabaka2dec4962019-11-28 13:24:311180
Henrik Boströma0ff50c2020-05-05 13:54:461181#if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 21:35:041182 EXPECT_EQ(report->ToJson(), RTCStatsReportTraceListener::last_trace());
Jianhui Daib1ba8532022-05-13 02:40:251183#endif
hbosdb346a72016-11-29 09:57:011184}
1185
Henrik Boström1df1bf82018-03-20 12:24:201186// These tests exercise the integration of the stats selection algorithm inside
1187// of PeerConnection. See rtcstatstraveral_unittest.cc for more detailed stats
1188// traversal tests on particular stats graphs.
1189TEST_F(RTCStatsIntegrationTest, GetStatsWithSenderSelector) {
1190 StartCall();
1191 ASSERT_FALSE(caller_->pc()->GetSenders().empty());
1192 rtc::scoped_refptr<const RTCStatsReport> report =
1193 GetStatsFromCaller(caller_->pc()->GetSenders()[0]);
1194 std::vector<const char*> allowed_missing_stats = {
1195 // TODO(hbos): Include RTC[Audio/Video]ReceiverStats when implemented.
1196 // TODO(hbos): Include RTCRemoteOutboundRtpStreamStats when implemented.
1197 // TODO(hbos): Include RTCRtpContributingSourceStats when implemented.
Jonas Olssona4d87372019-07-05 17:08:331198 RTCInboundRTPStreamStats::kType,
1199 RTCPeerConnectionStats::kType,
1200 RTCMediaStreamStats::kType,
1201 RTCDataChannelStats::kType,
Henrik Boström1df1bf82018-03-20 12:24:201202 };
Eldar Rello9276e2c2020-06-10 14:53:391203 RTCStatsReportVerifier(report.get()).VerifyReport(allowed_missing_stats);
Henrik Boström1df1bf82018-03-20 12:24:201204 EXPECT_TRUE(report->size());
1205}
1206
1207TEST_F(RTCStatsIntegrationTest, GetStatsWithReceiverSelector) {
1208 StartCall();
1209
1210 ASSERT_FALSE(caller_->pc()->GetReceivers().empty());
1211 rtc::scoped_refptr<const RTCStatsReport> report =
1212 GetStatsFromCaller(caller_->pc()->GetReceivers()[0]);
1213 std::vector<const char*> allowed_missing_stats = {
1214 // TODO(hbos): Include RTC[Audio/Video]SenderStats when implemented.
1215 // TODO(hbos): Include RTCRemoteInboundRtpStreamStats when implemented.
1216 // TODO(hbos): Include RTCRtpContributingSourceStats when implemented.
Jonas Olssona4d87372019-07-05 17:08:331217 RTCOutboundRTPStreamStats::kType,
1218 RTCPeerConnectionStats::kType,
1219 RTCMediaStreamStats::kType,
1220 RTCDataChannelStats::kType,
Henrik Boström1df1bf82018-03-20 12:24:201221 };
Eldar Rello9276e2c2020-06-10 14:53:391222 RTCStatsReportVerifier(report.get()).VerifyReport(allowed_missing_stats);
Henrik Boström1df1bf82018-03-20 12:24:201223 EXPECT_TRUE(report->size());
1224}
1225
1226TEST_F(RTCStatsIntegrationTest, GetStatsWithInvalidSenderSelector) {
1227 StartCall();
1228
1229 ASSERT_FALSE(callee_->pc()->GetSenders().empty());
1230 // The selector is invalid for the caller because it belongs to the callee.
1231 auto invalid_selector = callee_->pc()->GetSenders()[0];
1232 rtc::scoped_refptr<const RTCStatsReport> report =
1233 GetStatsFromCaller(invalid_selector);
1234 EXPECT_FALSE(report->size());
1235}
1236
1237TEST_F(RTCStatsIntegrationTest, GetStatsWithInvalidReceiverSelector) {
1238 StartCall();
1239
1240 ASSERT_FALSE(callee_->pc()->GetReceivers().empty());
1241 // The selector is invalid for the caller because it belongs to the callee.
1242 auto invalid_selector = callee_->pc()->GetReceivers()[0];
1243 rtc::scoped_refptr<const RTCStatsReport> report =
1244 GetStatsFromCaller(invalid_selector);
1245 EXPECT_FALSE(report->size());
1246}
1247
Yves Gerey59cfd352018-11-26 15:22:201248// TODO(bugs.webrtc.org/10041) For now this is equivalent to the following
1249// test GetsStatsWhileClosingPeerConnection, because pc() is closed by
1250// PeerConnectionTestWrapper. See: bugs.webrtc.org/9847
Yves Gereyb5bb5132018-11-14 17:00:141251TEST_F(RTCStatsIntegrationTest,
Yves Gerey59cfd352018-11-26 15:22:201252 DISABLED_GetStatsWhileDestroyingPeerConnection) {
hbosb78306a2016-12-19 13:06:571253 StartCall();
1254
1255 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
1256 RTCStatsObtainer::Create();
Niels Möllerafb246b2022-04-20 12:26:501257 caller_->pc()->GetStats(stats_obtainer.get());
hbosb78306a2016-12-19 13:06:571258 // This will destroy the peer connection.
1259 caller_ = nullptr;
1260 // Any pending stats requests should have completed in the act of destroying
1261 // the peer connection.
Steve Anton25cfeb92018-04-26 18:44:001262 ASSERT_TRUE(stats_obtainer->report());
Jianhui Daib1ba8532022-05-13 02:40:251263#if RTC_TRACE_EVENTS_ENABLED
Steve Anton25cfeb92018-04-26 18:44:001264 EXPECT_EQ(stats_obtainer->report()->ToJson(),
1265 RTCStatsReportTraceListener::last_trace());
Jianhui Daib1ba8532022-05-13 02:40:251266#endif
Steve Anton25cfeb92018-04-26 18:44:001267}
1268
1269TEST_F(RTCStatsIntegrationTest, GetsStatsWhileClosingPeerConnection) {
1270 StartCall();
1271
1272 rtc::scoped_refptr<RTCStatsObtainer> stats_obtainer =
1273 RTCStatsObtainer::Create();
Niels Möllerafb246b2022-04-20 12:26:501274 caller_->pc()->GetStats(stats_obtainer.get());
Steve Anton25cfeb92018-04-26 18:44:001275 caller_->pc()->Close();
1276
1277 ASSERT_TRUE(stats_obtainer->report());
Jianhui Daib1ba8532022-05-13 02:40:251278#if RTC_TRACE_EVENTS_ENABLED
ehmaldonado8ab0fd82017-09-04 21:35:041279 EXPECT_EQ(stats_obtainer->report()->ToJson(),
1280 RTCStatsReportTraceListener::last_trace());
Jianhui Daib1ba8532022-05-13 02:40:251281#endif
hbosb78306a2016-12-19 13:06:571282}
Henrik Boströmb6199362018-03-12 09:27:551283
1284// GetStatsReferencedIds() is optimized to recognize what is or isn't a
1285// referenced ID based on dictionary type information and knowing what members
1286// are used as references, as opposed to iterating all members to find the ones
1287// with the "Id" or "Ids" suffix. As such, GetStatsReferencedIds() is tested as
1288// an integration test instead of a unit test in order to guard against adding
1289// new references and forgetting to update GetStatsReferencedIds().
1290TEST_F(RTCStatsIntegrationTest, GetStatsReferencedIds) {
1291 StartCall();
1292
1293 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCallee();
1294 for (const RTCStats& stats : *report) {
1295 // Find all references by looking at all string members with the "Id" or
1296 // "Ids" suffix.
1297 std::set<const std::string*> expected_ids;
1298 for (const auto* member : stats.Members()) {
1299 if (!member->is_defined())
1300 continue;
1301 if (member->type() == RTCStatsMemberInterface::kString) {
Steve Anton68586e82018-12-14 01:41:251302 if (absl::EndsWith(member->name(), "Id")) {
Henrik Boströmb6199362018-03-12 09:27:551303 const auto& id = member->cast_to<const RTCStatsMember<std::string>>();
1304 expected_ids.insert(&(*id));
1305 }
1306 } else if (member->type() == RTCStatsMemberInterface::kSequenceString) {
Steve Anton68586e82018-12-14 01:41:251307 if (absl::EndsWith(member->name(), "Ids")) {
Henrik Boströmb6199362018-03-12 09:27:551308 const auto& ids =
1309 member->cast_to<const RTCStatsMember<std::vector<std::string>>>();
1310 for (const std::string& id : *ids)
1311 expected_ids.insert(&id);
1312 }
1313 }
1314 }
1315
1316 std::vector<const std::string*> neighbor_ids = GetStatsReferencedIds(stats);
1317 EXPECT_EQ(neighbor_ids.size(), expected_ids.size());
1318 for (const std::string* neighbor_id : neighbor_ids) {
Steve Anton64b626b2019-01-29 01:25:261319 EXPECT_THAT(expected_ids, Contains(neighbor_id));
Henrik Boströmb6199362018-03-12 09:27:551320 }
1321 for (const std::string* expected_id : expected_ids) {
Steve Anton64b626b2019-01-29 01:25:261322 EXPECT_THAT(neighbor_ids, Contains(expected_id));
Henrik Boströmb6199362018-03-12 09:27:551323 }
1324 }
1325}
Henrik Boström943ad972021-04-08 07:30:051326
1327TEST_F(RTCStatsIntegrationTest, GetStatsContainsNoDuplicateMembers) {
1328 StartCall();
1329
1330 rtc::scoped_refptr<const RTCStatsReport> report = GetStatsFromCallee();
1331 for (const RTCStats& stats : *report) {
1332 std::set<std::string> member_names;
1333 for (const auto* member : stats.Members()) {
1334 EXPECT_TRUE(member_names.find(member->name()) == member_names.end())
1335 << member->name() << " is a duplicate!";
1336 member_names.insert(member->name());
1337 }
1338 }
1339}
Mirko Bonadei5eb43b42021-01-18 12:24:401340#endif // WEBRTC_HAVE_SCTP
hbosb78306a2016-12-19 13:06:571341
hbosdb346a72016-11-29 09:57:011342} // namespace
1343
1344} // namespace webrtc