blob: ef2e0e50fa7a96c765e04741bc9b2a5fb3d8acdb [file] [log] [blame]
turaj@webrtc.org7959e162013-09-12 18:30:26 +00001/*
2 * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved.
3 *
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
6 * tree. An additional intellectual property rights grant can be found
7 * in the file PATENTS. All contributing project authors may
8 * be found in the AUTHORS file in the root of the source tree.
9 */
10
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020011#include "modules/audio_coding/include/audio_coding_module.h"
turaj@webrtc.org7959e162013-09-12 18:30:26 +000012
Yves Gerey988cc082018-10-23 12:03:01 +020013#include <assert.h>
Jonas Olssona4d87372019-07-05 19:08:33 +020014
Jonathan Yu36344a02017-07-30 01:55:34 -070015#include <algorithm>
Yves Gerey988cc082018-10-23 12:03:01 +020016#include <cstdint>
Jonathan Yu36344a02017-07-30 01:55:34 -070017
Niels Möller2edab4c2018-10-22 09:48:08 +020018#include "absl/strings/match.h"
Yves Gerey988cc082018-10-23 12:03:01 +020019#include "api/array_view.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020020#include "modules/audio_coding/acm2/acm_receiver.h"
21#include "modules/audio_coding/acm2/acm_resampler.h"
Fredrik Solenbergbbf21a32018-04-12 22:44:09 +020022#include "modules/include/module_common_types.h"
Yves Gerey988cc082018-10-23 12:03:01 +020023#include "modules/include/module_common_types_public.h"
24#include "rtc_base/buffer.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020025#include "rtc_base/checks.h"
Steve Anton10542f22019-01-11 09:11:00 -080026#include "rtc_base/critical_section.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020027#include "rtc_base/logging.h"
Karl Wiberge40468b2017-11-22 10:42:26 +010028#include "rtc_base/numerics/safe_conversions.h"
Yves Gerey988cc082018-10-23 12:03:01 +020029#include "rtc_base/thread_annotations.h"
Mirko Bonadei92ea95e2017-09-15 06:47:31 +020030#include "system_wrappers/include/metrics.h"
turaj@webrtc.org7959e162013-09-12 18:30:26 +000031
32namespace webrtc {
33
kwibergc13ded52016-06-17 06:00:45 -070034namespace {
35
kwibergc13ded52016-06-17 06:00:45 -070036class AudioCodingModuleImpl final : public AudioCodingModule {
37 public:
38 explicit AudioCodingModuleImpl(const AudioCodingModule::Config& config);
39 ~AudioCodingModuleImpl() override;
40
41 /////////////////////////////////////////
42 // Sender
43 //
44
kwiberg24c7c122016-09-28 11:57:10 -070045 void ModifyEncoder(rtc::FunctionView<void(std::unique_ptr<AudioEncoder>*)>
46 modifier) override;
kwibergc13ded52016-06-17 06:00:45 -070047
kwibergc13ded52016-06-17 06:00:45 -070048 // Register a transport callback which will be
49 // called to deliver the encoded buffers.
50 int RegisterTransportCallback(AudioPacketizationCallback* transport) override;
51
52 // Add 10 ms of raw (PCM) audio data to the encoder.
53 int Add10MsData(const AudioFrame& audio_frame) override;
54
55 /////////////////////////////////////////
kwibergc13ded52016-06-17 06:00:45 -070056 // (FEC) Forward Error Correction (codec internal)
57 //
58
kwibergc13ded52016-06-17 06:00:45 -070059 // Set target packet loss rate
60 int SetPacketLossRate(int loss_rate) override;
61
62 /////////////////////////////////////////
63 // (VAD) Voice Activity Detection
64 // and
65 // (CNG) Comfort Noise Generation
66 //
67
kwibergc13ded52016-06-17 06:00:45 -070068 int RegisterVADCallback(ACMVADCallback* vad_callback) override;
69
70 /////////////////////////////////////////
71 // Receiver
72 //
73
74 // Initialize receiver, resets codec database etc.
75 int InitializeReceiver() override;
76
kwiberg1c07c702017-03-27 07:15:49 -070077 void SetReceiveCodecs(const std::map<int, SdpAudioFormat>& codecs) override;
78
kwibergc13ded52016-06-17 06:00:45 -070079 // Incoming packet from network parsed and ready for decode.
80 int IncomingPacket(const uint8_t* incoming_payload,
81 const size_t payload_length,
Niels Möllerafb5dbb2019-02-15 15:21:47 +010082 const RTPHeader& rtp_info) override;
kwibergc13ded52016-06-17 06:00:45 -070083
kwibergc13ded52016-06-17 06:00:45 -070084 // Get 10 milliseconds of raw audio data to play out, and
85 // automatic resample to the requested frequency if > 0.
86 int PlayoutData10Ms(int desired_freq_hz,
87 AudioFrame* audio_frame,
88 bool* muted) override;
kwibergc13ded52016-06-17 06:00:45 -070089
90 /////////////////////////////////////////
91 // Statistics
92 //
93
94 int GetNetworkStatistics(NetworkStatistics* statistics) override;
95
kwibergc13ded52016-06-17 06:00:45 -070096 void GetDecodingCallStatistics(AudioDecodingCallStats* stats) const override;
97
ivoce1198e02017-09-08 08:13:19 -070098 ANAStats GetANAStats() const override;
99
kwibergc13ded52016-06-17 06:00:45 -0700100 private:
101 struct InputData {
102 uint32_t input_timestamp;
103 const int16_t* audio;
104 size_t length_per_channel;
105 size_t audio_channel;
106 // If a re-mix is required (up or down), this buffer will store a re-mixed
107 // version of the input.
108 int16_t buffer[WEBRTC_10MS_PCM_AUDIO];
109 };
110
111 // This member class writes values to the named UMA histogram, but only if
112 // the value has changed since the last time (and always for the first call).
113 class ChangeLogger {
114 public:
115 explicit ChangeLogger(const std::string& histogram_name)
116 : histogram_name_(histogram_name) {}
117 // Logs the new value if it is different from the last logged value, or if
118 // this is the first call.
119 void MaybeLog(int value);
120
121 private:
122 int last_value_ = 0;
123 int first_time_ = true;
124 const std::string histogram_name_;
125 };
126
kwibergc13ded52016-06-17 06:00:45 -0700127 int Add10MsDataInternal(const AudioFrame& audio_frame, InputData* input_data)
danilchap56359be2017-09-07 07:53:45 -0700128 RTC_EXCLUSIVE_LOCKS_REQUIRED(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700129 int Encode(const InputData& input_data)
danilchap56359be2017-09-07 07:53:45 -0700130 RTC_EXCLUSIVE_LOCKS_REQUIRED(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700131
danilchap56359be2017-09-07 07:53:45 -0700132 int InitializeReceiverSafe() RTC_EXCLUSIVE_LOCKS_REQUIRED(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700133
134 bool HaveValidEncoder(const char* caller_name) const
danilchap56359be2017-09-07 07:53:45 -0700135 RTC_EXCLUSIVE_LOCKS_REQUIRED(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700136
137 // Preprocessing of input audio, including resampling and down-mixing if
138 // required, before pushing audio into encoder's buffer.
139 //
140 // in_frame: input audio-frame
141 // ptr_out: pointer to output audio_frame. If no preprocessing is required
142 // |ptr_out| will be pointing to |in_frame|, otherwise pointing to
143 // |preprocess_frame_|.
144 //
145 // Return value:
146 // -1: if encountering an error.
147 // 0: otherwise.
148 int PreprocessToAddData(const AudioFrame& in_frame,
149 const AudioFrame** ptr_out)
danilchap56359be2017-09-07 07:53:45 -0700150 RTC_EXCLUSIVE_LOCKS_REQUIRED(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700151
152 // Change required states after starting to receive the codec corresponding
153 // to |index|.
154 int UpdateUponReceivingCodec(int index);
155
156 rtc::CriticalSection acm_crit_sect_;
danilchap56359be2017-09-07 07:53:45 -0700157 rtc::Buffer encode_buffer_ RTC_GUARDED_BY(acm_crit_sect_);
danilchap56359be2017-09-07 07:53:45 -0700158 uint32_t expected_codec_ts_ RTC_GUARDED_BY(acm_crit_sect_);
159 uint32_t expected_in_ts_ RTC_GUARDED_BY(acm_crit_sect_);
160 acm2::ACMResampler resampler_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700161 acm2::AcmReceiver receiver_; // AcmReceiver has it's own internal lock.
danilchap56359be2017-09-07 07:53:45 -0700162 ChangeLogger bitrate_logger_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700163
Karl Wiberg49c33ce2018-11-12 14:21:58 +0100164 // Current encoder stack, provided by a call to RegisterEncoder.
danilchap56359be2017-09-07 07:53:45 -0700165 std::unique_ptr<AudioEncoder> encoder_stack_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700166
kwibergc13ded52016-06-17 06:00:45 -0700167 // This is to keep track of CN instances where we can send DTMFs.
danilchap56359be2017-09-07 07:53:45 -0700168 uint8_t previous_pltype_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700169
danilchap56359be2017-09-07 07:53:45 -0700170 bool receiver_initialized_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700171
danilchap56359be2017-09-07 07:53:45 -0700172 AudioFrame preprocess_frame_ RTC_GUARDED_BY(acm_crit_sect_);
173 bool first_10ms_data_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700174
danilchap56359be2017-09-07 07:53:45 -0700175 bool first_frame_ RTC_GUARDED_BY(acm_crit_sect_);
176 uint32_t last_timestamp_ RTC_GUARDED_BY(acm_crit_sect_);
177 uint32_t last_rtp_timestamp_ RTC_GUARDED_BY(acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700178
179 rtc::CriticalSection callback_crit_sect_;
180 AudioPacketizationCallback* packetization_callback_
danilchap56359be2017-09-07 07:53:45 -0700181 RTC_GUARDED_BY(callback_crit_sect_);
182 ACMVADCallback* vad_callback_ RTC_GUARDED_BY(callback_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700183
184 int codec_histogram_bins_log_[static_cast<size_t>(
185 AudioEncoder::CodecType::kMaxLoggedAudioCodecTypes)];
186 int number_of_consecutive_empty_packets_;
187};
188
189// Adds a codec usage sample to the histogram.
190void UpdateCodecTypeHistogram(size_t codec_type) {
191 RTC_HISTOGRAM_ENUMERATION(
192 "WebRTC.Audio.Encoder.CodecType", static_cast<int>(codec_type),
193 static_cast<int>(
194 webrtc::AudioEncoder::CodecType::kMaxLoggedAudioCodecTypes));
195}
196
kwibergc13ded52016-06-17 06:00:45 -0700197// Stereo-to-mono can be used as in-place.
198int DownMix(const AudioFrame& frame,
199 size_t length_out_buff,
200 int16_t* out_buff) {
yujo36b1a5f2017-06-12 12:45:32 -0700201 RTC_DCHECK_EQ(frame.num_channels_, 2);
202 RTC_DCHECK_GE(length_out_buff, frame.samples_per_channel_);
203
204 if (!frame.muted()) {
205 const int16_t* frame_data = frame.data();
206 for (size_t n = 0; n < frame.samples_per_channel_; ++n) {
Yves Gerey665174f2018-06-19 15:03:05 +0200207 out_buff[n] =
208 static_cast<int16_t>((static_cast<int32_t>(frame_data[2 * n]) +
209 static_cast<int32_t>(frame_data[2 * n + 1])) >>
210 1);
yujo36b1a5f2017-06-12 12:45:32 -0700211 }
212 } else {
Jonathan Yu36344a02017-07-30 01:55:34 -0700213 std::fill(out_buff, out_buff + frame.samples_per_channel_, 0);
kwibergc13ded52016-06-17 06:00:45 -0700214 }
kwibergc13ded52016-06-17 06:00:45 -0700215 return 0;
216}
217
218// Mono-to-stereo can be used as in-place.
219int UpMix(const AudioFrame& frame, size_t length_out_buff, int16_t* out_buff) {
yujo36b1a5f2017-06-12 12:45:32 -0700220 RTC_DCHECK_EQ(frame.num_channels_, 1);
221 RTC_DCHECK_GE(length_out_buff, 2 * frame.samples_per_channel_);
222
223 if (!frame.muted()) {
224 const int16_t* frame_data = frame.data();
225 for (size_t n = frame.samples_per_channel_; n != 0; --n) {
226 size_t i = n - 1;
227 int16_t sample = frame_data[i];
228 out_buff[2 * i + 1] = sample;
229 out_buff[2 * i] = sample;
230 }
231 } else {
Jonathan Yu36344a02017-07-30 01:55:34 -0700232 std::fill(out_buff, out_buff + frame.samples_per_channel_ * 2, 0);
kwibergc13ded52016-06-17 06:00:45 -0700233 }
234 return 0;
235}
236
kwibergc13ded52016-06-17 06:00:45 -0700237void AudioCodingModuleImpl::ChangeLogger::MaybeLog(int value) {
238 if (value != last_value_ || first_time_) {
239 first_time_ = false;
240 last_value_ = value;
241 RTC_HISTOGRAM_COUNTS_SPARSE_100(histogram_name_, value);
242 }
243}
244
245AudioCodingModuleImpl::AudioCodingModuleImpl(
246 const AudioCodingModule::Config& config)
solenbergc7b4a452017-09-28 07:37:11 -0700247 : expected_codec_ts_(0xD87F3F9F),
kwibergc13ded52016-06-17 06:00:45 -0700248 expected_in_ts_(0xD87F3F9F),
249 receiver_(config),
250 bitrate_logger_("WebRTC.Audio.TargetBitrateInKbps"),
kwibergc13ded52016-06-17 06:00:45 -0700251 encoder_stack_(nullptr),
252 previous_pltype_(255),
253 receiver_initialized_(false),
254 first_10ms_data_(false),
255 first_frame_(true),
256 packetization_callback_(NULL),
257 vad_callback_(NULL),
258 codec_histogram_bins_log_(),
259 number_of_consecutive_empty_packets_(0) {
260 if (InitializeReceiverSafe() < 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100261 RTC_LOG(LS_ERROR) << "Cannot initialize receiver";
kwibergc13ded52016-06-17 06:00:45 -0700262 }
Mirko Bonadei675513b2017-11-09 11:09:25 +0100263 RTC_LOG(LS_INFO) << "Created";
kwibergc13ded52016-06-17 06:00:45 -0700264}
265
266AudioCodingModuleImpl::~AudioCodingModuleImpl() = default;
267
268int32_t AudioCodingModuleImpl::Encode(const InputData& input_data) {
269 AudioEncoder::EncodedInfo encoded_info;
270 uint8_t previous_pltype;
271
272 // Check if there is an encoder before.
273 if (!HaveValidEncoder("Process"))
274 return -1;
275
Yves Gerey665174f2018-06-19 15:03:05 +0200276 if (!first_frame_) {
deadbeeffcada902016-08-24 12:45:13 -0700277 RTC_DCHECK(IsNewerTimestamp(input_data.input_timestamp, last_timestamp_))
ossu63fb95a2016-07-06 09:34:22 -0700278 << "Time should not move backwards";
279 }
280
kwibergc13ded52016-06-17 06:00:45 -0700281 // Scale the timestamp to the codec's RTP timestamp rate.
282 uint32_t rtp_timestamp =
Karl Wiberg053c3712019-05-16 15:24:17 +0200283 first_frame_
284 ? input_data.input_timestamp
285 : last_rtp_timestamp_ +
286 rtc::dchecked_cast<uint32_t>(rtc::CheckedDivExact(
287 int64_t{input_data.input_timestamp - last_timestamp_} *
288 encoder_stack_->RtpTimestampRateHz(),
289 int64_t{encoder_stack_->SampleRateHz()}));
kwibergc13ded52016-06-17 06:00:45 -0700290 last_timestamp_ = input_data.input_timestamp;
291 last_rtp_timestamp_ = rtp_timestamp;
292 first_frame_ = false;
293
294 // Clear the buffer before reuse - encoded data will get appended.
295 encode_buffer_.Clear();
296 encoded_info = encoder_stack_->Encode(
Yves Gerey665174f2018-06-19 15:03:05 +0200297 rtp_timestamp,
298 rtc::ArrayView<const int16_t>(
299 input_data.audio,
300 input_data.audio_channel * input_data.length_per_channel),
kwibergc13ded52016-06-17 06:00:45 -0700301 &encode_buffer_);
302
303 bitrate_logger_.MaybeLog(encoder_stack_->GetTargetBitrate() / 1000);
304 if (encode_buffer_.size() == 0 && !encoded_info.send_even_if_empty) {
305 // Not enough data.
306 return 0;
307 }
308 previous_pltype = previous_pltype_; // Read it while we have the critsect.
309
310 // Log codec type to histogram once every 500 packets.
311 if (encoded_info.encoded_bytes == 0) {
312 ++number_of_consecutive_empty_packets_;
313 } else {
314 size_t codec_type = static_cast<size_t>(encoded_info.encoder_type);
315 codec_histogram_bins_log_[codec_type] +=
316 number_of_consecutive_empty_packets_ + 1;
317 number_of_consecutive_empty_packets_ = 0;
318 if (codec_histogram_bins_log_[codec_type] >= 500) {
319 codec_histogram_bins_log_[codec_type] -= 500;
320 UpdateCodecTypeHistogram(codec_type);
321 }
322 }
323
Niels Möller87e2d782019-03-07 10:18:23 +0100324 AudioFrameType frame_type;
kwibergc13ded52016-06-17 06:00:45 -0700325 if (encode_buffer_.size() == 0 && encoded_info.send_even_if_empty) {
Niels Möllerc936cb62019-03-19 14:10:16 +0100326 frame_type = AudioFrameType::kEmptyFrame;
kwibergc13ded52016-06-17 06:00:45 -0700327 encoded_info.payload_type = previous_pltype;
328 } else {
kwibergaf476c72016-11-28 15:21:39 -0800329 RTC_DCHECK_GT(encode_buffer_.size(), 0);
Niels Möllerc936cb62019-03-19 14:10:16 +0100330 frame_type = encoded_info.speech ? AudioFrameType::kAudioFrameSpeech
331 : AudioFrameType::kAudioFrameCN;
kwibergc13ded52016-06-17 06:00:45 -0700332 }
333
334 {
335 rtc::CritScope lock(&callback_crit_sect_);
336 if (packetization_callback_) {
337 packetization_callback_->SendData(
338 frame_type, encoded_info.payload_type, encoded_info.encoded_timestamp,
Niels Möllerc35b6e62019-04-25 16:31:18 +0200339 encode_buffer_.data(), encode_buffer_.size());
kwibergc13ded52016-06-17 06:00:45 -0700340 }
341
342 if (vad_callback_) {
343 // Callback with VAD decision.
344 vad_callback_->InFrameType(frame_type);
345 }
346 }
347 previous_pltype_ = encoded_info.payload_type;
348 return static_cast<int32_t>(encode_buffer_.size());
349}
350
351/////////////////////////////////////////
352// Sender
353//
354
kwibergc13ded52016-06-17 06:00:45 -0700355void AudioCodingModuleImpl::ModifyEncoder(
kwiberg24c7c122016-09-28 11:57:10 -0700356 rtc::FunctionView<void(std::unique_ptr<AudioEncoder>*)> modifier) {
kwibergc13ded52016-06-17 06:00:45 -0700357 rtc::CritScope lock(&acm_crit_sect_);
kwibergc13ded52016-06-17 06:00:45 -0700358 modifier(&encoder_stack_);
359}
360
kwibergc13ded52016-06-17 06:00:45 -0700361// Register a transport callback which will be called to deliver
362// the encoded buffers.
363int AudioCodingModuleImpl::RegisterTransportCallback(
364 AudioPacketizationCallback* transport) {
365 rtc::CritScope lock(&callback_crit_sect_);
366 packetization_callback_ = transport;
367 return 0;
368}
369
370// Add 10MS of raw (PCM) audio data to the encoder.
371int AudioCodingModuleImpl::Add10MsData(const AudioFrame& audio_frame) {
372 InputData input_data;
373 rtc::CritScope lock(&acm_crit_sect_);
374 int r = Add10MsDataInternal(audio_frame, &input_data);
375 return r < 0 ? r : Encode(input_data);
376}
377
378int AudioCodingModuleImpl::Add10MsDataInternal(const AudioFrame& audio_frame,
379 InputData* input_data) {
380 if (audio_frame.samples_per_channel_ == 0) {
381 assert(false);
Mirko Bonadei675513b2017-11-09 11:09:25 +0100382 RTC_LOG(LS_ERROR) << "Cannot Add 10 ms audio, payload length is zero";
kwibergc13ded52016-06-17 06:00:45 -0700383 return -1;
384 }
385
386 if (audio_frame.sample_rate_hz_ > 48000) {
387 assert(false);
Mirko Bonadei675513b2017-11-09 11:09:25 +0100388 RTC_LOG(LS_ERROR) << "Cannot Add 10 ms audio, input frequency not valid";
kwibergc13ded52016-06-17 06:00:45 -0700389 return -1;
390 }
391
392 // If the length and frequency matches. We currently just support raw PCM.
393 if (static_cast<size_t>(audio_frame.sample_rate_hz_ / 100) !=
394 audio_frame.samples_per_channel_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100395 RTC_LOG(LS_ERROR)
Alex Loiko300ec8c2017-05-30 17:23:28 +0200396 << "Cannot Add 10 ms audio, input frequency and length doesn't match";
kwibergc13ded52016-06-17 06:00:45 -0700397 return -1;
398 }
399
Alex Loiko65438812019-02-22 10:13:44 +0100400 if (audio_frame.num_channels_ != 1 && audio_frame.num_channels_ != 2 &&
401 audio_frame.num_channels_ != 4 && audio_frame.num_channels_ != 6 &&
402 audio_frame.num_channels_ != 8) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100403 RTC_LOG(LS_ERROR) << "Cannot Add 10 ms audio, invalid number of channels.";
kwibergc13ded52016-06-17 06:00:45 -0700404 return -1;
405 }
406
407 // Do we have a codec registered?
408 if (!HaveValidEncoder("Add10MsData")) {
409 return -1;
410 }
411
412 const AudioFrame* ptr_frame;
413 // Perform a resampling, also down-mix if it is required and can be
414 // performed before resampling (a down mix prior to resampling will take
415 // place if both primary and secondary encoders are mono and input is in
416 // stereo).
417 if (PreprocessToAddData(audio_frame, &ptr_frame) < 0) {
418 return -1;
419 }
420
421 // Check whether we need an up-mix or down-mix?
422 const size_t current_num_channels = encoder_stack_->NumChannels();
423 const bool same_num_channels =
424 ptr_frame->num_channels_ == current_num_channels;
425
426 if (!same_num_channels) {
427 if (ptr_frame->num_channels_ == 1) {
428 if (UpMix(*ptr_frame, WEBRTC_10MS_PCM_AUDIO, input_data->buffer) < 0)
429 return -1;
430 } else {
431 if (DownMix(*ptr_frame, WEBRTC_10MS_PCM_AUDIO, input_data->buffer) < 0)
432 return -1;
433 }
434 }
435
436 // When adding data to encoders this pointer is pointing to an audio buffer
437 // with correct number of channels.
yujo36b1a5f2017-06-12 12:45:32 -0700438 const int16_t* ptr_audio = ptr_frame->data();
kwibergc13ded52016-06-17 06:00:45 -0700439
440 // For pushing data to primary, point the |ptr_audio| to correct buffer.
441 if (!same_num_channels)
442 ptr_audio = input_data->buffer;
443
yujo36b1a5f2017-06-12 12:45:32 -0700444 // TODO(yujo): Skip encode of muted frames.
kwibergc13ded52016-06-17 06:00:45 -0700445 input_data->input_timestamp = ptr_frame->timestamp_;
446 input_data->audio = ptr_audio;
447 input_data->length_per_channel = ptr_frame->samples_per_channel_;
448 input_data->audio_channel = current_num_channels;
449
450 return 0;
451}
452
453// Perform a resampling and down-mix if required. We down-mix only if
454// encoder is mono and input is stereo. In case of dual-streaming, both
455// encoders has to be mono for down-mix to take place.
456// |*ptr_out| will point to the pre-processed audio-frame. If no pre-processing
457// is required, |*ptr_out| points to |in_frame|.
yujo36b1a5f2017-06-12 12:45:32 -0700458// TODO(yujo): Make this more efficient for muted frames.
kwibergc13ded52016-06-17 06:00:45 -0700459int AudioCodingModuleImpl::PreprocessToAddData(const AudioFrame& in_frame,
460 const AudioFrame** ptr_out) {
461 const bool resample =
462 in_frame.sample_rate_hz_ != encoder_stack_->SampleRateHz();
463
464 // This variable is true if primary codec and secondary codec (if exists)
465 // are both mono and input is stereo.
466 // TODO(henrik.lundin): This condition should probably be
467 // in_frame.num_channels_ > encoder_stack_->NumChannels()
468 const bool down_mix =
469 in_frame.num_channels_ == 2 && encoder_stack_->NumChannels() == 1;
470
471 if (!first_10ms_data_) {
472 expected_in_ts_ = in_frame.timestamp_;
473 expected_codec_ts_ = in_frame.timestamp_;
474 first_10ms_data_ = true;
475 } else if (in_frame.timestamp_ != expected_in_ts_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100476 RTC_LOG(LS_WARNING) << "Unexpected input timestamp: " << in_frame.timestamp_
477 << ", expected: " << expected_in_ts_;
kwibergc13ded52016-06-17 06:00:45 -0700478 expected_codec_ts_ +=
479 (in_frame.timestamp_ - expected_in_ts_) *
480 static_cast<uint32_t>(
481 static_cast<double>(encoder_stack_->SampleRateHz()) /
482 static_cast<double>(in_frame.sample_rate_hz_));
483 expected_in_ts_ = in_frame.timestamp_;
484 }
485
kwibergc13ded52016-06-17 06:00:45 -0700486 if (!down_mix && !resample) {
487 // No pre-processing is required.
ossu63fb95a2016-07-06 09:34:22 -0700488 if (expected_in_ts_ == expected_codec_ts_) {
489 // If we've never resampled, we can use the input frame as-is
490 *ptr_out = &in_frame;
491 } else {
492 // Otherwise we'll need to alter the timestamp. Since in_frame is const,
493 // we'll have to make a copy of it.
494 preprocess_frame_.CopyFrom(in_frame);
495 preprocess_frame_.timestamp_ = expected_codec_ts_;
496 *ptr_out = &preprocess_frame_;
497 }
498
kwibergc13ded52016-06-17 06:00:45 -0700499 expected_in_ts_ += static_cast<uint32_t>(in_frame.samples_per_channel_);
500 expected_codec_ts_ += static_cast<uint32_t>(in_frame.samples_per_channel_);
kwibergc13ded52016-06-17 06:00:45 -0700501 return 0;
502 }
503
504 *ptr_out = &preprocess_frame_;
505 preprocess_frame_.num_channels_ = in_frame.num_channels_;
506 int16_t audio[WEBRTC_10MS_PCM_AUDIO];
yujo36b1a5f2017-06-12 12:45:32 -0700507 const int16_t* src_ptr_audio = in_frame.data();
kwibergc13ded52016-06-17 06:00:45 -0700508 if (down_mix) {
509 // If a resampling is required the output of a down-mix is written into a
510 // local buffer, otherwise, it will be written to the output frame.
Yves Gerey665174f2018-06-19 15:03:05 +0200511 int16_t* dest_ptr_audio =
512 resample ? audio : preprocess_frame_.mutable_data();
kwibergc13ded52016-06-17 06:00:45 -0700513 if (DownMix(in_frame, WEBRTC_10MS_PCM_AUDIO, dest_ptr_audio) < 0)
514 return -1;
515 preprocess_frame_.num_channels_ = 1;
516 // Set the input of the resampler is the down-mixed signal.
517 src_ptr_audio = audio;
518 }
519
520 preprocess_frame_.timestamp_ = expected_codec_ts_;
521 preprocess_frame_.samples_per_channel_ = in_frame.samples_per_channel_;
522 preprocess_frame_.sample_rate_hz_ = in_frame.sample_rate_hz_;
523 // If it is required, we have to do a resampling.
524 if (resample) {
525 // The result of the resampler is written to output frame.
yujo36b1a5f2017-06-12 12:45:32 -0700526 int16_t* dest_ptr_audio = preprocess_frame_.mutable_data();
kwibergc13ded52016-06-17 06:00:45 -0700527
528 int samples_per_channel = resampler_.Resample10Msec(
529 src_ptr_audio, in_frame.sample_rate_hz_, encoder_stack_->SampleRateHz(),
530 preprocess_frame_.num_channels_, AudioFrame::kMaxDataSizeSamples,
531 dest_ptr_audio);
532
533 if (samples_per_channel < 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100534 RTC_LOG(LS_ERROR) << "Cannot add 10 ms audio, resampling failed";
kwibergc13ded52016-06-17 06:00:45 -0700535 return -1;
536 }
537 preprocess_frame_.samples_per_channel_ =
538 static_cast<size_t>(samples_per_channel);
539 preprocess_frame_.sample_rate_hz_ = encoder_stack_->SampleRateHz();
540 }
541
542 expected_codec_ts_ +=
543 static_cast<uint32_t>(preprocess_frame_.samples_per_channel_);
544 expected_in_ts_ += static_cast<uint32_t>(in_frame.samples_per_channel_);
545
546 return 0;
547}
548
549/////////////////////////////////////////
kwibergc13ded52016-06-17 06:00:45 -0700550// (FEC) Forward Error Correction (codec internal)
551//
552
kwibergc13ded52016-06-17 06:00:45 -0700553int AudioCodingModuleImpl::SetPacketLossRate(int loss_rate) {
554 rtc::CritScope lock(&acm_crit_sect_);
555 if (HaveValidEncoder("SetPacketLossRate")) {
minyue4b9a2cb2016-11-30 06:49:59 -0800556 encoder_stack_->OnReceivedUplinkPacketLossFraction(loss_rate / 100.0);
kwibergc13ded52016-06-17 06:00:45 -0700557 }
558 return 0;
559}
560
561/////////////////////////////////////////
kwibergc13ded52016-06-17 06:00:45 -0700562// Receiver
563//
564
565int AudioCodingModuleImpl::InitializeReceiver() {
566 rtc::CritScope lock(&acm_crit_sect_);
567 return InitializeReceiverSafe();
568}
569
570// Initialize receiver, resets codec database etc.
571int AudioCodingModuleImpl::InitializeReceiverSafe() {
572 // If the receiver is already initialized then we want to destroy any
573 // existing decoders. After a call to this function, we should have a clean
574 // start-up.
kwiberg6b19b562016-09-20 04:02:25 -0700575 if (receiver_initialized_)
576 receiver_.RemoveAllCodecs();
kwibergc13ded52016-06-17 06:00:45 -0700577 receiver_.FlushBuffers();
578
kwibergc13ded52016-06-17 06:00:45 -0700579 receiver_initialized_ = true;
580 return 0;
581}
582
kwiberg1c07c702017-03-27 07:15:49 -0700583void AudioCodingModuleImpl::SetReceiveCodecs(
584 const std::map<int, SdpAudioFormat>& codecs) {
585 rtc::CritScope lock(&acm_crit_sect_);
586 receiver_.SetCodecs(codecs);
587}
588
kwibergc13ded52016-06-17 06:00:45 -0700589// Incoming packet from network parsed and ready for decode.
590int AudioCodingModuleImpl::IncomingPacket(const uint8_t* incoming_payload,
591 const size_t payload_length,
Niels Möllerafb5dbb2019-02-15 15:21:47 +0100592 const RTPHeader& rtp_header) {
henrik.lundinb8c55b12017-05-10 07:38:01 -0700593 RTC_DCHECK_EQ(payload_length == 0, incoming_payload == nullptr);
kwibergc13ded52016-06-17 06:00:45 -0700594 return receiver_.InsertPacket(
595 rtp_header,
596 rtc::ArrayView<const uint8_t>(incoming_payload, payload_length));
597}
598
kwibergc13ded52016-06-17 06:00:45 -0700599// Get 10 milliseconds of raw audio data to play out.
600// Automatic resample to the requested frequency.
601int AudioCodingModuleImpl::PlayoutData10Ms(int desired_freq_hz,
602 AudioFrame* audio_frame,
603 bool* muted) {
604 // GetAudio always returns 10 ms, at the requested sample rate.
605 if (receiver_.GetAudio(desired_freq_hz, audio_frame, muted) != 0) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100606 RTC_LOG(LS_ERROR) << "PlayoutData failed, RecOut Failed";
kwibergc13ded52016-06-17 06:00:45 -0700607 return -1;
608 }
kwibergc13ded52016-06-17 06:00:45 -0700609 return 0;
610}
611
kwibergc13ded52016-06-17 06:00:45 -0700612/////////////////////////////////////////
613// Statistics
614//
615
616// TODO(turajs) change the return value to void. Also change the corresponding
617// NetEq function.
618int AudioCodingModuleImpl::GetNetworkStatistics(NetworkStatistics* statistics) {
619 receiver_.GetNetworkStatistics(statistics);
620 return 0;
621}
622
623int AudioCodingModuleImpl::RegisterVADCallback(ACMVADCallback* vad_callback) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100624 RTC_LOG(LS_VERBOSE) << "RegisterVADCallback()";
kwibergc13ded52016-06-17 06:00:45 -0700625 rtc::CritScope lock(&callback_crit_sect_);
626 vad_callback_ = vad_callback;
627 return 0;
628}
629
kwibergc13ded52016-06-17 06:00:45 -0700630bool AudioCodingModuleImpl::HaveValidEncoder(const char* caller_name) const {
631 if (!encoder_stack_) {
Mirko Bonadei675513b2017-11-09 11:09:25 +0100632 RTC_LOG(LS_ERROR) << caller_name << " failed: No send codec is registered.";
kwibergc13ded52016-06-17 06:00:45 -0700633 return false;
634 }
635 return true;
636}
637
kwibergc13ded52016-06-17 06:00:45 -0700638void AudioCodingModuleImpl::GetDecodingCallStatistics(
Yves Gerey665174f2018-06-19 15:03:05 +0200639 AudioDecodingCallStats* call_stats) const {
kwibergc13ded52016-06-17 06:00:45 -0700640 receiver_.GetDecodingCallStatistics(call_stats);
641}
642
ivoce1198e02017-09-08 08:13:19 -0700643ANAStats AudioCodingModuleImpl::GetANAStats() const {
644 rtc::CritScope lock(&acm_crit_sect_);
645 if (encoder_stack_)
646 return encoder_stack_->GetANAStats();
647 // If no encoder is set, return default stats.
648 return ANAStats();
649}
650
kwibergc13ded52016-06-17 06:00:45 -0700651} // namespace
652
Karl Wiberg5817d3d2018-04-06 10:06:42 +0200653AudioCodingModule::Config::Config(
654 rtc::scoped_refptr<AudioDecoderFactory> decoder_factory)
655 : neteq_config(),
656 clock(Clock::GetRealTimeClock()),
657 decoder_factory(decoder_factory) {
kwiberg36a43882016-08-29 05:33:32 -0700658 // Post-decode VAD is disabled by default in NetEq, however, Audio
659 // Conference Mixer relies on VAD decisions and fails without them.
660 neteq_config.enable_post_decode_vad = true;
661}
662
663AudioCodingModule::Config::Config(const Config&) = default;
664AudioCodingModule::Config::~Config() = default;
665
Henrik Lundin64dad832015-05-11 12:44:23 +0200666AudioCodingModule* AudioCodingModule::Create(const Config& config) {
kwibergc13ded52016-06-17 06:00:45 -0700667 return new AudioCodingModuleImpl(config);
turaj@webrtc.org7959e162013-09-12 18:30:26 +0000668}
669
turaj@webrtc.org7959e162013-09-12 18:30:26 +0000670} // namespace webrtc