hci_asr_recorder.h

#ifndef __HCI_ASR_RECORDER_HEADER__
#define __HCI_ASR_RECORDER_HEADER__

#include "hci_sys.h"
#include "hci_asr.h"

#ifdef __cplusplus
extern "C"
{
#endif
    
    /* @{ */
    
    /* @{ */
    
    #define MODULE_NAME    "HCI_ASR_RECORDER"
    
    typedef enum
    {
        RECORDER_EVENT_BEGIN_RECORD,            
        RECORDER_EVENT_HAVING_VOICE,            
        RECORDER_EVENT_NO_VOICE_INPUT,          
        RECORDER_EVENT_BUFF_FULL,                       
        RECORDER_EVENT_END_RECORD,                      
        RECORDER_EVENT_BEGIN_RECOGNIZE,         
        RECORDER_EVENT_RECOGNIZE_COMPLETE,      
        RECORDER_EVENT_ENGINE_ERROR,            
        RECORDER_EVENT_DEVICE_ERROR,            
        RECORDER_EVENT_MALLOC_ERROR,            
        RECORDER_EVENT_INTERRUPTED,         
        RECORDER_EVENT_PERMISSION_DENIED,   
        RECORDER_EVENT_TASK_FINISH,                     
        RECORDER_EVENT_RECOGNIZE_PROCESS,       
    }
    RECORDER_EVENT;
    
    typedef enum
    {
        RECORDER_ERR_UNKNOWN = -1,                                      
        
        RECORDER_ERR_NONE = 0,                                          
        
        RECORDER_ERR_NOT_INIT,                                          
        RECORDER_ERR_ALREADY_INIT,                                      
        RECORDER_ERR_ALREADY_BEGIN,                                     
        RECORDER_ERR_NOT_BEGIN,                                         
        RECORDER_ERR_OUT_OF_MEMORY,                                     
        RECORDER_ERR_ENGINE_ERROR,                                      
                RECORDER_ERR_CONFIG_ITEM,                                       
    }
    RECORDER_ERR_CODE;
    
    typedef void (HCIAPI * Callback_RecorderEventStateChange)(
                                                              _MUST_ _IN_ RECORDER_EVENT eRecorderEvent,
                                                              _OPT_ _IN_ void * pUsrParam );
    
    typedef void (HCIAPI * Callback_RecorderRecording)(
                                                       _MUST_ _IN_ unsigned char * pVoiceData,
                                                       _MUST_ _IN_ unsigned int uiVoiceLen,
                                                       _OPT_ _IN_ void * pUsrParam
                                                       );
    
    typedef void (HCIAPI * Callback_RecorderEventRecogFinish)(
                                                              _MUST_ _IN_ RECORDER_EVENT eRecorderEvent,
                                                              _MUST_ _IN_ ASR_RECOG_RESULT *pRecogResult,
                                                              _OPT_ _IN_ void * pUsrParam );
    
    
    typedef void (HCIAPI * Callback_RecorderEventRecogProcess)(
                                                               _MUST_ _IN_ RECORDER_EVENT eRecorderEvent,
                                                               _MUST_ _IN_ ASR_RECOG_RESULT *pRecogResult,
                                                               _OPT_ _IN_ void * pUsrParam );
    
    
    typedef void (HCIAPI * Callback_RecorderEventError)(
                                                        _MUST_ _IN_ RECORDER_EVENT eRecorderEvent,
                                                        _MUST_ _IN_ HCI_ERR_CODE eErrorCode,
                                                        _OPT_ _IN_ void * pUsrParam );
    
    typedef bool (HCIAPI * Callback_RecorderSetAudioSession)(
                                                            _MUST_ _IN_ void * pExtendParam,
                                                            _OPT_ _IN_ void * pUsrParam);

    typedef struct _RECORDER_CALLBACK_PARAM {
        Callback_RecorderEventStateChange pfnStateChange;       
        void * pvStateChangeUsrParam;                           
        Callback_RecorderRecording pfnRecording;                
        void * pvRecordingUsrParam;                             
        Callback_RecorderEventRecogFinish pfnRecogFinish;       
        void * pvRecogFinishUsrParam;                           
        Callback_RecorderEventError pfnError;                   
        void *pvErrorUsrParam;                                  
        Callback_RecorderEventRecogProcess pfnRecogProcess;     
        void *pvRecogProcessParam;                              
    } RECORDER_CALLBACK_PARAM;

    /* @} */

    /* @{ */
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_init(
                                                   _MUST_ _IN_ const char * pszAsrSdkConfig,
                                                   _MUST_ _IN_ RECORDER_CALLBACK_PARAM *psCallbackParam);
    
    RECORDER_ERR_CODE hci_asr_recorder_set_audio_session_callback(
                                                                  _MUST_ _IN_ Callback_RecorderSetAudioSession pfnCallBack ,
                                                                  _OPT_ _IN_ void * pUsrParam);
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_load_grammar(
                                                           _OPT_ _IN_ const char * pszAsrSdkConfig,
                                                           _MUST_ _IN_ const char * pszGrammarData,
                                                           _MUST_ _OUT_ unsigned int * pnGrammarId
                                                           );
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_unload_grammar(
                                                             _MUST_ _IN_ unsigned int nGrammarId
                                                             );
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_start(
                                                    _MUST_ _IN_ const char * pszConfig,
                                                    _OPT_ _IN_ const char * pszGrammarData);
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_cancel();
    
    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_stop_and_recog();

    RECORDER_ERR_CODE HCIAPI hci_asr_recorder_release();
    
     /* @} */
    /* @} */
    
#ifdef __cplusplus
}
#endif

#endif // _hci_cloud_asr_recorder_api_header_