展讯音频接口简介

TITLEMocorMMIAudioInterfaceUserGuideVersion:1.0.DocCode:SW-MOCOR-UG-0003Date:200重要声明版权声明本文档中的任何内容受《中华人民共和国著作权法》的保护，版权所有©2023，展讯通信，保存所有权利，但注明引用其他方的内容除外。商标声明展讯通信和展讯通信的产品是展讯通信专有。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。不作保证声明展讯通信不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承当任何责任。保密声明本文档〔包括任何附件〕包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。前言文档说明本文档为MMIAudio模块的接口文档，详细描述了本模块提供应其他MMI模块的API接口。阅读对象本文档适合MMI软件开发人员和相关客户开发人员使用。内容介绍本文档包括三个章节，分别为：第一章：模块的总体结构。简单介绍了MMIAUDIO模块的功能结构；第二章：数据类型。介绍了涉及的数据结构。第三章：提供应其他模块的接口。介绍了MMIAUDIO模块提供应外部模块的接口函数。文档约定本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意：提醒操作中应注意的事项。说明：说明比拟重要的事项。相关文档《软件设计说明书_Audio局部》《AudioService软件设计说明书》。目录TOC\o"1-3"\h\z\t"标题6,1,标题7,2,标题8,3"第1章概述1-11.1模块总体框架及概述1-11.2支持的Audio类型1-2第2章数据类型2-12.1枚举2-12.1.1MMIAUDIO_HTYPE2-12.1.2MMIAUDIO_TYPE_E2-12.1.3MMIAUDIO_RESULT2-32.1.4MMIBGPLAY_MODULE_E2-4MMIBGPLAY_TYPE_E2-72.2回调函数2-72.2.1MMIAUDIO_END_CALLBACK_PFUNC2-7第3章提供应其他模块的接口3-13.1播放相关接口3-13.1.1MMIAUDIO_Init3-13.1.2MMIAUDIO_CreateAudioBufHandle3-13.1.3MMIAUDIO_CreateA2dpAudioBufHandle3-23.1.4MMIAUDIO_CreateAudioFileHandle3-33.1.5MMIAUDIO_CreateA2dpAudioFileHandle3-43.1.6MMIAUDIO_CloseAudioHandle3-53.1.7MMIAUDIO_AudioPlay3-53.1.8MMIAUDIO_AudioStop3-63.1.9MMIAUDIO_AudioPause3-63.1.10MMIAUDIO_AudioResume3-73.1.11MMIAUDIO_AudioSeek3-73.1.12MMIAUDIO_PlayTone3-83.1.13MMIAUDIO_StopTone3-93.1.14MMIAUDIO_AudioGetFileInfo3-93.1.15MMIAUDIO_AudioGetPlayingFileInfo3-103.1.16MMIAUDIO_AudioSetSpeed3-113.1.17MMIAUDIO_SetEQMode3-113.1.18MMIAUDIO_GetCurVolume3-123.1.19MMIAUDIO_SetVolume3-123.1.20MMIAUDIO_SetMute3-133.1.21MMIAUDIO_GetCurDevMode3-133.1.22MMIAUDIO_SetCurDevMode3-143.1.23MMIAUDIO_GetIsPlaying3-143.1.24MMIAUDIO_GetIsPermitPlay3-153.1.25MMIAUDIO_GetAudioHtype3-153.1.26MMIAUDIO_GetAudioHandle3-163.2录音相关接口3-173.2.1MMIAUDIO_StartRecord3-173.2.2MMIAUDIO_StopRecord3-173.2.3MMIAUDIO_EndRecord3-183.2.4MMIAUDIO_PauseRecord3-183.2.5MMIAUDIO_ResumeRecord3-193.3背景播放控制接口3-193.3.1MMIAUDIO_PauseBgPlay3-193.3.2MMIAUDIO_PauseBgPlayAndA2dp3-203.3.3MMIAUDIO_PauseBgPlayII3-203.3.4MMIAUDIO_ResumeBgPlay3-213.3.5MMIAUDIO_StopBgPlay3-223.3.6MMIAUDIO_InitBgPlay3-223.3.7MMIAUDIO_Vibrate3-233.3.8MMIAUDIO_HandleVibratorTimer3-233.3.9MMIAUDIO_IsBgPlayPaused3-243.3.10MMIAUDIO_IsPermitPlayNewMsgRing3-243.3.11MMIAUDIO_HandleNewMsgRing3-253.3.12MMIAUDIO_HandleNewMsgKey3-25附录ARevisionHistoryA-1概述模块总体框架及概述REF_Ref195691705\h图11为AudioService模块的系统结构框图，图中虚线框内的模块为AudioServiceMMI的范畴。其中AudioMMI通过调用AudioAPI，以及通过处理AudioService反应给MMI的一些confirm、negativeconfirm、ind等消息，实现与AudioService的交互。图STYLEREF1\s1SEQ图\*ARABIC\s11模块框架图所有有关Audio的操作，均由AudioService完成，而对于MMI来说，那么是需要去创立以及控制相关的AudioHandle，包括play、pause、resume、stop等操作。根据AudioService的冲突处理，系统中存在的所有Audio，有可能需要翻开多个AudioHandle，而每个AudioHandle的实现都需要各自的资源，如CODEC、device以及TrackBuffer〔内存〕等等，此外AudioHandle还存在Buffer以及File的两种情况。为了使AudioHandle不发生冲突并且又使用较少的内存，在实现时，具体分为以下3个应用。MMIAUDIO_APP〔Audio的具体应用，包括来电、message、闹钟、日程表、备忘录、拍照的铃声、power，以及包括预览铃声〕；MMIAUDIO_PLAYER〔Audio播放器，可能以后需要实现这个Audio播放器〕；MMIAUDIO_NORMAL〔Audio一般应用，包括keytone、flip等等〕。其中MMIAUDIO_APP的优先级最高，其次是MMIAUDIO_PLAYER，最后是MMIAUDIO_NORMAL。也就是说高优先级的Handle可以去打断低优先级的Handle；而同一级别中，后来的Handle，也可以打断前面的Handle。不过由于通话中的特殊情况，在使用时需要先额外去判断时候打断前面的Handle。MMIAudio模块通过对AudioService提供的接口进行封装，构建了MMIAudio相关的整体控制框架，并向MMI各应用模块提供所有有关Audio的操作接口，包括创立handle、play、pause、resume、stop等操作。支持的Audio类型由于目前存在太多的媒体类型，而且每种类型又存在各种各样的文件类型，所以需要用户自行去控制播放音乐的类型。AudioService中支持的Audio的类型参见MMIAUDIO_TYPE_E定义。数据类型枚举MMIAUDIO_HTYPE【含义】MMIAUDIO_HTYPE定义了MMI具体应用的handle类型。【定义】typedefenum{MMIAUDIO_NONE,MMIAUDIO_APP,MMIAUDIO_PLAYER,MMIAUDIO_NORMAL,MMIAUDIO_MAX}MMIAUDIO_HTYPE;【参数说明】参数名称含义MMIAUDIO_NONE初始化类型MMIAUDIO_APPAudio的具体应用，包括来电、message、闹钟、日程表、备忘录、拍照的铃声、power，以及包括预览铃声等MMIAUDIO_PLAYERAudio播放器MMIAUDIO_NORMALAudio一般应用，包括keytone、flip等MMIAUDIO_MAX系统保存，不可使用MMIAUDIO_TYPE_E【含义】MMIAUDIO_TYPE_E定义了各类音频格式。【定义】typedefenum{MMIAUDIO_MIDI,MMIAUDIO_GENERIC_TONE,MMIAUDIO_CUSTOM_TONEMMIAUDIO_DTMF_TONE,MMIAUDIO_SMAF,MMIAUDIO_WAVE,MMIAUDIO_MP3, MMIAUDIO_WMA,MMIAUDIO_AMR,MMIAUDIO_ADPCM,MMIAUDIO_PCM,MMIAUDIO_AAC,MMIAUDIO_M4A,MMIAUDIO_TYPE_MAX}MMIAUDIO_TYPE_E;【参数说明】参数名称含义MMIAUDIO_MIDIMIDI音乐格式MMIAUDIO_GENERIC_TONEGenericToneMMIAUDIO_CUSTOM_TONECustomToneMMIAUDIO_DTMF_TONEDTMFToneMMIAUDIO_SMAFSMAF音乐格式MMIAUDIO_WAVEWAV文件MMIAUDIO_MP3MP3格式MMIAUDIO_WMAWMA格式MMIAUDIO_AMRAMR格式MMIAUDIO_ADPCMADPCM格式MMIAUDIO_PCMPCM格式MMIAUDIO_AACAAC格式MMIAUDIO_M4AM4A格式MMIAUDIO_MAX系统保存，不可使用MMIAUDIO_RESULT【含义】MMIAUDIO_RESULT定义了MMI具体应用对AudioHandle的操作结果。【定义】typedefenum{MMIAUDIO_RLT_SUCCESS=SCI_SUCCESS,MMIAUDIO_RLT_NOT_SUPPORT,MMIAUDIO_RLT_ERROR,MMIAUDIO_RLT_OTHER,MMIAUDIO_RLT_MAX}MMIAUDIO_RESULT;【参数说明】参数名称含义MMIAUDIO_RLT_SUCCESSAudio操作成功MMIAUDIO_RLT_NOT_SUPPORTAudio格式不支持MMIAUDIO_RLT_ERRORAudio操作错误MMIAUDIO_RLT_OTHER其他错误，如Audio资源冲突等MMIAUDIO_MAX系统保存，不可使用MMIBGPLAY_MODULE_E【含义】MMIBGPLAY_MODULE_E定义了MMI具体应用中和背景播放有交互的模块或事件。【定义】typedefenum{MMIBGPLAY_MODULE_NONE,MMIBGPLAY_MODULE_CC,MMIBGPLAY_MODULE_ALARM,MMIBGPLAY_MODULE_NEWSMS,MMIBGPLAY_MODULE_NEWMMS,MMIBGPLAY_MODULE_MMS,MMIBGPLAY_MODULE_MMS_INBOX,MMIBGPLAY_MODULE_MMS_DOWNLOAD,MMIBGPLAY_MODULE_EDITMMS,MMIBGPLAY_MODULE_WAP,MMIBGPLAY_MODULE_DC,MMIBGPLAY_MODULE_DV,MMIBGPLAY_MODULE_MPEG4,MMIBGPLAY_MODULE_MYDOCUMENT,MMIBGPLAY_MODULE_RECORDER,MMIBGPLAY_MODULE_UDISK,MMIBGPLAY_MODULE_ENVSET,MMIBGPLAY_MODULE_SCREENSAVER_SET,MMIBGPLAY_MODULE_POWER_ON_ANIM_SET,MMIBGPLAY_MODULE_POWER_OFF_ANIM_SET,MMIBGPLAY_MODULE_ALARMSET,MMIBGPLAY_MODULE_SCHEDULESET,MMIBGPLAY_MODULE_PHONEBOOK,MMIBGPLAY_MODULE_LOWPOWER,MMIBGPLAY_MODULE_SD,MMIBGPLAY_MODULE_SELFROM_MYDOC,MMIBGPLAY_MODULE_RINGSEL_FROMSET,MMIBGPLAY_MODULE_BLUETOOTH,MMIBGPLAY_MODULE_NEW_MESSAGE,.#ifdefMMI_JAVA_ENABLEMMIBGPLAY_MODULE_JAVA,#endifMMIBGPLAY_MODULE_POWEROFF,MMIBGPLAY_MODULE_PBVIEW,MMIBGPLAY_MODULE_EARPHONE,MMIBGPLAY_MODULE_FM,MMIBGPLAY_MODULE_MP3,MMIBGPLAY_MODULE_FMM,MMIBGPLAY_MODULE_FMM_COPY,MMIBGPLAY_MODULE_ST,MMIBGPLAY_MODULE_EBOOK,MMIBGPLAY_MODULE_MAX}MMIBGPLAY_MODULE_E;【参数说明】参数名称含义MMIBGPLAY_MODULE_NONE初始化类型MMIBGPLAY_MODULE_CC通话MMIBGPLAY_MODULE_ALARM闹铃响应MMIBGPLAY_MODULE_NEWSMS新短信到达MMIBGPLAY_MODULE_NEWMMS新彩信到达MMIBGPLAY_MODULE_MMS彩信模块MMIBGPLAY_MODULE_MMS_INBOX彩信收件箱MMIBGPLAY_MODULE_MMS_DOWNLOAD彩信下载MMIBGPLAY_MODULE_EDITMMS彩信编辑MMIBGPLAY_MODULE_WAPWAP模块MMIBGPLAY_MODULE_DC拍照模块MMIBGPLAY_MODULE_DV摄像模块MMIBGPLAY_MODULE_MPEG4视频播放器模块MMIBGPLAY_MODULE_MYDOCUMENT“我的文档〞模块MMIBGPLAY_MODULE_RECORDER录音模块MMIBGPLAY_MODULE_UDISKU盘模块MMIBGPLAY_MODULE_ENVSET环境设置MMIBGPLAY_MODULE_SCREENSAVER_SET屏保设置MMIBGPLAY_MODULE_POWER_ON_ANIM_SET开机动画设置MMIBGPLAY_MODULE_POWER_OFF_ANIM_SET关机动画设置MMIBGPLAY_MODULE_ALARMSET闹铃设置MMIBGPLAY_MODULE_SCHEDULESET日程设置MMIBGPLAY_MODULE_PHONEBOOK本模块MMIBGPLAY_MODULE_LOWPOWER低电量响应MMIBGPLAY_MODULE_SD存储卡模块MMIBGPLAY_MODULE_SELFROM_MYDOC“我的文档〞文件列表中选择文件MMIBGPLAY_MODULE_RINGSEL_FROMSET固定铃声选择MMIBGPLAY_MODULE_BLUETOOTH蓝牙模块MMIBGPLAY_MODULE_NEW_MESSAGE新消息类型，包括SMS、MMS、WAP等的push操作MMIBGPLAY_MODULE_JAVAJava模块MMIBGPLAY_MODULE_POWEROFF关机事件MMIBGPLAY_MODULE_PBVIEW本浏览MMIBGPLAY_MODULE_EARPHONE耳机插入事件MMIBGPLAY_MODULE_FM进入FM播放器MMIBGPLAY_MODULE_MP3进入MP3播放器MMIBGPLAY_MODULE_FMM资源管理器模块MMIBGPLAY_MODULE_FMM_COPY文件复制MMIBGPLAY_MODULE_ST流媒体模块MMIBGPLAY_MODULE_EBOOK电子书模块MMIBGPLAY_MODULE_MAX系统保存，不可使用MMIBGPLAY_TYPE_E【含义】MMIBGPLAY_TYPE_E定义了背景播放类型。【定义】typedefenum{MMIBGPLAY_TYPE_MP3,MMIBGPLAY_TYPE_FM,MMIBGPLAY_TYPE_ALL}MMIBGPLAY_TYPE_E;【参数说明】参数名称含义MMIBGPLAY_TYPE_MP3MP3背景播放MMIBGPLAY_TYPE_FMFM背景播放MMIBGPLAY_TYPE_ALLMP3和FM背景播放，涵盖MMIBGPLAY_TYPE_MP3和MMIBGPLAY_TYPE_FM两种类型回调函数MMIAUDIO_END_CALLBACK_PFUNC【含义】MMIAUDIO_END_CALLBACK_PFUNC定义了MMI具体应用的音频播放自动结束后的回调函数。【定义】typedefvoid(*MMIAUDIO_END_CALLBACK_PFUNC)(MMIAUDIO_RESULTresult,DPARAMparam);【参数说明】参数名称含义resultAudio操作的结果param携带的数据参数提供应其他模块的接口播放相关接口MMIAUDIO_Init【函数原型】PUBLICvoidMMIAUDIO_Init(void);【函数功能】该函数用于初始化Audio消息处理函数，以及音频模块的一些初始化工作。开机初始化调用。【参数说明】无。【返回值】无。【考前须知】无。MMIAUDIO_CreateAudioBufHandle【函数原型】PUBLICBOOLEANMMIAUDIO_CreateAudioBufHandle(MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constuint8*pucData,uint32uiDataLength);【函数功能】该函数用于创立一个基于Buffer的AudioHandle。音乐数据被保存在一个内存区内，无法通过文件系统进行访问。【参数说明】audio_handle_type：创立AudioHandle的类型；ring_type：Audio类型；pucData：Audio数据的地址；uiDataLength：Audio数据长度。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_CreateA2dpAudioBufHandle【函数原型】PUBLICBOOLEANMMIAUDIO_CreateA2dpAudioBufHandle(BOOLEANis_need_a2dp,MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constuint8*pucData,uint32uiDataLength);【函数功能】该函数用于创立一个基于Buffer的AudioHandle。音乐数据被保存在一个内存区内，无法通过文件系统进行访问。is_need_a2dp为TRUE时，用于A2DP方式播放；为FALSE时那么函数功能与MMIAUDIO_CreateAudioBufHandle相同。【参数说明】is_need_a2dp：是否将以A2DP方式播放；audio_handle_type：创立AudioHandle的类型；ring_type：Audio类型；pucData：Audio数据的地址；uiDataLength：Audio数据长度。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_CreateAudioFileHandle【函数原型】PUBLICBOOLEANMMIAUDIO_CreateAudioFileHandle(MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constwchar*name_ptr,FILE_DEV_E_TtDevType);【函数功能】该函数用于创立一个基于文件系统的AudioHandle。【参数说明】audio_handle_type：创立AudioHandle的类型；ring_type：Audio类型；name_ptr：Audio文件名；tDevType：Audio所在位置。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_CreateA2dpAudioFileHandle【函数原型】PUBLICBOOLEANMMIAUDIO_CreateA2dpAudioFileHandle(BOOLEANis_need_a2dp,MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constwchar*name_ptr,FILE_DEV_E_TtDevType);【函数功能】该函数用于创立一个基于文件系统的AudioHandle。is_need_a2dp为TRUE时，用于A2DP方式播放；为FALSE时那么函数功能与MMIAUDIO_CreateAudioFileHandle相同。【参数说明】is_need_a2dp：是否将以A2DP方式播放；audio_handle_type：创立AudioHandle的类型；ring_type：Audio类型；name_ptr：Audio文件名；tDevType：Audio所在位置。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_CloseAudioHandle【函数原型】PUBLICvoidMMIAUDIO_CloseAudioHandle(MMIAUDIO_HTYPEaudio_handle_type)；【函数功能】该函数用于关闭指定的AudioHandle。主要用于在翻开的AudioHandle不合法下，需要手动去关闭该AudioHandle。【参数说明】audio_handle_type：所要操作的AudioHandle的类型。【返回值】无。【考前须知】无。MMIAUDIO_AudioPlay【函数原型】PUBLICvoidMMIAUDIO_AudioPlay(MMIAUDIO_HTYPEaudio_handle_type,uint32uiOffset,uint32play_times,MMIAUDIO_END_CALLBACK_PFUNCend_callback_func);【函数功能】该函数用于根据指定的AudioHandle类型进行播放Audio。播放的统一接口，包括Bufferplay和Fileplay。【参数说明】audio_handle_type：所要操作的AudioHandle类型；uiOffset：播放起始偏移量；play_times：播放次数；end_callback_func：播放结束的回调函数。【返回值】无。【考前须知】无。MMIAUDIO_AudioStop【函数原型】PUBLICvoidMMIAUDIO_AudioStop(MMIAUDIO_HTYPEaudio_handle_type);【函数功能】该函数用于停止指定的AudioHandle的播放。播放停止的统一接口，包括Bufferplay和Fileplay。【参数说明】audio_handle_type：所要操作的AudioHandle类型。【返回值】无。【考前须知】无。MMIAUDIO_AudioPause【函数原型】PUBLICvoidMMIAUDIO_AudioPause(MMIAUDIO_HTYPEaudio_handle_type);【函数功能】该函数用于暂停指定的AudioHandle的播放。【参数说明】audio_handle_type：所要操作的AudioHandle类型。【返回值】无。【考前须知】无。MMIAUDIO_AudioResume【函数原型】PUBLICvoidMMIAUDIO_AudioResume(MMIAUDIO_HTYPEaudio_handle_type);【函数功能】该函数用于恢复一个已经暂停的AudioHandle。【参数说明】audio_handle_type：所要操作的AudioHandle类型。 【返回值】无。【考前须知】无。MMIAUDIO_AudioSeek【函数原型】PUBLICBOOLEANMMIAUDIO_AudioSeek(MMIAUDIO_HTYPEaudio_handle_type,uint32uiOffset)；【函数功能】该函数用于寻找指定偏移量的Audio位置。本接口只支持从Audio的开始处进行寻找。【参数说明】audio_handle_type：所要操作的AudioHandle的类型；uiOffset：所要寻找的偏移量。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_PlayTone【函数原型】PUBLICvoidMMIAUDIO_PlayTone(MMIAUDIO_TYPE_Etone_type,uint32tone_id,uint32duration);【函数功能】该函数用于播放tone音。【参数说明】tone_type：tone音的类型，包括MMIAUDIO_GENERIC_TONE、MMIAUDIO_CUSTOM_TONE、MMIAUDIO_DTMF_TONE；tone_id：依赖于tone_type，为通用音调的ID〔AUD_GENERIC_TONE_ID_E类型〕或者双音多频〔DTMF〕音调的ID〔AUD_DTMF_TONE_ID_E类型〕；duration：播放该音调的时间，单位为毫秒。【返回值】无。【考前须知】无。MMIAUDIO_StopTone【函数原型】PUBLICvoidMMIAUDIO_StopTone(MMIAUDIO_TYPE_Etone_type)；【函数功能】该函数用于停止tone音的播放。【参数说明】tone_type：tone音的类型，包括MMIAUDIO_GENERIC_TONE、MMIAUDIO_CUSTOM_TONE、MMIAUDIO_DTMF_TONE。【返回值】无。【考前须知】无。MMIAUDIO_AudioGetFileInfo【函数原型】PUBLICAUDIO_RESULT_EMMIAUDIO_AudioGetFileInfo(MMIAUDIO_HTYPEaudio_handle_type,AUDIO_FILEINFO_T*ptfileInfo);【函数功能】该函数用于获取所要操作的Audio的文件信息。得到的音乐信息将通过输出参数ptfileInfo反应回来。该函数可以用来判断翻开的Audio文件是否为系统支持播放的。【参数说明】audio_handle_type：所要操作的AudioHandle的类型；ptfileInfo：［OUT］文件信息。【返回值】操作成功：返回AUDIO_NO_ERROR；操作失败：返回失败的原因，详细信息请参考AUDIO_RESULT_E定义。【考前须知】该函数只能在创立handle后、播放前才能调用，在播放过程中不能调用。MMIAUDIO_AudioGetPlayingFileInfo【函数原型】PUBLICvoidMMIAUDIO_AudioGetPlayingFileInfo(MMIAUDIO_HTYPEaudio_handle_type,AUDIO_PLAYINFO_T*ptPlayInfo);【函数功能】该函数用于获取一个正在播放的音乐的相关播放信息，如播放的文件位置等。【参数说明】audio_handle_type：所要操作的AudioHandle的类型；uiOffset：所要寻找的偏移量。【返回值】无。【考前须知】该函数只能在播放过程中才能调用。MMIAUDIO_AudioSetSpeed【函数原型】PUBLICvoidMMIAUDIO_AudioSetSpeed(MMIAUDIO_HTYPEaudio_handle_type,uint32uiSpeedX);【函数功能】该函数用于设定音乐播放的速度。【参数说明】audio_handle_type：所要操作的AudioHandle的类型；uiSpeedX：所要设定的音乐播放速度。速度以倍速为单位。如想要设定2倍速，那么uiSpeedX应当设为2；如果是4倍速，那么应当设为4，依此类推。【返回值】无。【考前须知】无。MMIAUDIO_SetEQMode【函数原型】PUBLICvoidMMIAUDIO_SetEQMode(EQ_EXP_MODE_Emode);【函数功能】该函数用于设置EQ参数。【参数说明】mode：所要设置的EQ参数类型，详细信息请参考EQ_EXP_MODE_E定义。【返回值】无。【考前须知】无。MMIAUDIO_GetCurVolume【函数原型】PUBLICuint32MMIAUDIO_GetCurVolume(void);【函数功能】该函数用于当前的音频播放的音量大小设置。【参数说明】无。【返回值】音量大小，其值须小于AUD_MAX_SPEAKER_VOLUME〔定义参见文档《AudioService软件设计说明书》〕。【考前须知】无。MMIAUDIO_SetVolume【函数原型】PUBLICvoidMMIAUDIO_SetVolume(AUD_DEV_MODE_Emode,uint32speaker_vol);【函数功能】该函数用于设置音频播放的音量大小。【参数说明】mode：声音设备模式，详细信息请参考AUD_DEV_MODE_E定义；speaker_vol：音量大小，其值须小于AUD_MAX_SPEAKER_VOLUME〔定义参见文档《AudioService软件设计说明书》〕。【返回值】无。【考前须知】无。MMIAUDIO_SetMute【函数原型】PUBLICvoidMMIAUDIO_SetMute(BOOLEANis_mute);【函数功能】该函数用于设置或者取消VB静音效果。【参数说明】is_mute：是否静音，TRUE为设置静音，FALSE为取消静音。【返回值】无。【考前须知】无。MMIAUDIO_GetCurDevMode【函数原型】PUBLICAUD_DEV_MODE_EMMIAUDIO_GetCurDevMode(void);【函数功能】该函数用于获得当前声音设备模式。【参数说明】无。【返回值】当前声音设备模式，AUD_DEV_MODE_E类型的具体定义参见文档《AudioService软件设计说明书》。【考前须知】无。MMIAUDIO_SetCurDevMode【函数原型】PUBLICvoidMMIAUDIO_SetCurDevMode(AUD_DEV_MODE_Emode);【函数功能】该函数用于设置当前声音设备模式。【参数说明】mode：所要设置的声音设备模式，AUD_DEV_MODE_E类型的具体定义参见文档《AudioService软件设计说明书》。【返回值】无。【考前须知】无。MMIAUDIO_GetIsPlaying【函数原型】PUBLICBOOLEANMMIAUDIO_GetIsPlaying(void);【函数功能】该函数用于判断当前系统是否有audio在播放。【参数说明】无。【返回值】TRUE：有Audio在播放；FALSE：无Audio在播放。【考前须知】无。MMIAUDIO_GetIsPermitPlay【函数原型】PUBLICBOOLEANMMIAUDIO_GetIsPermitPlay(MMIAUDIO_HTYPEaudio_htype);【函数功能】该函数用于判断是否允许当前Audio的播放。如果此时在通话状态，那么需要根据实际情况来判断是否允许当前Audio的播放。这里只是一个冲突处理的判断。【参数说明】audio_htype：所要播放的AudioHandle的类型。【返回值】TRUE：允许播放；FALSE：不允许播放。【考前须知】无。MMIAUDIO_GetAudioHtype【函数原型】PUBLICMMIAUDIO_HTYPEMMIAUDIO_GetAudioHtype(void);【函数功能】该函数用于获取当前当前播放的AudioHandle的类型。【参数说明】无。【返回值】MMIAUDIO_NONE：没有音乐在播放；MMIAUDIO_APP：APPhandle；MMIAUDIO_PLAYER：Playerhandle；MMIAUDIO_NORMAL：Normal。【考前须知】无。MMIAUDIO_GetAudioHandle【函数原型】PUBLICHAUDIOMMIAUDIO_GetAudioHandle(MMIAUDIO_HTYPEaudio_handle_type);【函数功能】该函数用于获取当前播放的AudioHandle。【参数说明】audio_htype：当前播放的AudioHandle的类型。【返回值】当前播放的AudioHandle的指针。【考前须知】无。录音相关接口MMIAUDIO_StartRecord【函数原型】PUBLICBOOLEANMMIAUDIO_StartRecord(constwchar*name_ptr,FILE_DEV_E_TtDevType);【函数功能】开始录音。【参数说明】name_ptr：录音的文件名；tDevType：录音文件的位置。【返回值】TRUE：成功；FALSE：失败。【考前须知】无。MMIAUDIO_StopRecord【函数原型】PUBLICvoidMMIAUDIO_StopRecord(void);【函数功能】停止录音。【参数说明】无。【返回值】无。【考前须知】无。MMIAUDIO_EndRecord【函数原型】PUBLICvoidMMIAUDIO_EndRecord(void);【函数功能】该函数用于结束一个录音操作。主要用于由于异常引起的录音失败，需要手动去结束这个录音，也就是关闭开始录音时翻开的Handle。【参数说明】无。【返回值】无。【考前须知】无。MMIAUDIO_PauseRecord【函数原型】PUBLICvoidMMIAUDIO_PauseRecord(void);【函数功能】该函数用于暂停一个录音操作。【参数说明】无。【返回值】无。【考前须知】无。MMIAUDIO_ResumeRecord【函数原型】PUBLICvoidMMIAUDIO_ResumeRecord(void);【函数功能】该函数用于恢复一个已暂停的录音操作。【参数说明】无。【返回值】无。【考前须知】无。背景播放控制接口MMIAUDIO_PauseBgPlay【函数原型】PUBLICvoidMMIAUDIO_PauseBgPlay(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函数功能】该函数用于进入某些和背景播放有冲突的模块时，暂停背景播放。【参数说明】pause_type：需要暂停的背景播放的类型；module：当前处理的模块或事件的类型。【返回值】无。【考前须知】无。MMIAUDIO_PauseBgPlayAndA2dp【函数原型】PUBLICvoidMMIAUDIO_PauseBgPlayAndA2dp(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函数功能】该函数用于进入某些和背景播放有冲突的模块时，暂停背景播放，同时暂停蓝牙A2DP。【参数说明】pause_type：需要暂停的背景播放的类型；module：当前处理的模块或事件的类型。【返回值】无。【考前须知】无。MMIAUDIO_PauseBgPlayII【函数原型】PUBLICvoidMMIAUDIO_PauseBgPlayII(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函数功能】该函数用于进入某些和背景播放有冲突的模块时，暂停背景播放。此函数为：MMIAUDIO_PauseBgPlay和MMIAUDIO_PauseBgPlayAndA2dp的一个合集，当平台支持蓝牙A2DP时功能与MMIAUDIO_PauseBgPlayAndA2dp相同，不支持时为MMIAUDIO_PauseBgPlay相同。【参数说明】pause_type：需要暂停的背