| 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 |