Home | History | Annotate | Download | only in video
      1 /*
      2  *  Copyright (c) 2013 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 
     11 // This file includes unit tests for SendStatisticsProxy.
     12 #include "webrtc/video/send_statistics_proxy.h"
     13 
     14 #include <map>
     15 #include <string>
     16 #include <vector>
     17 
     18 #include "testing/gtest/include/gtest/gtest.h"
     19 #include "webrtc/test/histogram.h"
     20 
     21 namespace webrtc {
     22 
     23 class SendStatisticsProxyTest : public ::testing::Test {
     24  public:
     25   SendStatisticsProxyTest()
     26       : fake_clock_(1234), config_(GetTestConfig()), avg_delay_ms_(0),
     27         max_delay_ms_(0) {}
     28   virtual ~SendStatisticsProxyTest() {}
     29 
     30  protected:
     31   virtual void SetUp() {
     32     statistics_proxy_.reset(new SendStatisticsProxy(
     33         &fake_clock_, GetTestConfig(),
     34         VideoEncoderConfig::ContentType::kRealtimeVideo));
     35     expected_ = VideoSendStream::Stats();
     36   }
     37 
     38   VideoSendStream::Config GetTestConfig() {
     39     VideoSendStream::Config config(nullptr);
     40     config.rtp.ssrcs.push_back(17);
     41     config.rtp.ssrcs.push_back(42);
     42     config.rtp.rtx.ssrcs.push_back(18);
     43     config.rtp.rtx.ssrcs.push_back(43);
     44     return config;
     45   }
     46 
     47   void ExpectEqual(VideoSendStream::Stats one, VideoSendStream::Stats other) {
     48     EXPECT_EQ(one.input_frame_rate, other.input_frame_rate);
     49     EXPECT_EQ(one.encode_frame_rate, other.encode_frame_rate);
     50     EXPECT_EQ(one.media_bitrate_bps, other.media_bitrate_bps);
     51     EXPECT_EQ(one.suspended, other.suspended);
     52 
     53     EXPECT_EQ(one.substreams.size(), other.substreams.size());
     54     for (std::map<uint32_t, VideoSendStream::StreamStats>::const_iterator it =
     55              one.substreams.begin();
     56          it != one.substreams.end(); ++it) {
     57       std::map<uint32_t, VideoSendStream::StreamStats>::const_iterator
     58           corresponding_it = other.substreams.find(it->first);
     59       ASSERT_TRUE(corresponding_it != other.substreams.end());
     60       const VideoSendStream::StreamStats& a = it->second;
     61       const VideoSendStream::StreamStats& b = corresponding_it->second;
     62 
     63       EXPECT_EQ(a.frame_counts.key_frames, b.frame_counts.key_frames);
     64       EXPECT_EQ(a.frame_counts.delta_frames, b.frame_counts.delta_frames);
     65       EXPECT_EQ(a.total_bitrate_bps, b.total_bitrate_bps);
     66       EXPECT_EQ(a.avg_delay_ms, b.avg_delay_ms);
     67       EXPECT_EQ(a.max_delay_ms, b.max_delay_ms);
     68 
     69       EXPECT_EQ(a.rtp_stats.transmitted.payload_bytes,
     70                 b.rtp_stats.transmitted.payload_bytes);
     71       EXPECT_EQ(a.rtp_stats.transmitted.header_bytes,
     72                 b.rtp_stats.transmitted.header_bytes);
     73       EXPECT_EQ(a.rtp_stats.transmitted.padding_bytes,
     74                 b.rtp_stats.transmitted.padding_bytes);
     75       EXPECT_EQ(a.rtp_stats.transmitted.packets,
     76                 b.rtp_stats.transmitted.packets);
     77       EXPECT_EQ(a.rtp_stats.retransmitted.packets,
     78                 b.rtp_stats.retransmitted.packets);
     79       EXPECT_EQ(a.rtp_stats.fec.packets, b.rtp_stats.fec.packets);
     80 
     81       EXPECT_EQ(a.rtcp_stats.fraction_lost, b.rtcp_stats.fraction_lost);
     82       EXPECT_EQ(a.rtcp_stats.cumulative_lost, b.rtcp_stats.cumulative_lost);
     83       EXPECT_EQ(a.rtcp_stats.extended_max_sequence_number,
     84                 b.rtcp_stats.extended_max_sequence_number);
     85       EXPECT_EQ(a.rtcp_stats.jitter, b.rtcp_stats.jitter);
     86     }
     87   }
     88 
     89   rtc::scoped_ptr<SendStatisticsProxy> statistics_proxy_;
     90   SimulatedClock fake_clock_;
     91   VideoSendStream::Config config_;
     92   int avg_delay_ms_;
     93   int max_delay_ms_;
     94   VideoSendStream::Stats expected_;
     95   typedef std::map<uint32_t, VideoSendStream::StreamStats>::const_iterator
     96       StreamIterator;
     97 };
     98 
     99 TEST_F(SendStatisticsProxyTest, RtcpStatistics) {
    100   RtcpStatisticsCallback* callback = statistics_proxy_.get();
    101   for (std::vector<uint32_t>::const_iterator it = config_.rtp.ssrcs.begin();
    102        it != config_.rtp.ssrcs.end();
    103        ++it) {
    104     const uint32_t ssrc = *it;
    105     VideoSendStream::StreamStats& ssrc_stats = expected_.substreams[ssrc];
    106 
    107     // Add statistics with some arbitrary, but unique, numbers.
    108     uint32_t offset = ssrc * sizeof(RtcpStatistics);
    109     ssrc_stats.rtcp_stats.cumulative_lost = offset;
    110     ssrc_stats.rtcp_stats.extended_max_sequence_number = offset + 1;
    111     ssrc_stats.rtcp_stats.fraction_lost = offset + 2;
    112     ssrc_stats.rtcp_stats.jitter = offset + 3;
    113     callback->StatisticsUpdated(ssrc_stats.rtcp_stats, ssrc);
    114   }
    115   for (std::vector<uint32_t>::const_iterator it = config_.rtp.rtx.ssrcs.begin();
    116        it != config_.rtp.rtx.ssrcs.end();
    117        ++it) {
    118     const uint32_t ssrc = *it;
    119     VideoSendStream::StreamStats& ssrc_stats = expected_.substreams[ssrc];
    120 
    121     // Add statistics with some arbitrary, but unique, numbers.
    122     uint32_t offset = ssrc * sizeof(RtcpStatistics);
    123     ssrc_stats.rtcp_stats.cumulative_lost = offset;
    124     ssrc_stats.rtcp_stats.extended_max_sequence_number = offset + 1;
    125     ssrc_stats.rtcp_stats.fraction_lost = offset + 2;
    126     ssrc_stats.rtcp_stats.jitter = offset + 3;
    127     callback->StatisticsUpdated(ssrc_stats.rtcp_stats, ssrc);
    128   }
    129   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    130   ExpectEqual(expected_, stats);
    131 }
    132 
    133 TEST_F(SendStatisticsProxyTest, EncodedBitrateAndFramerate) {
    134   int media_bitrate_bps = 500;
    135   int encode_fps = 29;
    136 
    137   statistics_proxy_->OnOutgoingRate(encode_fps, media_bitrate_bps);
    138 
    139   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    140   EXPECT_EQ(media_bitrate_bps, stats.media_bitrate_bps);
    141   EXPECT_EQ(encode_fps, stats.encode_frame_rate);
    142 }
    143 
    144 TEST_F(SendStatisticsProxyTest, Suspended) {
    145   // Verify that the value is false by default.
    146   EXPECT_FALSE(statistics_proxy_->GetStats().suspended);
    147 
    148   // Verify that we can set it to true.
    149   statistics_proxy_->OnSuspendChange(true);
    150   EXPECT_TRUE(statistics_proxy_->GetStats().suspended);
    151 
    152   // Verify that we can set it back to false again.
    153   statistics_proxy_->OnSuspendChange(false);
    154   EXPECT_FALSE(statistics_proxy_->GetStats().suspended);
    155 }
    156 
    157 TEST_F(SendStatisticsProxyTest, FrameCounts) {
    158   FrameCountObserver* observer = statistics_proxy_.get();
    159   for (std::vector<uint32_t>::const_iterator it = config_.rtp.ssrcs.begin();
    160        it != config_.rtp.ssrcs.end();
    161        ++it) {
    162     const uint32_t ssrc = *it;
    163     // Add statistics with some arbitrary, but unique, numbers.
    164     VideoSendStream::StreamStats& stats = expected_.substreams[ssrc];
    165     uint32_t offset = ssrc * sizeof(VideoSendStream::StreamStats);
    166     FrameCounts frame_counts;
    167     frame_counts.key_frames = offset;
    168     frame_counts.delta_frames = offset + 1;
    169     stats.frame_counts = frame_counts;
    170     observer->FrameCountUpdated(frame_counts, ssrc);
    171   }
    172   for (std::vector<uint32_t>::const_iterator it = config_.rtp.rtx.ssrcs.begin();
    173        it != config_.rtp.rtx.ssrcs.end();
    174        ++it) {
    175     const uint32_t ssrc = *it;
    176     // Add statistics with some arbitrary, but unique, numbers.
    177     VideoSendStream::StreamStats& stats = expected_.substreams[ssrc];
    178     uint32_t offset = ssrc * sizeof(VideoSendStream::StreamStats);
    179     FrameCounts frame_counts;
    180     frame_counts.key_frames = offset;
    181     frame_counts.delta_frames = offset + 1;
    182     stats.frame_counts = frame_counts;
    183     observer->FrameCountUpdated(frame_counts, ssrc);
    184   }
    185 
    186   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    187   ExpectEqual(expected_, stats);
    188 }
    189 
    190 TEST_F(SendStatisticsProxyTest, DataCounters) {
    191   StreamDataCountersCallback* callback = statistics_proxy_.get();
    192   for (std::vector<uint32_t>::const_iterator it = config_.rtp.ssrcs.begin();
    193        it != config_.rtp.ssrcs.end();
    194        ++it) {
    195     const uint32_t ssrc = *it;
    196     StreamDataCounters& counters = expected_.substreams[ssrc].rtp_stats;
    197     // Add statistics with some arbitrary, but unique, numbers.
    198     size_t offset = ssrc * sizeof(StreamDataCounters);
    199     uint32_t offset_uint32 = static_cast<uint32_t>(offset);
    200     counters.transmitted.payload_bytes = offset;
    201     counters.transmitted.header_bytes = offset + 1;
    202     counters.fec.packets = offset_uint32 + 2;
    203     counters.transmitted.padding_bytes = offset + 3;
    204     counters.retransmitted.packets = offset_uint32 + 4;
    205     counters.transmitted.packets = offset_uint32 + 5;
    206     callback->DataCountersUpdated(counters, ssrc);
    207   }
    208   for (std::vector<uint32_t>::const_iterator it = config_.rtp.rtx.ssrcs.begin();
    209        it != config_.rtp.rtx.ssrcs.end();
    210        ++it) {
    211     const uint32_t ssrc = *it;
    212     StreamDataCounters& counters = expected_.substreams[ssrc].rtp_stats;
    213     // Add statistics with some arbitrary, but unique, numbers.
    214     size_t offset = ssrc * sizeof(StreamDataCounters);
    215     uint32_t offset_uint32 = static_cast<uint32_t>(offset);
    216     counters.transmitted.payload_bytes = offset;
    217     counters.transmitted.header_bytes = offset + 1;
    218     counters.fec.packets = offset_uint32 + 2;
    219     counters.transmitted.padding_bytes = offset + 3;
    220     counters.retransmitted.packets = offset_uint32 + 4;
    221     counters.transmitted.packets = offset_uint32 + 5;
    222     callback->DataCountersUpdated(counters, ssrc);
    223   }
    224 
    225   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    226   ExpectEqual(expected_, stats);
    227 }
    228 
    229 TEST_F(SendStatisticsProxyTest, Bitrate) {
    230   BitrateStatisticsObserver* observer = statistics_proxy_.get();
    231   for (std::vector<uint32_t>::const_iterator it = config_.rtp.ssrcs.begin();
    232        it != config_.rtp.ssrcs.end();
    233        ++it) {
    234     const uint32_t ssrc = *it;
    235     BitrateStatistics total;
    236     BitrateStatistics retransmit;
    237     // Use ssrc as bitrate_bps to get a unique value for each stream.
    238     total.bitrate_bps = ssrc;
    239     retransmit.bitrate_bps = ssrc + 1;
    240     observer->Notify(total, retransmit, ssrc);
    241     expected_.substreams[ssrc].total_bitrate_bps = total.bitrate_bps;
    242     expected_.substreams[ssrc].retransmit_bitrate_bps = retransmit.bitrate_bps;
    243   }
    244   for (std::vector<uint32_t>::const_iterator it = config_.rtp.rtx.ssrcs.begin();
    245        it != config_.rtp.rtx.ssrcs.end();
    246        ++it) {
    247     const uint32_t ssrc = *it;
    248     BitrateStatistics total;
    249     BitrateStatistics retransmit;
    250     // Use ssrc as bitrate_bps to get a unique value for each stream.
    251     total.bitrate_bps = ssrc;
    252     retransmit.bitrate_bps = ssrc + 1;
    253     observer->Notify(total, retransmit, ssrc);
    254     expected_.substreams[ssrc].total_bitrate_bps = total.bitrate_bps;
    255     expected_.substreams[ssrc].retransmit_bitrate_bps = retransmit.bitrate_bps;
    256   }
    257 
    258   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    259   ExpectEqual(expected_, stats);
    260 }
    261 
    262 TEST_F(SendStatisticsProxyTest, SendSideDelay) {
    263   SendSideDelayObserver* observer = statistics_proxy_.get();
    264   for (std::vector<uint32_t>::const_iterator it = config_.rtp.ssrcs.begin();
    265        it != config_.rtp.ssrcs.end();
    266        ++it) {
    267     const uint32_t ssrc = *it;
    268     // Use ssrc as avg_delay_ms and max_delay_ms to get a unique value for each
    269     // stream.
    270     int avg_delay_ms = ssrc;
    271     int max_delay_ms = ssrc + 1;
    272     observer->SendSideDelayUpdated(avg_delay_ms, max_delay_ms, ssrc);
    273     expected_.substreams[ssrc].avg_delay_ms = avg_delay_ms;
    274     expected_.substreams[ssrc].max_delay_ms = max_delay_ms;
    275   }
    276   for (std::vector<uint32_t>::const_iterator it = config_.rtp.rtx.ssrcs.begin();
    277        it != config_.rtp.rtx.ssrcs.end();
    278        ++it) {
    279     const uint32_t ssrc = *it;
    280     // Use ssrc as avg_delay_ms and max_delay_ms to get a unique value for each
    281     // stream.
    282     int avg_delay_ms = ssrc;
    283     int max_delay_ms = ssrc + 1;
    284     observer->SendSideDelayUpdated(avg_delay_ms, max_delay_ms, ssrc);
    285     expected_.substreams[ssrc].avg_delay_ms = avg_delay_ms;
    286     expected_.substreams[ssrc].max_delay_ms = max_delay_ms;
    287   }
    288   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    289   ExpectEqual(expected_, stats);
    290 }
    291 
    292 TEST_F(SendStatisticsProxyTest, OnEncodedFrame) {
    293   const int kEncodeTimeMs = 11;
    294   statistics_proxy_->OnEncodedFrame(kEncodeTimeMs);
    295 
    296   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    297   EXPECT_EQ(kEncodeTimeMs, stats.avg_encode_time_ms);
    298 }
    299 
    300 TEST_F(SendStatisticsProxyTest, SwitchContentTypeUpdatesHistograms) {
    301   test::ClearHistograms();
    302   const int kMinRequiredSamples = 200;
    303   const int kWidth = 640;
    304   const int kHeight = 480;
    305 
    306   for (int i = 0; i < kMinRequiredSamples; ++i)
    307     statistics_proxy_->OnIncomingFrame(kWidth, kHeight);
    308 
    309   // No switch, stats not should be updated.
    310   statistics_proxy_->SetContentType(
    311       VideoEncoderConfig::ContentType::kRealtimeVideo);
    312   EXPECT_EQ(0, test::NumHistogramSamples("WebRTC.Video.InputWidthInPixels"));
    313 
    314   // Switch to screenshare, real-time stats should be updated.
    315   statistics_proxy_->SetContentType(VideoEncoderConfig::ContentType::kScreen);
    316   EXPECT_EQ(1, test::NumHistogramSamples("WebRTC.Video.InputWidthInPixels"));
    317 }
    318 
    319 TEST_F(SendStatisticsProxyTest, NoSubstreams) {
    320   uint32_t excluded_ssrc =
    321       std::max(
    322           *std::max_element(config_.rtp.ssrcs.begin(), config_.rtp.ssrcs.end()),
    323           *std::max_element(config_.rtp.rtx.ssrcs.begin(),
    324                             config_.rtp.rtx.ssrcs.end())) +
    325       1;
    326   // From RtcpStatisticsCallback.
    327   RtcpStatistics rtcp_stats;
    328   RtcpStatisticsCallback* rtcp_callback = statistics_proxy_.get();
    329   rtcp_callback->StatisticsUpdated(rtcp_stats, excluded_ssrc);
    330 
    331   // From BitrateStatisticsObserver.
    332   BitrateStatistics total;
    333   BitrateStatistics retransmit;
    334   BitrateStatisticsObserver* bitrate_observer = statistics_proxy_.get();
    335   bitrate_observer->Notify(total, retransmit, excluded_ssrc);
    336 
    337   // From FrameCountObserver.
    338   FrameCountObserver* fps_observer = statistics_proxy_.get();
    339   FrameCounts frame_counts;
    340   frame_counts.key_frames = 1;
    341   fps_observer->FrameCountUpdated(frame_counts, excluded_ssrc);
    342 
    343   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    344   EXPECT_TRUE(stats.substreams.empty());
    345 }
    346 
    347 TEST_F(SendStatisticsProxyTest, EncodedResolutionTimesOut) {
    348   static const int kEncodedWidth = 123;
    349   static const int kEncodedHeight = 81;
    350   EncodedImage encoded_image;
    351   encoded_image._encodedWidth = kEncodedWidth;
    352   encoded_image._encodedHeight = kEncodedHeight;
    353 
    354   RTPVideoHeader rtp_video_header;
    355 
    356   rtp_video_header.simulcastIdx = 0;
    357   statistics_proxy_->OnSendEncodedImage(encoded_image, &rtp_video_header);
    358   rtp_video_header.simulcastIdx = 1;
    359   statistics_proxy_->OnSendEncodedImage(encoded_image, &rtp_video_header);
    360 
    361   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    362   EXPECT_EQ(kEncodedWidth, stats.substreams[config_.rtp.ssrcs[0]].width);
    363   EXPECT_EQ(kEncodedHeight, stats.substreams[config_.rtp.ssrcs[0]].height);
    364   EXPECT_EQ(kEncodedWidth, stats.substreams[config_.rtp.ssrcs[1]].width);
    365   EXPECT_EQ(kEncodedHeight, stats.substreams[config_.rtp.ssrcs[1]].height);
    366 
    367   // Forward almost to timeout, this should not have removed stats.
    368   fake_clock_.AdvanceTimeMilliseconds(SendStatisticsProxy::kStatsTimeoutMs - 1);
    369   stats = statistics_proxy_->GetStats();
    370   EXPECT_EQ(kEncodedWidth, stats.substreams[config_.rtp.ssrcs[0]].width);
    371   EXPECT_EQ(kEncodedHeight, stats.substreams[config_.rtp.ssrcs[0]].height);
    372 
    373   // Update the first SSRC with bogus RTCP stats to make sure that encoded
    374   // resolution still times out (no global timeout for all stats).
    375   RtcpStatistics rtcp_statistics;
    376   RtcpStatisticsCallback* rtcp_stats = statistics_proxy_.get();
    377   rtcp_stats->StatisticsUpdated(rtcp_statistics, config_.rtp.ssrcs[0]);
    378 
    379   // Report stats for second SSRC to make sure it's not outdated along with the
    380   // first SSRC.
    381   rtp_video_header.simulcastIdx = 1;
    382   statistics_proxy_->OnSendEncodedImage(encoded_image, &rtp_video_header);
    383 
    384   // Forward 1 ms, reach timeout, substream 0 should have no resolution
    385   // reported, but substream 1 should.
    386   fake_clock_.AdvanceTimeMilliseconds(1);
    387   stats = statistics_proxy_->GetStats();
    388   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[0]].width);
    389   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[0]].height);
    390   EXPECT_EQ(kEncodedWidth, stats.substreams[config_.rtp.ssrcs[1]].width);
    391   EXPECT_EQ(kEncodedHeight, stats.substreams[config_.rtp.ssrcs[1]].height);
    392 }
    393 
    394 TEST_F(SendStatisticsProxyTest, ClearsResolutionFromInactiveSsrcs) {
    395   static const int kEncodedWidth = 123;
    396   static const int kEncodedHeight = 81;
    397   EncodedImage encoded_image;
    398   encoded_image._encodedWidth = kEncodedWidth;
    399   encoded_image._encodedHeight = kEncodedHeight;
    400 
    401   RTPVideoHeader rtp_video_header;
    402 
    403   rtp_video_header.simulcastIdx = 0;
    404   statistics_proxy_->OnSendEncodedImage(encoded_image, &rtp_video_header);
    405   rtp_video_header.simulcastIdx = 1;
    406   statistics_proxy_->OnSendEncodedImage(encoded_image, &rtp_video_header);
    407 
    408   statistics_proxy_->OnInactiveSsrc(config_.rtp.ssrcs[1]);
    409   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    410   EXPECT_EQ(kEncodedWidth, stats.substreams[config_.rtp.ssrcs[0]].width);
    411   EXPECT_EQ(kEncodedHeight, stats.substreams[config_.rtp.ssrcs[0]].height);
    412   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[1]].width);
    413   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[1]].height);
    414 }
    415 
    416 TEST_F(SendStatisticsProxyTest, ClearsBitratesFromInactiveSsrcs) {
    417   BitrateStatistics bitrate;
    418   bitrate.bitrate_bps = 42;
    419   BitrateStatisticsObserver* observer = statistics_proxy_.get();
    420   observer->Notify(bitrate, bitrate, config_.rtp.ssrcs[0]);
    421   observer->Notify(bitrate, bitrate, config_.rtp.ssrcs[1]);
    422 
    423   statistics_proxy_->OnInactiveSsrc(config_.rtp.ssrcs[1]);
    424 
    425   VideoSendStream::Stats stats = statistics_proxy_->GetStats();
    426   EXPECT_EQ(static_cast<int>(bitrate.bitrate_bps),
    427             stats.substreams[config_.rtp.ssrcs[0]].total_bitrate_bps);
    428   EXPECT_EQ(static_cast<int>(bitrate.bitrate_bps),
    429             stats.substreams[config_.rtp.ssrcs[0]].retransmit_bitrate_bps);
    430   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[1]].total_bitrate_bps);
    431   EXPECT_EQ(0, stats.substreams[config_.rtp.ssrcs[1]].retransmit_bitrate_bps);
    432 }
    433 
    434 }  // namespace webrtc
    435