Line data    Source code

       1             : /*
       2             :  *  Copyright (c) 2015 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             : #ifndef WEBRTC_MODULES_RTP_RTCP_SOURCE_PACKET_LOSS_STATS_H_
      12             : #define WEBRTC_MODULES_RTP_RTCP_SOURCE_PACKET_LOSS_STATS_H_
      13             : 
      14             : #include <stdint.h>
      15             : #include <set>
      16             : 
      17             : namespace webrtc {
      18             : 
      19             : // Keeps track of statistics of packet loss including whether losses are a
      20             : // single packet or multiple packets in a row.
      21             : class PacketLossStats {
      22             :  public:
      23             :   PacketLossStats();
      24           0 :   ~PacketLossStats() {}
      25             : 
      26             :   // Adds a lost packet to the stats by sequence number.
      27             :   void AddLostPacket(uint16_t sequence_number);
      28             : 
      29             :   // Queries the number of packets that were lost by themselves, no neighboring
      30             :   // packets were lost.
      31             :   int GetSingleLossCount() const;
      32             : 
      33             :   // Queries the number of times that multiple packets with sequential numbers
      34             :   // were lost. This is the number of events with more than one packet lost,
      35             :   // regardless of the size of the event;
      36             :   int GetMultipleLossEventCount() const;
      37             : 
      38             :   // Queries the number of packets lost in multiple packet loss events. Combined
      39             :   // with the event count, this can be used to determine the average event size.
      40             :   int GetMultipleLossPacketCount() const;
      41             : 
      42             :  private:
      43             :   std::set<uint16_t> lost_packets_buffer_;
      44             :   std::set<uint16_t> lost_packets_wrapped_buffer_;
      45             :   int single_loss_historic_count_;
      46             :   int multiple_loss_historic_event_count_;
      47             :   int multiple_loss_historic_packet_count_;
      48             : 
      49             :   void ComputeLossCounts(int* out_single_loss_count,
      50             :                          int* out_multiple_loss_event_count,
      51             :                          int* out_multiple_loss_packet_count) const;
      52             :   void PruneBuffer();
      53             : };
      54             : 
      55             : }  // namespace webrtc
      56             : 
      57             : #endif  // WEBRTC_MODULES_RTP_RTCP_SOURCE_PACKET_LOSS_STATS_H_