205 lines
6.4 KiB
C
205 lines
6.4 KiB
C
#ifndef _ALIGENIE_PORTING_PLAYER_HEADER_
|
||
#define _ALIGENIE_PORTING_PLAYER_HEADER_
|
||
|
||
#ifdef __cplusplus
|
||
extern "C"
|
||
{
|
||
#endif
|
||
|
||
|
||
#include "aligenie_sdk.h"
|
||
|
||
/**
|
||
* Maybe different EQ or gain could be used
|
||
*/
|
||
typedef enum {
|
||
AG_AUDIO_RECORD_TYPE_RECOGNIZE, /* for asr */
|
||
AG_AUDIO_RECORD_TYPE_MESSAGE, /* for human-hear */
|
||
} AG_AUDIO_RECORD_TYPE_E;
|
||
|
||
/**
|
||
* Local prompt res type
|
||
*/
|
||
typedef enum {
|
||
/*01*/ AG_LOCAL_PROMPT_ASR_EMPTY = 1, //ASR识别结果为空，提示再说一遍
|
||
/*02*/ AG_LOCAL_PROMPT_FORMAT_NOT_SUPPORT, //播放器不支持的媒体格式
|
||
/*03*/ AG_LOCAL_PROMPT_PLAYER_ERROR, //播放器出错
|
||
/*04*/ AG_LOCAL_PROMPT_NETWORK_DISCONNECTED, //没有连接网络
|
||
/*05*/ AG_LOCAL_PROMPT_PLAY_DOMAIN_MUSIC, //领域播放：儿歌
|
||
/*06*/ AG_LOCAL_PROMPT_PLAY_DOMAIN_STORY, //领域播放：故事
|
||
/*07*/ AG_LOCAL_PROMPT_PLAY_DOMAIN_SINOLOGY, //领域播放：国学
|
||
/*08*/ AG_LOCAL_PROMPT_PLAY_DOMAIN_ENGLISH, //领域播放：英语
|
||
/*09*/ AG_LOCAL_PROMPT_PLAY, //播放按键提示音
|
||
/*10*/ AG_LOCAL_PROMPT_PAUSE, //播放按键提示音
|
||
/*11*/ AG_LOCAL_PROMPT_PREVIOUS, //上一曲提示音
|
||
/*12*/ AG_LOCAL_PROMPT_NEXT, //下一曲提示音
|
||
/*13*/ AG_LOCAL_PROMPT_RECORD_START, //录音开始提示音
|
||
/*14*/ AG_LOCAL_PROMPT_RECORD_STOP, //录音结束提示音
|
||
/*15*/ AG_LOCAL_PROMPT_AI_KEY_TOO_SHORT, //AI按键事件太短提示
|
||
/*16*/ AG_LOCAL_PROMPT_PLAY_FAVORITE, //play favorite list
|
||
/*17*/ AG_LOCAL_PROMPT_NOTHING_PLAYING, //按下暂停继续键时没有正在播放或已被暂停的内容
|
||
/*18*/ AG_LOCAL_PROMPT_SEEK_UNSUPPORTED, //不支持快进快退的本地提示音
|
||
} AG_LOCAL_PROMPT_TYPE_E;
|
||
|
||
/**
|
||
* Aligenie tts format.
|
||
* Currently, mp3 format only.
|
||
*/
|
||
typedef enum {
|
||
AG_AUDIO_TTS_FORMAT_MP3,
|
||
} AG_TTS_FORMAT_E;
|
||
|
||
/**
|
||
* This function will be called while Aligenie has nothing to do.
|
||
* Maybe play some local music, or just do nothing.
|
||
*/
|
||
extern void ag_audio_idle();
|
||
|
||
/**
|
||
* play an url or a filepath.
|
||
* Get info->url, and play it.
|
||
* return:
|
||
* 0: player init and/or playlist add success
|
||
* other: error.
|
||
*/
|
||
extern int ag_audio_url_play(const AG_AUDIO_INFO_T *const info);
|
||
|
||
/* return: 0 for player-control send success, other for error. */
|
||
extern int ag_audio_url_pause();
|
||
|
||
/* return: 0 for player-control send success, other for error. */
|
||
extern int ag_audio_url_resume();
|
||
|
||
/* return: 0 for player-control send success, other for error. */
|
||
extern int ag_audio_url_stop();
|
||
|
||
/**
|
||
* This function would be called only when url (or filepath) media is playing.
|
||
* if it is called when playing prompt or url, just return an error.
|
||
*
|
||
* params
|
||
* outval: current progress of currently playing media, in seconds.
|
||
*
|
||
* return:
|
||
* 0: success,
|
||
* other: error.
|
||
*/
|
||
extern int ag_audio_get_url_play_progress(int *outval);
|
||
|
||
/**
|
||
* get total length of current playing media, in seconds.
|
||
*/
|
||
extern int ag_audio_get_url_play_duration(int *outval);
|
||
|
||
/* params seconds: target progress in seconds.*/
|
||
/* return: 0 for player-control send success, other for error. */
|
||
extern int ag_audio_url_seek_progress(int seconds);
|
||
|
||
extern AG_PLAYER_STATUS_E ag_audio_get_player_status();
|
||
|
||
/**
|
||
* This call should BLOCK the caller if playing is started successfully.
|
||
* Unblock caller when this prompt playing is finished or interrupted.
|
||
*
|
||
* IMPORTANT NOTES:
|
||
* Calling this function should not clean up the resource of currently playing URL media.
|
||
* In other words, url media play is just paused when playing prompt,
|
||
* when prompt playing is finished or interrupted, Aligenie can still resume last url play.
|
||
*
|
||
* return:
|
||
* 0 : finished(for block call)
|
||
* -1: interrupted (for block call)
|
||
* other: error.
|
||
*/
|
||
extern int ag_audio_play_prompt(char *url);
|
||
|
||
/**
|
||
* play a local prompt indicated by type.
|
||
* !!!BLOCK CALLER!!
|
||
*/
|
||
extern int ag_audio_play_local_prompt(AG_LOCAL_PROMPT_TYPE_E type);
|
||
|
||
/*
|
||
* This func will only be called from ANOTHER TASK, different from the one
|
||
* who is calling ag_audio_play_prompt.
|
||
* Interrupt blocked call of ag_audio_play_prompt
|
||
* If ag_audio_play_prompt is not a block call, this function should
|
||
* return: 0 for success, other for error.
|
||
*/
|
||
extern int ag_audio_stop_prompt();
|
||
/*
|
||
* params format will always be AG_AUDIO_TTS_FORMAT_MP3 for now.
|
||
* return: 0 for success, other for error.
|
||
*/
|
||
extern int ag_audio_tts_play_start(AG_TTS_FORMAT_E format);
|
||
/*
|
||
* params
|
||
* inData: A segment of mp3 data.
|
||
* dataLen: length of this segment.
|
||
* return: 0 for success, other for error.
|
||
*/
|
||
extern int ag_audio_tts_play_put_data(const void *const inData, int dataLen);
|
||
|
||
/**
|
||
* block caller and wait for tts play done
|
||
* return 0 for play finished, return -1 for aborted.
|
||
*/
|
||
extern int ag_audio_tts_play_wait_finish();
|
||
|
||
/**
|
||
* abort tts playing immediately and de-block caller of ag_audio_tts_play_wait_finish immediately.
|
||
* return: 0 for successfully aborted. other for failed.
|
||
*/
|
||
extern int ag_audio_tts_play_abort();
|
||
|
||
/****************************RECORDER****************************/
|
||
|
||
typedef enum {
|
||
AG_RECORDER_DATA_TYPE_PCM,
|
||
AG_RECORDER_DATA_TYPE_SPEEX,
|
||
AG_RECORDER_DATA_TYPE_OGG,
|
||
} AG_RECORDER_DATA_TYPE_E;
|
||
|
||
extern AG_RECORDER_DATA_TYPE_E ag_audio_get_record_data_type();
|
||
|
||
/* return: 0 for recorder-control send success, other for error. */
|
||
extern int ag_audio_record_start(AG_AUDIO_RECORD_TYPE_E type);
|
||
|
||
/* return: length of data read for success, zero or negative value for error.*/
|
||
extern int ag_audio_record_get_data(const void *outData, int maxLen);
|
||
|
||
/* return: 0 for recorder-control send success, other for error. */
|
||
extern int ag_audio_record_stop();
|
||
/****************************************************************/
|
||
|
||
/*****************************VOLUME*****************************/
|
||
|
||
/*
|
||
* params:
|
||
* volume: integer value with range [0, 100]
|
||
* return:
|
||
* 0 for success, other for error.
|
||
*/
|
||
extern int ag_audio_set_volume(int volume);
|
||
|
||
/*
|
||
* return:
|
||
* [0, 100] for current volume
|
||
* negative value for error
|
||
*/
|
||
extern int ag_audio_get_volume();
|
||
/****************************************************************/
|
||
|
||
/*
|
||
* return:
|
||
* 0 for success, other for error.
|
||
*/
|
||
extern int ag_audio_vad_start();
|
||
|
||
#ifdef __cplusplus
|
||
}
|
||
#endif
|
||
|
||
#endif /*_ALIGENIE_PORTING_PLAYER_HEADER_*/
|
||
|