展訊音頻接口簡介

TITLEMocorMMIAudioInterfaceUserGuideVersion:1.0.DocCode:SW-MOCOR-UG-0003Date:200重要聲明版權聲明本文檔中的任何內(nèi)容受《中華人民共和國著作權法》的保護，版權所有?2023，展訊通信，保存所有權利，但注明引用其他方的內(nèi)容除外。商標聲明展訊通信和展訊通信的產(chǎn)品是展訊通信專有。在提及其他公司及其產(chǎn)品時將使用各自公司所擁有的商標，這種使用的目的僅限于引用。不作保證聲明展訊通信不對此文檔中的任何內(nèi)容作任何明示或暗示的陳述或保證，而且不對特定目的的適銷性及適用性或者任何間接、特殊或連帶的損失承當任何責任。保密聲明本文檔〔包括任何附件〕包含的信息是保密信息。接收人了解其獲得的本文檔是保密的，除用于規(guī)定的目的外不得用于任何目的，也不得將本文檔泄露給任何第三方。前言文檔說明本文檔為MMIAudio模塊的接口文檔，詳細描述了本模塊提供應其他MMI模塊的API接口。閱讀對象本文檔適合MMI軟件開發(fā)人員和相關客戶開發(fā)人員使用。內(nèi)容介紹本文檔包括三個章節(jié)，分別為：第一章：模塊的總體結構。簡單介紹了MMIAUDIO模塊的功能結構；第二章：數(shù)據(jù)類型。介紹了涉及的數(shù)據(jù)結構。第三章：提供應其他模塊的接口。介紹了MMIAUDIO模塊提供應外部模塊的接口函數(shù)。文檔約定本文檔采用下面醒目標志來表示在操作過程中應該特別注意的地方。注意：提醒操作中應注意的事項。說明：說明比擬重要的事項。相關文檔《軟件設計說明書_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章數(shù)據(jù)類型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回調函數(shù)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模塊的系統(tǒng)結構框圖，圖中虛線框內(nèi)的模塊為AudioServiceMMI的范疇。其中AudioMMI通過調用AudioAPI，以及通過處理AudioService反應給MMI的一些confirm、negativeconfirm、ind等消息，實現(xiàn)與AudioService的交互。圖STYLEREF1\s1SEQ圖\*ARABIC\s11模塊框架圖所有有關Audio的操作，均由AudioService完成，而對于MMI來說，那么是需要去創(chuàng)立以及控制相關的AudioHandle，包括play、pause、resume、stop等操作。根據(jù)AudioService的沖突處理，系統(tǒng)中存在的所有Audio，有可能需要翻開多個AudioHandle，而每個AudioHandle的實現(xiàn)都需要各自的資源，如CODEC、device以及TrackBuffer〔內(nèi)存〕等等，此外AudioHandle還存在Buffer以及File的兩種情況。為了使AudioHandle不發(fā)生沖突并且又使用較少的內(nèi)存，在實現(xiàn)時，具體分為以下3個應用。MMIAUDIO_APP〔Audio的具體應用，包括來電、message、鬧鐘、日程表、備忘錄、拍照的鈴聲、power，以及包括預覽鈴聲〕；MMIAUDIO_PLAYER〔Audio播放器，可能以后需要實現(xiàn)這個Audio播放器〕；MMIAUDIO_NORMAL〔Audio一般應用，包括keytone、flip等等〕。其中MMIAUDIO_APP的優(yōu)先級最高，其次是MMIAUDIO_PLAYER，最后是MMIAUDIO_NORMAL。也就是說高優(yōu)先級的Handle可以去打斷低優(yōu)先級的Handle；而同一級別中，后來的Handle，也可以打斷前面的Handle。不過由于通話中的特殊情況，在使用時需要先額外去判斷時候打斷前面的Handle。MMIAudio模塊通過對AudioService提供的接口進行封裝，構建了MMIAudio相關的整體控制框架，并向MMI各應用模塊提供所有有關Audio的操作接口，包括創(chuàng)立handle、play、pause、resume、stop等操作。支持的Audio類型由于目前存在太多的媒體類型，而且每種類型又存在各種各樣的文件類型，所以需要用戶自行去控制播放音樂的類型。AudioService中支持的Audio的類型參見MMIAUDIO_TYPE_E定義。數(shù)據(jù)類型枚舉MMIAUDIO_HTYPE【含義】MMIAUDIO_HTYPE定義了MMI具體應用的handle類型?！径x】typedefenum{MMIAUDIO_NONE,MMIAUDIO_APP,MMIAUDIO_PLAYER,MMIAUDIO_NORMAL,MMIAUDIO_MAX}MMIAUDIO_HTYPE;【參數(shù)說明】參數(shù)名稱含義MMIAUDIO_NONE初始化類型MMIAUDIO_APPAudio的具體應用，包括來電、message、鬧鐘、日程表、備忘錄、拍照的鈴聲、power，以及包括預覽鈴聲等MMIAUDIO_PLAYERAudio播放器MMIAUDIO_NORMALAudio一般應用，包括keytone、flip等MMIAUDIO_MAX系統(tǒng)保存，不可使用MMIAUDIO_TYPE_E【含義】MMIAUDIO_TYPE_E定義了各類音頻格式?！径x】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;【參數(shù)說明】參數(shù)名稱含義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系統(tǒng)保存，不可使用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;【參數(shù)說明】參數(shù)名稱含義MMIAUDIO_RLT_SUCCESSAudio操作成功MMIAUDIO_RLT_NOT_SUPPORTAudio格式不支持MMIAUDIO_RLT_ERRORAudio操作錯誤MMIAUDIO_RLT_OTHER其他錯誤，如Audio資源沖突等MMIAUDIO_MAX系統(tǒng)保存，不可使用MMIBGPLAY_MODULE_E【含義】MMIBGPLAY_MODULE_E定義了MMI具體應用中和背景播放有交互的模塊或事件?！径x】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;【參數(shù)說明】參數(shù)名稱含義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環(huán)境設置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系統(tǒng)保存，不可使用MMIBGPLAY_TYPE_E【含義】MMIBGPLAY_TYPE_E定義了背景播放類型?！径x】typedefenum{MMIBGPLAY_TYPE_MP3,MMIBGPLAY_TYPE_FM,MMIBGPLAY_TYPE_ALL}MMIBGPLAY_TYPE_E;【參數(shù)說明】參數(shù)名稱含義MMIBGPLAY_TYPE_MP3MP3背景播放MMIBGPLAY_TYPE_FMFM背景播放MMIBGPLAY_TYPE_ALLMP3和FM背景播放，涵蓋MMIBGPLAY_TYPE_MP3和MMIBGPLAY_TYPE_FM兩種類型回調函數(shù)MMIAUDIO_END_CALLBACK_PFUNC【含義】MMIAUDIO_END_CALLBACK_PFUNC定義了MMI具體應用的音頻播放自動結束后的回調函數(shù)?！径x】typedefvoid(*MMIAUDIO_END_CALLBACK_PFUNC)(MMIAUDIO_RESULTresult,DPARAMparam);【參數(shù)說明】參數(shù)名稱含義resultAudio操作的結果param攜帶的數(shù)據(jù)參數(shù)提供應其他模塊的接口播放相關接口MMIAUDIO_Init【函數(shù)原型】PUBLICvoidMMIAUDIO_Init(void);【函數(shù)功能】該函數(shù)用于初始化Audio消息處理函數(shù)，以及音頻模塊的一些初始化工作。開機初始化調用。【參數(shù)說明】無?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_CreateAudioBufHandle【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_CreateAudioBufHandle(MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constuint8*pucData,uint32uiDataLength);【函數(shù)功能】該函數(shù)用于創(chuàng)立一個基于Buffer的AudioHandle。音樂數(shù)據(jù)被保存在一個內(nèi)存區(qū)內(nèi)，無法通過文件系統(tǒng)進行訪問?！緟?shù)說明】audio_handle_type：創(chuàng)立AudioHandle的類型；ring_type：Audio類型；pucData：Audio數(shù)據(jù)的地址；uiDataLength：Audio數(shù)據(jù)長度?！痉祷刂怠縏RUE：成功；FALSE：失敗。【考前須知】無。MMIAUDIO_CreateA2dpAudioBufHandle【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_CreateA2dpAudioBufHandle(BOOLEANis_need_a2dp,MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constuint8*pucData,uint32uiDataLength);【函數(shù)功能】該函數(shù)用于創(chuàng)立一個基于Buffer的AudioHandle。音樂數(shù)據(jù)被保存在一個內(nèi)存區(qū)內(nèi)，無法通過文件系統(tǒng)進行訪問。is_need_a2dp為TRUE時，用于A2DP方式播放；為FALSE時那么函數(shù)功能與MMIAUDIO_CreateAudioBufHandle相同?！緟?shù)說明】is_need_a2dp：是否將以A2DP方式播放；audio_handle_type：創(chuàng)立AudioHandle的類型；ring_type：Audio類型；pucData：Audio數(shù)據(jù)的地址；uiDataLength：Audio數(shù)據(jù)長度。【返回值】TRUE：成功；FALSE：失敗?！究记绊氈繜o。MMIAUDIO_CreateAudioFileHandle【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_CreateAudioFileHandle(MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constwchar*name_ptr,FILE_DEV_E_TtDevType);【函數(shù)功能】該函數(shù)用于創(chuàng)立一個基于文件系統(tǒng)的AudioHandle。【參數(shù)說明】audio_handle_type：創(chuàng)立AudioHandle的類型；ring_type：Audio類型；name_ptr：Audio文件名；tDevType：Audio所在位置?！痉祷刂怠縏RUE：成功；FALSE：失敗?！究记绊氈繜o。MMIAUDIO_CreateA2dpAudioFileHandle【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_CreateA2dpAudioFileHandle(BOOLEANis_need_a2dp,MMIAUDIO_HTYPEaudio_handle_type,MMIAUDIO_TYPE_Ering_type,constwchar*name_ptr,FILE_DEV_E_TtDevType);【函數(shù)功能】該函數(shù)用于創(chuàng)立一個基于文件系統(tǒng)的AudioHandle。is_need_a2dp為TRUE時，用于A2DP方式播放；為FALSE時那么函數(shù)功能與MMIAUDIO_CreateAudioFileHandle相同?！緟?shù)說明】is_need_a2dp：是否將以A2DP方式播放；audio_handle_type：創(chuàng)立AudioHandle的類型；ring_type：Audio類型；name_ptr：Audio文件名；tDevType：Audio所在位置?！痉祷刂怠縏RUE：成功；FALSE：失敗?！究记绊氈繜o。MMIAUDIO_CloseAudioHandle【函數(shù)原型】PUBLICvoidMMIAUDIO_CloseAudioHandle(MMIAUDIO_HTYPEaudio_handle_type)；【函數(shù)功能】該函數(shù)用于關閉指定的AudioHandle。主要用于在翻開的AudioHandle不合法下，需要手動去關閉該AudioHandle?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_AudioPlay【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioPlay(MMIAUDIO_HTYPEaudio_handle_type,uint32uiOffset,uint32play_times,MMIAUDIO_END_CALLBACK_PFUNCend_callback_func);【函數(shù)功能】該函數(shù)用于根據(jù)指定的AudioHandle類型進行播放Audio。播放的統(tǒng)一接口，包括Bufferplay和Fileplay?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle類型；uiOffset：播放起始偏移量；play_times：播放次數(shù)；end_callback_func：播放結束的回調函數(shù)。【返回值】無?！究记绊氈繜o。MMIAUDIO_AudioStop【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioStop(MMIAUDIO_HTYPEaudio_handle_type);【函數(shù)功能】該函數(shù)用于停止指定的AudioHandle的播放。播放停止的統(tǒng)一接口，包括Bufferplay和Fileplay?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle類型?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_AudioPause【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioPause(MMIAUDIO_HTYPEaudio_handle_type);【函數(shù)功能】該函數(shù)用于暫停指定的AudioHandle的播放?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle類型?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_AudioResume【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioResume(MMIAUDIO_HTYPEaudio_handle_type);【函數(shù)功能】該函數(shù)用于恢復一個已經(jīng)暫停的AudioHandle?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle類型。 【返回值】無。【考前須知】無。MMIAUDIO_AudioSeek【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_AudioSeek(MMIAUDIO_HTYPEaudio_handle_type,uint32uiOffset)；【函數(shù)功能】該函數(shù)用于尋找指定偏移量的Audio位置。本接口只支持從Audio的開始處進行尋找?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型；uiOffset：所要尋找的偏移量?！痉祷刂怠縏RUE：成功；FALSE：失敗。【考前須知】無。MMIAUDIO_PlayTone【函數(shù)原型】PUBLICvoidMMIAUDIO_PlayTone(MMIAUDIO_TYPE_Etone_type,uint32tone_id,uint32duration);【函數(shù)功能】該函數(shù)用于播放tone音。【參數(shù)說明】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【函數(shù)原型】PUBLICvoidMMIAUDIO_StopTone(MMIAUDIO_TYPE_Etone_type)；【函數(shù)功能】該函數(shù)用于停止tone音的播放。【參數(shù)說明】tone_type：tone音的類型，包括MMIAUDIO_GENERIC_TONE、MMIAUDIO_CUSTOM_TONE、MMIAUDIO_DTMF_TONE。【返回值】無?！究记绊氈繜o。MMIAUDIO_AudioGetFileInfo【函數(shù)原型】PUBLICAUDIO_RESULT_EMMIAUDIO_AudioGetFileInfo(MMIAUDIO_HTYPEaudio_handle_type,AUDIO_FILEINFO_T*ptfileInfo);【函數(shù)功能】該函數(shù)用于獲取所要操作的Audio的文件信息。得到的音樂信息將通過輸出參數(shù)ptfileInfo反應回來。該函數(shù)可以用來判斷翻開的Audio文件是否為系統(tǒng)支持播放的。【參數(shù)說明】audio_handle_type：所要操作的AudioHandle的類型；ptfileInfo：［OUT］文件信息?！痉祷刂怠坎僮鞒晒Γ悍祷谹UDIO_NO_ERROR；操作失?。悍祷厥〉脑?，詳細信息請參考AUDIO_RESULT_E定義?！究记绊氈吭摵瘮?shù)只能在創(chuàng)立handle后、播放前才能調用，在播放過程中不能調用。MMIAUDIO_AudioGetPlayingFileInfo【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioGetPlayingFileInfo(MMIAUDIO_HTYPEaudio_handle_type,AUDIO_PLAYINFO_T*ptPlayInfo);【函數(shù)功能】該函數(shù)用于獲取一個正在播放的音樂的相關播放信息，如播放的文件位置等?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型；uiOffset：所要尋找的偏移量?！痉祷刂怠繜o?！究记绊氈吭摵瘮?shù)只能在播放過程中才能調用。MMIAUDIO_AudioSetSpeed【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioSetSpeed(MMIAUDIO_HTYPEaudio_handle_type,uint32uiSpeedX);【函數(shù)功能】該函數(shù)用于設定音樂播放的速度。【參數(shù)說明】audio_handle_type：所要操作的AudioHandle的類型；uiSpeedX：所要設定的音樂播放速度。速度以倍速為單位。如想要設定2倍速，那么uiSpeedX應當設為2；如果是4倍速，那么應當設為4，依此類推?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_SetEQMode【函數(shù)原型】PUBLICvoidMMIAUDIO_SetEQMode(EQ_EXP_MODE_Emode);【函數(shù)功能】該函數(shù)用于設置EQ參數(shù)。【參數(shù)說明】mode：所要設置的EQ參數(shù)類型，詳細信息請參考EQ_EXP_MODE_E定義?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_GetCurVolume【函數(shù)原型】PUBLICuint32MMIAUDIO_GetCurVolume(void);【函數(shù)功能】該函數(shù)用于當前的音頻播放的音量大小設置。【參數(shù)說明】無?！痉祷刂怠恳袅看笮。渲淀毿∮贏UD_MAX_SPEAKER_VOLUME〔定義參見文檔《AudioService軟件設計說明書》〕?！究记绊氈繜o。MMIAUDIO_SetVolume【函數(shù)原型】PUBLICvoidMMIAUDIO_SetVolume(AUD_DEV_MODE_Emode,uint32speaker_vol);【函數(shù)功能】該函數(shù)用于設置音頻播放的音量大小。【參數(shù)說明】mode：聲音設備模式，詳細信息請參考AUD_DEV_MODE_E定義；speaker_vol：音量大小，其值須小于AUD_MAX_SPEAKER_VOLUME〔定義參見文檔《AudioService軟件設計說明書》〕。【返回值】無。【考前須知】無。MMIAUDIO_SetMute【函數(shù)原型】PUBLICvoidMMIAUDIO_SetMute(BOOLEANis_mute);【函數(shù)功能】該函數(shù)用于設置或者取消VB靜音效果?！緟?shù)說明】is_mute：是否靜音，TRUE為設置靜音，F(xiàn)ALSE為取消靜音?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_GetCurDevMode【函數(shù)原型】PUBLICAUD_DEV_MODE_EMMIAUDIO_GetCurDevMode(void);【函數(shù)功能】該函數(shù)用于獲得當前聲音設備模式?！緟?shù)說明】無?！痉祷刂怠慨斍奥曇粼O備模式，AUD_DEV_MODE_E類型的具體定義參見文檔《AudioService軟件設計說明書》。【考前須知】無。MMIAUDIO_SetCurDevMode【函數(shù)原型】PUBLICvoidMMIAUDIO_SetCurDevMode(AUD_DEV_MODE_Emode);【函數(shù)功能】該函數(shù)用于設置當前聲音設備模式。【參數(shù)說明】mode：所要設置的聲音設備模式，AUD_DEV_MODE_E類型的具體定義參見文檔《AudioService軟件設計說明書》?！痉祷刂怠繜o。【考前須知】無。MMIAUDIO_GetIsPlaying【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_GetIsPlaying(void);【函數(shù)功能】該函數(shù)用于判斷當前系統(tǒng)是否有audio在播放?！緟?shù)說明】無?！痉祷刂怠縏RUE：有Audio在播放；FALSE：無Audio在播放?！究记绊氈繜o。MMIAUDIO_GetIsPermitPlay【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_GetIsPermitPlay(MMIAUDIO_HTYPEaudio_htype);【函數(shù)功能】該函數(shù)用于判斷是否允許當前Audio的播放。如果此時在通話狀態(tài)，那么需要根據(jù)實際情況來判斷是否允許當前Audio的播放。這里只是一個沖突處理的判斷?！緟?shù)說明】audio_htype：所要播放的AudioHandle的類型?！痉祷刂怠縏RUE：允許播放；FALSE：不允許播放?！究记绊氈繜o。MMIAUDIO_GetAudioHtype【函數(shù)原型】PUBLICMMIAUDIO_HTYPEMMIAUDIO_GetAudioHtype(void);【函數(shù)功能】該函數(shù)用于獲取當前當前播放的AudioHandle的類型?！緟?shù)說明】無?！痉祷刂怠縈MIAUDIO_NONE：沒有音樂在播放；MMIAUDIO_APP：APPhandle；MMIAUDIO_PLAYER：Playerhandle；MMIAUDIO_NORMAL：Normal?！究记绊氈繜o。MMIAUDIO_GetAudioHandle【函數(shù)原型】PUBLICHAUDIOMMIAUDIO_GetAudioHandle(MMIAUDIO_HTYPEaudio_handle_type);【函數(shù)功能】該函數(shù)用于獲取當前播放的AudioHandle?！緟?shù)說明】audio_htype：當前播放的AudioHandle的類型?！痉祷刂怠慨斍安シ诺腁udioHandle的指針?！究记绊氈繜o。錄音相關接口MMIAUDIO_StartRecord【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_StartRecord(constwchar*name_ptr,FILE_DEV_E_TtDevType);【函數(shù)功能】開始錄音?！緟?shù)說明】name_ptr：錄音的文件名；tDevType：錄音文件的位置?！痉祷刂怠縏RUE：成功；FALSE：失敗。【考前須知】無。MMIAUDIO_StopRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_StopRecord(void);【函數(shù)功能】停止錄音?！緟?shù)說明】無?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_EndRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_EndRecord(void);【函數(shù)功能】該函數(shù)用于結束一個錄音操作。主要用于由于異常引起的錄音失敗，需要手動去結束這個錄音，也就是關閉開始錄音時翻開的Handle?！緟?shù)說明】無?！痉祷刂怠繜o。【考前須知】無。MMIAUDIO_PauseRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseRecord(void);【函數(shù)功能】該函數(shù)用于暫停一個錄音操作?！緟?shù)說明】無?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_ResumeRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_ResumeRecord(void);【函數(shù)功能】該函數(shù)用于恢復一個已暫停的錄音操作?！緟?shù)說明】無。【返回值】無?！究记绊氈繜o。背景播放控制接口MMIAUDIO_PauseBgPlay【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlay(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放?！緟?shù)說明】pause_type：需要暫停的背景播放的類型；module：當前處理的模塊或事件的類型。【返回值】無。【考前須知】無。MMIAUDIO_PauseBgPlayAndA2dp【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlayAndA2dp(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放，同時暫停藍牙A2DP?！緟?shù)說明】pause_type：需要暫停的背景播放的類型；module：當前處理的模塊或事件的類型?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_PauseBgPlayII【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlayII(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放。此函數(shù)為：MMIAUDIO_PauseBgPlay和MMIAUDIO_PauseBgPlayAndA2dp的一個合集，當平臺支持藍牙A2DP時功能與MMIAUDIO_PauseBgPlayAndA2dp相同，不支持時為MMIAUDIO_PauseBgPlay相同?！緟?shù)說明】pause_type：需要暫停的背