Chromium Code Reviews
chromiumcodereview-hr@appspot.gserviceaccount.com (chromiumcodereview-hr) | Please choose your nickname with Settings | Help | Chromium Project | Gerrit Changes | Sign out
(288)

Side by Side Diff: webrtc/modules/audio_coding/codecs/audio_encoder.h

Issue 2411613002: Renaming AudioEncoder::SetTargetBitrate and SetProjectedPacketLossRate. (Closed)
Patch Set: rebasing Created 4 years ago
Use n/p to move between diff chunks; N/P to move between comments. Draft comments are only viewable by you.
Jump to:
View unified diff | Download patch
OLDNEW
1 /* 1 /*
2 * Copyright (c) 2014 The WebRTC project authors. All Rights Reserved. 2 * Copyright (c) 2014 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 126 matching lines...) Expand 10 before | Expand all | Expand 10 after
137 // The default implementation just returns false. 137 // The default implementation just returns false.
138 enum class Application { kSpeech, kAudio }; 138 enum class Application { kSpeech, kAudio };
139 virtual bool SetApplication(Application application); 139 virtual bool SetApplication(Application application);
140 140
141 // Tells the encoder about the highest sample rate the decoder is expected to 141 // Tells the encoder about the highest sample rate the decoder is expected to
142 // use when decoding the bitstream. The encoder would typically use this 142 // use when decoding the bitstream. The encoder would typically use this
143 // information to adjust the quality of the encoding. The default 143 // information to adjust the quality of the encoding. The default
144 // implementation does nothing. 144 // implementation does nothing.
145 virtual void SetMaxPlaybackRate(int frequency_hz); 145 virtual void SetMaxPlaybackRate(int frequency_hz);
146 146
147 // Tells the encoder what the projected packet loss rate is. The rate is in
148 // the range [0.0, 1.0]. The encoder would typically use this information to
149 // adjust channel coding efforts, such as FEC. The default implementation
150 // does nothing.
151 virtual void SetProjectedPacketLossRate(double fraction);
152
153 // Tells the encoder what average bitrate we'd like it to produce. The
154 // encoder is free to adjust or disregard the given bitrate (the default
155 // implementation does the latter).
156 virtual void SetTargetBitrate(int target_bps);
157
158 // Causes this encoder to let go of any other encoders it contains, and 147 // Causes this encoder to let go of any other encoders it contains, and
159 // returns a pointer to an array where they are stored (which is required to 148 // returns a pointer to an array where they are stored (which is required to
160 // live as long as this encoder). Unless the returned array is empty, you may 149 // live as long as this encoder). Unless the returned array is empty, you may
161 // not call any methods on this encoder afterwards, except for the 150 // not call any methods on this encoder afterwards, except for the
162 // destructor. The default implementation just returns an empty array. 151 // destructor. The default implementation just returns an empty array.
163 // NOTE: This method is subject to change. Do not call or override it. 152 // NOTE: This method is subject to change. Do not call or override it.
164 virtual rtc::ArrayView<std::unique_ptr<AudioEncoder>> 153 virtual rtc::ArrayView<std::unique_ptr<AudioEncoder>>
165 ReclaimContainedEncoders(); 154 ReclaimContainedEncoders();
166 155
167 // Enables audio network adaptor. Returns true if successful. 156 // Enables audio network adaptor. Returns true if successful.
168 virtual bool EnableAudioNetworkAdaptor(const std::string& config_string, 157 virtual bool EnableAudioNetworkAdaptor(const std::string& config_string,
169 const Clock* clock); 158 const Clock* clock);
170 159
171 // Disables audio network adaptor. 160 // Disables audio network adaptor.
172 virtual void DisableAudioNetworkAdaptor(); 161 virtual void DisableAudioNetworkAdaptor();
173 162
174 // Provides uplink bandwidth to this encoder to allow it to adapt. 163 // Provides uplink bandwidth to this encoder to allow it to adapt.
175 virtual void OnReceivedUplinkBandwidth(int uplink_bandwidth_bps); 164 virtual void OnReceivedUplinkBandwidth(int uplink_bandwidth_bps);
176 165
177 // Provides uplink packet loss fraction to this encoder to allow it to adapt. 166 // Provides uplink packet loss fraction to this encoder to allow it to adapt.
167 // |uplink_packet_loss_fraction| is in the range [0.0, 1.0].
178 virtual void OnReceivedUplinkPacketLossFraction( 168 virtual void OnReceivedUplinkPacketLossFraction(
179 float uplink_packet_loss_fraction); 169 float uplink_packet_loss_fraction);
180 170
181 // Provides target audio bitrate to this encoder to allow it to adapt. 171 // Provides target audio bitrate to this encoder to allow it to adapt.
182 virtual void OnReceivedTargetAudioBitrate(int target_audio_bitrate_bps); 172 virtual void OnReceivedTargetAudioBitrate(int target_audio_bitrate_bps);
183 173
184 // Provides RTT to this encoder to allow it to adapt. 174 // Provides RTT to this encoder to allow it to adapt.
185 virtual void OnReceivedRtt(int rtt_ms); 175 virtual void OnReceivedRtt(int rtt_ms);
186 176
187 // To allow encoder to adapt its frame length, it must be provided the frame 177 // To allow encoder to adapt its frame length, it must be provided the frame
188 // length range that receivers can accept. 178 // length range that receivers can accept.
189 virtual void SetReceiverFrameLengthRange(int min_frame_length_ms, 179 virtual void SetReceiverFrameLengthRange(int min_frame_length_ms,
190 int max_frame_length_ms); 180 int max_frame_length_ms);
191 181
192 protected: 182 protected:
193 // Subclasses implement this to perform the actual encoding. Called by 183 // Subclasses implement this to perform the actual encoding. Called by
194 // Encode(). 184 // Encode().
195 virtual EncodedInfo EncodeImpl(uint32_t rtp_timestamp, 185 virtual EncodedInfo EncodeImpl(uint32_t rtp_timestamp,
196 rtc::ArrayView<const int16_t> audio, 186 rtc::ArrayView<const int16_t> audio,
197 rtc::Buffer* encoded) = 0; 187 rtc::Buffer* encoded) = 0;
198 }; 188 };
199 } // namespace webrtc 189 } // namespace webrtc
200 #endif // WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_ENCODER_H_ 190 #endif // WEBRTC_MODULES_AUDIO_CODING_CODECS_AUDIO_ENCODER_H_
OLDNEW
« no previous file with comments | « webrtc/modules/audio_coding/acm2/audio_coding_module.cc ('k') | webrtc/modules/audio_coding/codecs/audio_encoder.cc » ('j') | no next file with comments »

Powered by Google App Engine
This is Rietveld 408576698