| /* |
| * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. |
| * |
| * Use of this source code is governed by a BSD-style license |
| * that can be found in the LICENSE file in the root of the source |
| * tree. An additional intellectual property rights grant can be found |
| * in the file PATENTS. All contributing project authors may |
| * be found in the AUTHORS file in the root of the source tree. |
| */ |
| |
| |
| /* |
| * This header file includes the VAD API calls. Specific function calls are given below. |
| */ |
| |
| #ifndef WEBRTC_COMMON_AUDIO_VAD_INCLUDE_WEBRTC_VAD_H_ |
| #define WEBRTC_COMMON_AUDIO_VAD_INCLUDE_WEBRTC_VAD_H_ |
| |
| #include "typedefs.h" |
| |
| typedef struct WebRtcVadInst VadInst; |
| |
| #ifdef __cplusplus |
| extern "C" |
| { |
| #endif |
| |
| /**************************************************************************** |
| * WebRtcVad_AssignSize(...) |
| * |
| * This functions get the size needed for storing the instance for encoder |
| * and decoder, respectively |
| * |
| * Input/Output: |
| * - size_in_bytes : Pointer to integer where the size is returned |
| * |
| * Return value : 0 |
| */ |
| WebRtc_Word16 WebRtcVad_AssignSize(int *size_in_bytes); |
| |
| /**************************************************************************** |
| * WebRtcVad_Assign(...) |
| * |
| * This functions Assigns memory for the instances. |
| * |
| * Input: |
| * - vad_inst_addr : Address to where to assign memory |
| * Output: |
| * - vad_inst : Pointer to the instance that should be created |
| * |
| * Return value : 0 - Ok |
| * -1 - Error |
| */ |
| WebRtc_Word16 WebRtcVad_Assign(VadInst **vad_inst, void *vad_inst_addr); |
| |
| // Creates an instance to the VAD structure. |
| // |
| // - handle [o] : Pointer to the VAD instance that should be created. |
| // |
| // returns : 0 - (OK), -1 - (Error) |
| int WebRtcVad_Create(VadInst** handle); |
| |
| // Frees the dynamic memory of a specified VAD instance. |
| // |
| // - handle [i] : Pointer to VAD instance that should be freed. |
| // |
| // returns : 0 - (OK), -1 - (NULL pointer in) |
| int WebRtcVad_Free(VadInst* handle); |
| |
| /**************************************************************************** |
| * WebRtcVad_Init(...) |
| * |
| * This function initializes a VAD instance |
| * |
| * Input: |
| * - vad_inst : Instance that should be initialized |
| * |
| * Output: |
| * - vad_inst : Initialized instance |
| * |
| * Return value : 0 - Ok |
| * -1 - Error |
| */ |
| int WebRtcVad_Init(VadInst *vad_inst); |
| |
| /**************************************************************************** |
| * WebRtcVad_set_mode(...) |
| * |
| * This function initializes a VAD instance |
| * |
| * Input: |
| * - vad_inst : VAD instance |
| * - mode : Aggressiveness setting (0, 1, 2, or 3) |
| * |
| * Output: |
| * - vad_inst : Initialized instance |
| * |
| * Return value : 0 - Ok |
| * -1 - Error |
| */ |
| int WebRtcVad_set_mode(VadInst *vad_inst, int mode); |
| |
| /**************************************************************************** |
| * WebRtcVad_Process(...) |
| * |
| * This functions does a VAD for the inserted speech frame |
| * |
| * Input |
| * - vad_inst : VAD Instance. Needs to be initiated before call. |
| * - fs : sampling frequency (Hz): 8000, 16000, or 32000 |
| * - speech_frame : Pointer to speech frame buffer |
| * - frame_length : Length of speech frame buffer in number of samples |
| * |
| * Output: |
| * - vad_inst : Updated VAD instance |
| * |
| * Return value : 1 - Active Voice |
| * 0 - Non-active Voice |
| * -1 - Error |
| */ |
| WebRtc_Word16 WebRtcVad_Process(VadInst *vad_inst, |
| WebRtc_Word16 fs, |
| WebRtc_Word16 *speech_frame, |
| WebRtc_Word16 frame_length); |
| |
| #ifdef __cplusplus |
| } |
| #endif |
| |
| #endif // WEBRTC_COMMON_AUDIO_VAD_INCLUDE_WEBRTC_VAD_H_ |