OLD | NEW |
1 /* | 1 /* |
2 * Copyright (c) 2016 The WebRTC project authors. All Rights Reserved. | 2 * Copyright (c) 2016 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 |
11 #ifndef WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_BAS
ED_H_ | 11 #ifndef WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_BAS
ED_H_ |
12 #define WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_BAS
ED_H_ | 12 #define WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_BAS
ED_H_ |
13 | 13 |
14 #include <memory> | 14 #include <memory> |
15 | 15 |
16 #include "webrtc/base/constructormagic.h" | 16 #include "webrtc/base/constructormagic.h" |
17 #include "webrtc/common_audio/smoothing_filter.h" | 17 #include "webrtc/common_audio/smoothing_filter.h" |
18 #include "webrtc/modules/audio_coding/audio_network_adaptor/controller.h" | 18 #include "webrtc/modules/audio_coding/audio_network_adaptor/controller.h" |
| 19 #include "webrtc/modules/audio_coding/audio_network_adaptor/util/threshold_curve
.h" |
19 | 20 |
20 namespace webrtc { | 21 namespace webrtc { |
21 | 22 |
22 class FecControllerPlrBased final : public Controller { | 23 class FecControllerPlrBased final : public Controller { |
23 public: | 24 public: |
24 struct Config { | 25 struct Config { |
25 struct Threshold { | |
26 // Threshold defines a curve in the bandwidth/packet-loss domain. The | |
27 // curve is characterized by the two conjunction points: A and B. | |
28 // | |
29 // packet ^ | | |
30 // loss | A| | |
31 // | \ A: (low_bandwidth_bps, low_bandwidth_packet_loss) | |
32 // | \ B: (high_bandwidth_bps, high_bandwidth_packet_loss) | |
33 // | B\________ | |
34 // |---------------> bandwidth | |
35 Threshold(int low_bandwidth_bps, | |
36 float low_bandwidth_packet_loss, | |
37 int high_bandwidth_bps, | |
38 float high_bandwidth_packet_loss); | |
39 int low_bandwidth_bps; | |
40 float low_bandwidth_packet_loss; | |
41 int high_bandwidth_bps; | |
42 float high_bandwidth_packet_loss; | |
43 }; | |
44 | |
45 // |fec_enabling_threshold| defines a curve, above which FEC should be | 26 // |fec_enabling_threshold| defines a curve, above which FEC should be |
46 // enabled. |fec_disabling_threshold| defines a curve, under which FEC | 27 // enabled. |fec_disabling_threshold| defines a curve, under which FEC |
47 // should be disabled. See below | 28 // should be disabled. See below |
48 // | 29 // |
49 // packet-loss ^ | | | 30 // packet-loss ^ | | |
50 // | | | FEC | 31 // | | | FEC |
51 // | \ \ ON | 32 // | \ \ ON |
52 // | FEC \ \_______ fec_enabling_threshold | 33 // | FEC \ \_______ fec_enabling_threshold |
53 // | OFF \_________ fec_disabling_threshold | 34 // | OFF \_________ fec_disabling_threshold |
54 // |-----------------> bandwidth | 35 // |-----------------> bandwidth |
55 Config(bool initial_fec_enabled, | 36 Config(bool initial_fec_enabled, |
56 const Threshold& fec_enabling_threshold, | 37 const ThresholdCurve& fec_enabling_threshold, |
57 const Threshold& fec_disabling_threshold, | 38 const ThresholdCurve& fec_disabling_threshold, |
58 int time_constant_ms, | 39 int time_constant_ms, |
59 const Clock* clock); | 40 const Clock* clock); |
60 bool initial_fec_enabled; | 41 bool initial_fec_enabled; |
61 Threshold fec_enabling_threshold; | 42 ThresholdCurve fec_enabling_threshold; |
62 Threshold fec_disabling_threshold; | 43 ThresholdCurve fec_disabling_threshold; |
63 int time_constant_ms; | 44 int time_constant_ms; |
64 const Clock* clock; | 45 const Clock* clock; |
65 }; | 46 }; |
66 | 47 |
67 // Dependency injection for testing. | 48 // Dependency injection for testing. |
68 FecControllerPlrBased(const Config& config, | 49 FecControllerPlrBased(const Config& config, |
69 std::unique_ptr<SmoothingFilter> smoothing_filter); | 50 std::unique_ptr<SmoothingFilter> smoothing_filter); |
70 | 51 |
71 explicit FecControllerPlrBased(const Config& config); | 52 explicit FecControllerPlrBased(const Config& config); |
72 | 53 |
73 ~FecControllerPlrBased() override; | 54 ~FecControllerPlrBased() override; |
74 | 55 |
75 void UpdateNetworkMetrics(const NetworkMetrics& network_metrics) override; | 56 void UpdateNetworkMetrics(const NetworkMetrics& network_metrics) override; |
76 | 57 |
77 void MakeDecision(AudioNetworkAdaptor::EncoderRuntimeConfig* config) override; | 58 void MakeDecision(AudioNetworkAdaptor::EncoderRuntimeConfig* config) override; |
78 | 59 |
79 private: | 60 private: |
80 // Characterize Threshold with packet_loss = slope * bandwidth + offset. | |
81 struct ThresholdInfo { | |
82 explicit ThresholdInfo(const Config::Threshold& threshold); | |
83 float slope; | |
84 float offset; | |
85 }; | |
86 | |
87 float GetPacketLossThreshold(int bandwidth_bps, | |
88 const Config::Threshold& threshold, | |
89 const ThresholdInfo& threshold_info) const; | |
90 | |
91 bool FecEnablingDecision(const rtc::Optional<float>& packet_loss) const; | 61 bool FecEnablingDecision(const rtc::Optional<float>& packet_loss) const; |
92 bool FecDisablingDecision(const rtc::Optional<float>& packet_loss) const; | 62 bool FecDisablingDecision(const rtc::Optional<float>& packet_loss) const; |
93 | 63 |
94 const Config config_; | 64 const Config config_; |
95 bool fec_enabled_; | 65 bool fec_enabled_; |
96 rtc::Optional<int> uplink_bandwidth_bps_; | 66 rtc::Optional<int> uplink_bandwidth_bps_; |
97 const std::unique_ptr<SmoothingFilter> packet_loss_smoother_; | 67 const std::unique_ptr<SmoothingFilter> packet_loss_smoother_; |
98 | 68 |
99 const ThresholdInfo fec_enabling_threshold_info_; | |
100 const ThresholdInfo fec_disabling_threshold_info_; | |
101 | |
102 RTC_DISALLOW_COPY_AND_ASSIGN(FecControllerPlrBased); | 69 RTC_DISALLOW_COPY_AND_ASSIGN(FecControllerPlrBased); |
103 }; | 70 }; |
104 | 71 |
105 } // namespace webrtc | 72 } // namespace webrtc |
106 | 73 |
107 #endif // WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_
BASED_H_ | 74 #endif // WEBRTC_MODULES_AUDIO_CODING_AUDIO_NETWORK_ADAPTOR_FEC_CONTROLLER_PLR_
BASED_H_ |
OLD | NEW |