OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2015 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2015 The WebRTC project authors. All Rights Reserved. |
3 * | 3 * |
4 * Use of this source code is governed by a BSD-style license | 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 | 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 | 6 * tree. An additional intellectual property rights grant can be found |
7 * in the file PATENTS. All contributing project authors may | 7 * in the file PATENTS. All contributing project authors may |
8 * be found in the AUTHORS file in the root of the source tree. | 8 * be found in the AUTHORS file in the root of the source tree. |
9 */ | 9 */ |
10 | 10 |
(...skipping 15 matching lines...) Expand all Loading... |
26 // Used by all send streams with adaptive bitrate, to get the currently | 26 // Used by all send streams with adaptive bitrate, to get the currently |
27 // allocated bitrate for the send stream. The current network properties are | 27 // allocated bitrate for the send stream. The current network properties are |
28 // given at the same time, to let the send stream decide about possible loss | 28 // given at the same time, to let the send stream decide about possible loss |
29 // protection. | 29 // protection. |
30 class BitrateAllocatorObserver { | 30 class BitrateAllocatorObserver { |
31 public: | 31 public: |
32 // Returns the amount of protection used by the BitrateAllocatorObserver | 32 // Returns the amount of protection used by the BitrateAllocatorObserver |
33 // implementation, as bitrate in bps. | 33 // implementation, as bitrate in bps. |
34 virtual uint32_t OnBitrateUpdated(uint32_t bitrate_bps, | 34 virtual uint32_t OnBitrateUpdated(uint32_t bitrate_bps, |
35 uint8_t fraction_loss, | 35 uint8_t fraction_loss, |
36 int64_t rtt) = 0; | 36 int64_t rtt, |
| 37 int probing_interval_ms) = 0; |
| 38 |
37 protected: | 39 protected: |
38 virtual ~BitrateAllocatorObserver() {} | 40 virtual ~BitrateAllocatorObserver() {} |
39 }; | 41 }; |
40 | 42 |
41 // Usage: this class will register multiple RtcpBitrateObserver's one at each | 43 // Usage: this class will register multiple RtcpBitrateObserver's one at each |
42 // RTCP module. It will aggregate the results and run one bandwidth estimation | 44 // RTCP module. It will aggregate the results and run one bandwidth estimation |
43 // and push the result to the encoders via BitrateAllocatorObserver(s). | 45 // and push the result to the encoders via BitrateAllocatorObserver(s). |
44 class BitrateAllocator { | 46 class BitrateAllocator { |
45 public: | 47 public: |
46 // Used to get notified when send stream limits such as the minimum send | 48 // Used to get notified when send stream limits such as the minimum send |
47 // bitrate and max padding bitrate is changed. | 49 // bitrate and max padding bitrate is changed. |
48 class LimitObserver { | 50 class LimitObserver { |
49 public: | 51 public: |
50 virtual void OnAllocationLimitsChanged( | 52 virtual void OnAllocationLimitsChanged( |
51 uint32_t min_send_bitrate_bps, | 53 uint32_t min_send_bitrate_bps, |
52 uint32_t max_padding_bitrate_bps) = 0; | 54 uint32_t max_padding_bitrate_bps) = 0; |
53 | 55 |
54 protected: | 56 protected: |
55 virtual ~LimitObserver() {} | 57 virtual ~LimitObserver() {} |
56 }; | 58 }; |
57 | 59 |
58 explicit BitrateAllocator(LimitObserver* limit_observer); | 60 explicit BitrateAllocator(LimitObserver* limit_observer); |
59 ~BitrateAllocator(); | 61 ~BitrateAllocator(); |
60 | 62 |
61 // Allocate target_bitrate across the registered BitrateAllocatorObservers. | 63 // Allocate target_bitrate across the registered BitrateAllocatorObservers. |
62 void OnNetworkChanged(uint32_t target_bitrate_bps, | 64 void OnNetworkChanged(uint32_t target_bitrate_bps, |
63 uint8_t fraction_loss, | 65 uint8_t fraction_loss, |
64 int64_t rtt); | 66 int64_t rtt, |
| 67 int probing_interval_ms); |
65 | 68 |
66 // Set the start and max send bitrate used by the bandwidth management. | 69 // Set the start and max send bitrate used by the bandwidth management. |
67 // | 70 // |
68 // |observer| updates bitrates if already in use. | 71 // |observer| updates bitrates if already in use. |
69 // |min_bitrate_bps| = 0 equals no min bitrate. | 72 // |min_bitrate_bps| = 0 equals no min bitrate. |
70 // |max_bitrate_bps| = 0 equals no max bitrate. | 73 // |max_bitrate_bps| = 0 equals no max bitrate. |
71 // |enforce_min_bitrate| = 'true' will allocate at least |min_bitrate_bps| for | 74 // |enforce_min_bitrate| = 'true' will allocate at least |min_bitrate_bps| for |
72 // this observer, even if the BWE is too low, 'false' will allocate 0 to | 75 // this observer, even if the BWE is too low, 'false' will allocate 0 to |
73 // the observer if BWE doesn't allow |min_bitrate_bps|. | 76 // the observer if BWE doesn't allow |min_bitrate_bps|. |
74 // Note that |observer|->OnBitrateUpdated() will be called within the scope of | 77 // Note that |observer|->OnBitrateUpdated() will be called within the scope of |
(...skipping 75 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
150 uint32_t sum_min_bitrates); | 153 uint32_t sum_min_bitrates); |
151 | 154 |
152 rtc::SequencedTaskChecker sequenced_checker_; | 155 rtc::SequencedTaskChecker sequenced_checker_; |
153 LimitObserver* const limit_observer_ GUARDED_BY(&sequenced_checker_); | 156 LimitObserver* const limit_observer_ GUARDED_BY(&sequenced_checker_); |
154 // Stored in a list to keep track of the insertion order. | 157 // Stored in a list to keep track of the insertion order. |
155 ObserverConfigs bitrate_observer_configs_ GUARDED_BY(&sequenced_checker_); | 158 ObserverConfigs bitrate_observer_configs_ GUARDED_BY(&sequenced_checker_); |
156 uint32_t last_bitrate_bps_ GUARDED_BY(&sequenced_checker_); | 159 uint32_t last_bitrate_bps_ GUARDED_BY(&sequenced_checker_); |
157 uint32_t last_non_zero_bitrate_bps_ GUARDED_BY(&sequenced_checker_); | 160 uint32_t last_non_zero_bitrate_bps_ GUARDED_BY(&sequenced_checker_); |
158 uint8_t last_fraction_loss_ GUARDED_BY(&sequenced_checker_); | 161 uint8_t last_fraction_loss_ GUARDED_BY(&sequenced_checker_); |
159 int64_t last_rtt_ GUARDED_BY(&sequenced_checker_); | 162 int64_t last_rtt_ GUARDED_BY(&sequenced_checker_); |
| 163 int last_probing_interval_ms_ GUARDED_BY(&sequenced_checker_); |
160 // Number of mute events based on too low BWE, not network up/down. | 164 // Number of mute events based on too low BWE, not network up/down. |
161 int num_pause_events_ GUARDED_BY(&sequenced_checker_); | 165 int num_pause_events_ GUARDED_BY(&sequenced_checker_); |
162 Clock* const clock_ GUARDED_BY(&sequenced_checker_); | 166 Clock* const clock_ GUARDED_BY(&sequenced_checker_); |
163 int64_t last_bwe_log_time_ GUARDED_BY(&sequenced_checker_); | 167 int64_t last_bwe_log_time_ GUARDED_BY(&sequenced_checker_); |
164 }; | 168 }; |
165 } // namespace webrtc | 169 } // namespace webrtc |
166 #endif // WEBRTC_CALL_BITRATE_ALLOCATOR_H_ | 170 #endif // WEBRTC_CALL_BITRATE_ALLOCATOR_H_ |
OLD | NEW |