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, | 36 int64_t rtt) = 0; |
37 int64_t probing_interval_ms) = 0; | |
38 | |
39 protected: | 37 protected: |
40 virtual ~BitrateAllocatorObserver() {} | 38 virtual ~BitrateAllocatorObserver() {} |
41 }; | 39 }; |
42 | 40 |
43 // Usage: this class will register multiple RtcpBitrateObserver's one at each | 41 // Usage: this class will register multiple RtcpBitrateObserver's one at each |
44 // RTCP module. It will aggregate the results and run one bandwidth estimation | 42 // RTCP module. It will aggregate the results and run one bandwidth estimation |
45 // and push the result to the encoders via BitrateAllocatorObserver(s). | 43 // and push the result to the encoders via BitrateAllocatorObserver(s). |
46 class BitrateAllocator { | 44 class BitrateAllocator { |
47 public: | 45 public: |
48 // Used to get notified when send stream limits such as the minimum send | 46 // Used to get notified when send stream limits such as the minimum send |
49 // bitrate and max padding bitrate is changed. | 47 // bitrate and max padding bitrate is changed. |
50 class LimitObserver { | 48 class LimitObserver { |
51 public: | 49 public: |
52 virtual void OnAllocationLimitsChanged( | 50 virtual void OnAllocationLimitsChanged( |
53 uint32_t min_send_bitrate_bps, | 51 uint32_t min_send_bitrate_bps, |
54 uint32_t max_padding_bitrate_bps) = 0; | 52 uint32_t max_padding_bitrate_bps) = 0; |
55 | 53 |
56 protected: | 54 protected: |
57 virtual ~LimitObserver() {} | 55 virtual ~LimitObserver() {} |
58 }; | 56 }; |
59 | 57 |
60 explicit BitrateAllocator(LimitObserver* limit_observer); | 58 explicit BitrateAllocator(LimitObserver* limit_observer); |
61 ~BitrateAllocator(); | 59 ~BitrateAllocator(); |
62 | 60 |
63 // Allocate target_bitrate across the registered BitrateAllocatorObservers. | 61 // Allocate target_bitrate across the registered BitrateAllocatorObservers. |
64 void OnNetworkChanged(uint32_t target_bitrate_bps, | 62 void OnNetworkChanged(uint32_t target_bitrate_bps, |
65 uint8_t fraction_loss, | 63 uint8_t fraction_loss, |
66 int64_t rtt, | 64 int64_t rtt); |
67 int64_t probing_interval_ms); | |
68 | 65 |
69 // Set the start and max send bitrate used by the bandwidth management. | 66 // Set the start and max send bitrate used by the bandwidth management. |
70 // | 67 // |
71 // |observer| updates bitrates if already in use. | 68 // |observer| updates bitrates if already in use. |
72 // |min_bitrate_bps| = 0 equals no min bitrate. | 69 // |min_bitrate_bps| = 0 equals no min bitrate. |
73 // |max_bitrate_bps| = 0 equals no max bitrate. | 70 // |max_bitrate_bps| = 0 equals no max bitrate. |
74 // |enforce_min_bitrate| = 'true' will allocate at least |min_bitrate_bps| for | 71 // |enforce_min_bitrate| = 'true' will allocate at least |min_bitrate_bps| for |
75 // this observer, even if the BWE is too low, 'false' will allocate 0 to | 72 // this observer, even if the BWE is too low, 'false' will allocate 0 to |
76 // the observer if BWE doesn't allow |min_bitrate_bps|. | 73 // the observer if BWE doesn't allow |min_bitrate_bps|. |
77 // Note that |observer|->OnBitrateUpdated() will be called within the scope of | 74 // Note that |observer|->OnBitrateUpdated() will be called within the scope of |
(...skipping 75 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
153 uint32_t sum_min_bitrates); | 150 uint32_t sum_min_bitrates); |
154 | 151 |
155 rtc::SequencedTaskChecker sequenced_checker_; | 152 rtc::SequencedTaskChecker sequenced_checker_; |
156 LimitObserver* const limit_observer_ GUARDED_BY(&sequenced_checker_); | 153 LimitObserver* const limit_observer_ GUARDED_BY(&sequenced_checker_); |
157 // Stored in a list to keep track of the insertion order. | 154 // Stored in a list to keep track of the insertion order. |
158 ObserverConfigs bitrate_observer_configs_ GUARDED_BY(&sequenced_checker_); | 155 ObserverConfigs bitrate_observer_configs_ GUARDED_BY(&sequenced_checker_); |
159 uint32_t last_bitrate_bps_ GUARDED_BY(&sequenced_checker_); | 156 uint32_t last_bitrate_bps_ GUARDED_BY(&sequenced_checker_); |
160 uint32_t last_non_zero_bitrate_bps_ GUARDED_BY(&sequenced_checker_); | 157 uint32_t last_non_zero_bitrate_bps_ GUARDED_BY(&sequenced_checker_); |
161 uint8_t last_fraction_loss_ GUARDED_BY(&sequenced_checker_); | 158 uint8_t last_fraction_loss_ GUARDED_BY(&sequenced_checker_); |
162 int64_t last_rtt_ GUARDED_BY(&sequenced_checker_); | 159 int64_t last_rtt_ GUARDED_BY(&sequenced_checker_); |
163 int64_t last_probing_interval_ms_ GUARDED_BY(&sequenced_checker_); | |
164 // Number of mute events based on too low BWE, not network up/down. | 160 // Number of mute events based on too low BWE, not network up/down. |
165 int num_pause_events_ GUARDED_BY(&sequenced_checker_); | 161 int num_pause_events_ GUARDED_BY(&sequenced_checker_); |
166 Clock* const clock_ GUARDED_BY(&sequenced_checker_); | 162 Clock* const clock_ GUARDED_BY(&sequenced_checker_); |
167 int64_t last_bwe_log_time_ GUARDED_BY(&sequenced_checker_); | 163 int64_t last_bwe_log_time_ GUARDED_BY(&sequenced_checker_); |
168 }; | 164 }; |
169 } // namespace webrtc | 165 } // namespace webrtc |
170 #endif // WEBRTC_CALL_BITRATE_ALLOCATOR_H_ | 166 #endif // WEBRTC_CALL_BITRATE_ALLOCATOR_H_ |
OLD | NEW |