OLD | NEW |
| (Empty) |
1 /* | |
2 * Copyright 2011 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_BASE_BANDWIDTHSMOOTHER_H_ | |
12 #define WEBRTC_BASE_BANDWIDTHSMOOTHER_H_ | |
13 | |
14 #include "webrtc/base/rollingaccumulator.h" | |
15 #include "webrtc/base/timeutils.h" | |
16 | |
17 namespace rtc { | |
18 | |
19 // The purpose of BandwidthSmoother is to smooth out bandwidth | |
20 // estimations so that 'trstate' messages can be triggered when we | |
21 // are "sure" there is sufficient bandwidth. To avoid frequent fluctuations, | |
22 // we take a slightly pessimistic view of our bandwidth. We only increase | |
23 // our estimation when we have sampled bandwidth measurements of values | |
24 // at least as large as the current estimation * percent_increase | |
25 // for at least time_between_increase time. If a sampled bandwidth | |
26 // is less than our current estimation we immediately decrease our estimation | |
27 // to that sampled value. | |
28 // We retain the initial bandwidth guess as our current bandwidth estimation | |
29 // until we have received (min_sample_count_percent * samples_count_to_average) | |
30 // number of samples. Min_sample_count_percent must be in range [0, 1]. | |
31 class BandwidthSmoother { | |
32 public: | |
33 BandwidthSmoother(int initial_bandwidth_guess, | |
34 uint32_t time_between_increase, | |
35 double percent_increase, | |
36 size_t samples_count_to_average, | |
37 double min_sample_count_percent); | |
38 ~BandwidthSmoother(); | |
39 | |
40 // Samples a new bandwidth measurement. | |
41 // bandwidth is expected to be non-negative. | |
42 // returns true if the bandwidth estimation changed | |
43 bool Sample(uint32_t sample_time, int bandwidth); | |
44 | |
45 int get_bandwidth_estimation() const { | |
46 return bandwidth_estimation_; | |
47 } | |
48 | |
49 private: | |
50 uint32_t time_between_increase_; | |
51 double percent_increase_; | |
52 uint32_t time_at_last_change_; | |
53 int bandwidth_estimation_; | |
54 RollingAccumulator<int> accumulator_; | |
55 double min_sample_count_percent_; | |
56 }; | |
57 | |
58 } // namespace rtc | |
59 | |
60 #endif // WEBRTC_BASE_BANDWIDTHSMOOTHER_H_ | |
OLD | NEW |