1/* 2 * Copyright (c) 2013 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 11#ifndef WEBRTC_MODULES_AUDIO_CODING_MAIN_ACM2_CALL_STATISTICS_H_ 12#define WEBRTC_MODULES_AUDIO_CODING_MAIN_ACM2_CALL_STATISTICS_H_ 13 14#include "webrtc/common_types.h" 15#include "webrtc/modules/interface/module_common_types.h" 16 17// 18// This class is for book keeping of calls to ACM. It is not useful to log API 19// calls which are supposed to be called every 10ms, e.g. PlayoutData10Ms(), 20// however, it is useful to know the number of such calls in a given time 21// interval. The current implementation covers calls to PlayoutData10Ms() with 22// detailed accounting of the decoded speech type. 23// 24// Thread Safety 25// ============= 26// Please note that this class in not thread safe. The class must be protected 27// if different APIs are called from different threads. 28// 29 30namespace webrtc { 31 32namespace acm2 { 33 34class CallStatistics { 35 public: 36 CallStatistics() {} 37 ~CallStatistics() {} 38 39 // Call this method to indicate that NetEq engaged in decoding. |speech_type| 40 // is the audio-type according to NetEq. 41 void DecodedByNetEq(AudioFrame::SpeechType speech_type); 42 43 // Call this method to indicate that a decoding call resulted in generating 44 // silence, i.e. call to NetEq is bypassed and the output audio is zero. 45 void DecodedBySilenceGenerator(); 46 47 // Get statistics for decoding. The statistics include the number of calls to 48 // NetEq and silence generator, as well as the type of speech pulled of off 49 // NetEq, c.f. declaration of AudioDecodingCallStats for detailed description. 50 const AudioDecodingCallStats& GetDecodingStatistics() const; 51 52 private: 53 // Reset the decoding statistics. 54 void ResetDecodingStatistics(); 55 56 AudioDecodingCallStats decoding_stat_; 57}; 58 59} // namespace acm2 60 61} // namespace webrtc 62 63#endif // WEBRTC_MODULES_AUDIO_CODING_MAIN_ACM2_CALL_STATISTICS_H_ 64