展訊音頻接口簡介

TITLEMocorMMIAudioInterfaceUserGuideVersion:1.0.DocCode:SW-MOCOR-UG-0003Date:200重要聲明版權(quán)聲明本文檔中的任何內(nèi)容受《中華人民共和國著作權(quán)法》的保護，版權(quán)所有?2023，展訊通信，保存所有權(quán)利，但注明引用其他方的內(nèi)容除外。商標(biāo)聲明展訊通信和展訊通信的產(chǎn)品是展訊通信專有。在提及其他公司及其產(chǎn)品時將使用各自公司所擁有的商標(biāo)，這種使用的目的僅限于引用。不作保證聲明展訊通信不對此文檔中的任何內(nèi)容作任何明示或暗示的陳述或保證，而且不對特定目的的適銷性及適用性或者任何間接、特殊或連帶的損失承當(dāng)任何責(zé)任。保密聲明本文檔〔包括任何附件〕包含的信息是保密信息。接收人了解其獲得的本文檔是保密的，除用于規(guī)定的目的外不得用于任何目的，也不得將本文檔泄露給任何第三方。前言文檔說明本文檔為MMIAudio模塊的接口文檔，詳細描述了本模塊提供應(yīng)其他MMI模塊的API接口。閱讀對象本文檔適合MMI軟件開發(fā)人員和相關(guān)客戶開發(fā)人員使用。內(nèi)容介紹本文檔包括三個章節(jié)，分別為：第一章：模塊的總體結(jié)構(gòu)。簡單介紹了MMIAUDIO模塊的功能結(jié)構(gòu)；第二章：數(shù)據(jù)類型。介紹了涉及的數(shù)據(jù)結(jié)構(gòu)。第三章：提供應(yīng)其他模塊的接口。介紹了MMIAUDIO模塊提供應(yīng)外部模塊的接口函數(shù)。文檔約定本文檔采用下面醒目標(biāo)志來表示在操作過程中應(yīng)該特別注意的地方。注意：提醒操作中應(yīng)注意的事項。說明：說明比擬重要的事項。相關(guān)文檔《軟件設(shè)計說明書_Audio局部》《AudioService軟件設(shè)計說明書》。目錄TOC\o"1-3"\h\z\t"標(biāo)題6,1,標(biāo)題7,2,標(biāo)題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回調(diào)函數(shù)2-72.2.1MMIAUDIO_END_CALLBACK_PFUNC2-7第3章提供應(yīng)其他模塊的接口3-13.1播放相關(guān)接口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錄音相關(guān)接口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)結(jié)構(gòu)框圖，圖中虛線框內(nèi)的模塊為AudioServiceMMI的范疇。其中AudioMMI通過調(diào)用AudioAPI，以及通過處理AudioService反應(yīng)給MMI的一些confirm、negativeconfirm、ind等消息，實現(xiàn)與AudioService的交互。圖STYLEREF1\s1SEQ圖\*ARABIC\s11模塊框架圖所有有關(guān)Audio的操作，均由AudioService完成，而對于MMI來說，那么是需要去創(chuàng)立以及控制相關(guān)的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個應(yīng)用。MMIAUDIO_APP〔Audio的具體應(yīng)用，包括來電、message、鬧鐘、日程表、備忘錄、拍照的鈴聲、power，以及包括預(yù)覽鈴聲〕；MMIAUDIO_PLAYER〔Audio播放器，可能以后需要實現(xiàn)這個Audio播放器〕；MMIAUDIO_NORMAL〔Audio一般應(yīng)用，包括keytone、flip等等〕。其中MMIAUDIO_APP的優(yōu)先級最高，其次是MMIAUDIO_PLAYER，最后是MMIAUDIO_NORMAL。也就是說高優(yōu)先級的Handle可以去打斷低優(yōu)先級的Handle；而同一級別中，后來的Handle，也可以打斷前面的Handle。不過由于通話中的特殊情況，在使用時需要先額外去判斷時候打斷前面的Handle。MMIAudio模塊通過對AudioService提供的接口進行封裝，構(gòu)建了MMIAudio相關(guān)的整體控制框架，并向MMI各應(yīng)用模塊提供所有有關(guān)Audio的操作接口，包括創(chuàng)立handle、play、pause、resume、stop等操作。支持的Audio類型由于目前存在太多的媒體類型，而且每種類型又存在各種各樣的文件類型，所以需要用戶自行去控制播放音樂的類型。AudioService中支持的Audio的類型參見MMIAUDIO_TYPE_E定義。數(shù)據(jù)類型枚舉MMIAUDIO_HTYPE【含義】MMIAUDIO_HTYPE定義了MMI具體應(yīng)用的handle類型?！径x】typedefenum{MMIAUDIO_NONE,MMIAUDIO_APP,MMIAUDIO_PLAYER,MMIAUDIO_NORMAL,MMIAUDIO_MAX}MMIAUDIO_HTYPE;【參數(shù)說明】參數(shù)名稱含義MMIAUDIO_NONE初始化類型MMIAUDIO_APPAudio的具體應(yīng)用，包括來電、message、鬧鐘、日程表、備忘錄、拍照的鈴聲、power，以及包括預(yù)覽鈴聲等MMIAUDIO_PLAYERAudio播放器MMIAUDIO_NORMALAudio一般應(yīng)用，包括keytone、flip等MMIAUDIO_MAX系統(tǒng)保存，不可使用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;【參數(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具體應(yīng)用對AudioHandle的操作結(jié)果。【定義】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具體應(yīng)用中和背景播放有交互的模塊或事件?！径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鬧鈴響應(yīng)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)境設(shè)置MMIBGPLAY_MODULE_SCREENSAVER_SET屏保設(shè)置MMIBGPLAY_MODULE_POWER_ON_ANIM_SET開機動畫設(shè)置MMIBGPLAY_MODULE_POWER_OFF_ANIM_SET關(guān)機動畫設(shè)置MMIBGPLAY_MODULE_ALARMSET鬧鈴設(shè)置MMIBGPLAY_MODULE_SCHEDULESET日程設(shè)置MMIBGPLAY_MODULE_PHONEBOOK本模塊MMIBGPLAY_MODULE_LOWPOWER低電量響應(yīng)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關(guān)機事件MMIBGPLAY_MODULE_PBVIEW本瀏覽MMIBGPLAY_MODULE_EARPHONE耳機插入事件MMIBGPLAY_MODULE_FM進入FM播放器MMIBGPLAY_MODULE_MP3進入MP3播放器MMIBGPLAY_MODULE_FMM資源管理器模塊MMIBGPLAY_MODULE_FMM_COPY文件復(fù)制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兩種類型回調(diào)函數(shù)MMIAUDIO_END_CALLBACK_PFUNC【含義】MMIAUDIO_END_CALLBACK_PFUNC定義了MMI具體應(yīng)用的音頻播放自動結(jié)束后的回調(diào)函數(shù)。【定義】typedefvoid(*MMIAUDIO_END_CALLBACK_PFUNC)(MMIAUDIO_RESULTresult,DPARAMparam);【參數(shù)說明】參數(shù)名稱含義resultAudio操作的結(jié)果param攜帶的數(shù)據(jù)參數(shù)提供應(yīng)其他模塊的接口播放相關(guān)接口MMIAUDIO_Init【函數(shù)原型】PUBLICvoidMMIAUDIO_Init(void);【函數(shù)功能】該函數(shù)用于初始化Audio消息處理函數(shù)，以及音頻模塊的一些初始化工作。開機初始化調(diào)用。【參數(shù)說明】無。【返回值】無?！究记绊氈繜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ù)長度。【返回值】TRUE：成功；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ù)長度?！痉祷刂怠縏RUE：成功；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ù)用于關(guān)閉指定的AudioHandle。主要用于在翻開的AudioHandle不合法下，需要手動去關(guān)閉該AudioHandle?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型。【返回值】無?！究记绊氈繜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：播放結(jié)束的回調(diào)函數(shù)?！痉祷刂怠繜o?！究记绊氈繜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。【考前須知】無。MMIAUDIO_AudioResume【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioResume(MMIAUDIO_HTYPEaudio_handle_type);【函數(shù)功能】該函數(shù)用于恢復(fù)一個已經(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：失敗?！究记绊氈繜o。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，為通用音調(diào)的ID〔AUD_GENERIC_TONE_ID_E類型〕或者雙音多頻〔DTMF〕音調(diào)的ID〔AUD_DTMF_TONE_ID_E類型〕；duration：播放該音調(diào)的時間，單位為毫秒?！痉祷刂怠繜o?！究记绊氈繜o。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反應(yīng)回來。該函數(shù)可以用來判斷翻開的Audio文件是否為系統(tǒng)支持播放的?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型；ptfileInfo：［OUT］文件信息?！痉祷刂怠坎僮鞒晒Γ悍祷谹UDIO_NO_ERROR；操作失?。悍祷厥〉脑颍敿毿畔⒄垍⒖糀UDIO_RESULT_E定義?！究记绊氈吭摵瘮?shù)只能在創(chuàng)立handle后、播放前才能調(diào)用，在播放過程中不能調(diào)用。MMIAUDIO_AudioGetPlayingFileInfo【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioGetPlayingFileInfo(MMIAUDIO_HTYPEaudio_handle_type,AUDIO_PLAYINFO_T*ptPlayInfo);【函數(shù)功能】該函數(shù)用于獲取一個正在播放的音樂的相關(guān)播放信息，如播放的文件位置等?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型；uiOffset：所要尋找的偏移量。【返回值】無。【考前須知】該函數(shù)只能在播放過程中才能調(diào)用。MMIAUDIO_AudioSetSpeed【函數(shù)原型】PUBLICvoidMMIAUDIO_AudioSetSpeed(MMIAUDIO_HTYPEaudio_handle_type,uint32uiSpeedX);【函數(shù)功能】該函數(shù)用于設(shè)定音樂播放的速度?！緟?shù)說明】audio_handle_type：所要操作的AudioHandle的類型；uiSpeedX：所要設(shè)定的音樂播放速度。速度以倍速為單位。如想要設(shè)定2倍速，那么uiSpeedX應(yīng)當(dāng)設(shè)為2；如果是4倍速，那么應(yīng)當(dāng)設(shè)為4，依此類推?！痉祷刂怠繜o。【考前須知】無。MMIAUDIO_SetEQMode【函數(shù)原型】PUBLICvoidMMIAUDIO_SetEQMode(EQ_EXP_MODE_Emode);【函數(shù)功能】該函數(shù)用于設(shè)置EQ參數(shù)?！緟?shù)說明】mode：所要設(shè)置的EQ參數(shù)類型，詳細信息請參考EQ_EXP_MODE_E定義?！痉祷刂怠繜o。【考前須知】無。MMIAUDIO_GetCurVolume【函數(shù)原型】PUBLICuint32MMIAUDIO_GetCurVolume(void);【函數(shù)功能】該函數(shù)用于當(dāng)前的音頻播放的音量大小設(shè)置?！緟?shù)說明】無?！痉祷刂怠恳袅看笮。渲淀毿∮贏UD_MAX_SPEAKER_VOLUME〔定義參見文檔《AudioService軟件設(shè)計說明書》〕?！究记绊氈繜o。MMIAUDIO_SetVolume【函數(shù)原型】PUBLICvoidMMIAUDIO_SetVolume(AUD_DEV_MODE_Emode,uint32speaker_vol);【函數(shù)功能】該函數(shù)用于設(shè)置音頻播放的音量大小。【參數(shù)說明】mode：聲音設(shè)備模式，詳細信息請參考AUD_DEV_MODE_E定義；speaker_vol：音量大小，其值須小于AUD_MAX_SPEAKER_VOLUME〔定義參見文檔《AudioService軟件設(shè)計說明書》〕?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_SetMute【函數(shù)原型】PUBLICvoidMMIAUDIO_SetMute(BOOLEANis_mute);【函數(shù)功能】該函數(shù)用于設(shè)置或者取消VB靜音效果?！緟?shù)說明】is_mute：是否靜音，TRUE為設(shè)置靜音，F(xiàn)ALSE為取消靜音?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_GetCurDevMode【函數(shù)原型】PUBLICAUD_DEV_MODE_EMMIAUDIO_GetCurDevMode(void);【函數(shù)功能】該函數(shù)用于獲得當(dāng)前聲音設(shè)備模式?！緟?shù)說明】無。【返回值】當(dāng)前聲音設(shè)備模式，AUD_DEV_MODE_E類型的具體定義參見文檔《AudioService軟件設(shè)計說明書》?！究记绊氈繜o。MMIAUDIO_SetCurDevMode【函數(shù)原型】PUBLICvoidMMIAUDIO_SetCurDevMode(AUD_DEV_MODE_Emode);【函數(shù)功能】該函數(shù)用于設(shè)置當(dāng)前聲音設(shè)備模式?！緟?shù)說明】mode：所要設(shè)置的聲音設(shè)備模式，AUD_DEV_MODE_E類型的具體定義參見文檔《AudioService軟件設(shè)計說明書》。【返回值】無。【考前須知】無。MMIAUDIO_GetIsPlaying【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_GetIsPlaying(void);【函數(shù)功能】該函數(shù)用于判斷當(dāng)前系統(tǒng)是否有audio在播放。【參數(shù)說明】無。【返回值】TRUE：有Audio在播放；FALSE：無Audio在播放?！究记绊氈繜o。MMIAUDIO_GetIsPermitPlay【函數(shù)原型】PUBLICBOOLEANMMIAUDIO_GetIsPermitPlay(MMIAUDIO_HTYPEaudio_htype);【函數(shù)功能】該函數(shù)用于判斷是否允許當(dāng)前Audio的播放。如果此時在通話狀態(tài)，那么需要根據(jù)實際情況來判斷是否允許當(dāng)前Audio的播放。這里只是一個沖突處理的判斷?！緟?shù)說明】audio_htype：所要播放的AudioHandle的類型?！痉祷刂怠縏RUE：允許播放；FALSE：不允許播放。【考前須知】無。MMIAUDIO_GetAudioHtype【函數(shù)原型】PUBLICMMIAUDIO_HTYPEMMIAUDIO_GetAudioHtype(void);【函數(shù)功能】該函數(shù)用于獲取當(dāng)前當(dāng)前播放的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ù)用于獲取當(dāng)前播放的AudioHandle?！緟?shù)說明】audio_htype：當(dāng)前播放的AudioHandle的類型。【返回值】當(dāng)前播放的AudioHandle的指針。【考前須知】無。錄音相關(guān)接口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ù)用于結(jié)束一個錄音操作。主要用于由于異常引起的錄音失敗，需要手動去結(jié)束這個錄音，也就是關(guān)閉開始錄音時翻開的Handle?！緟?shù)說明】無?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_PauseRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseRecord(void);【函數(shù)功能】該函數(shù)用于暫停一個錄音操作?！緟?shù)說明】無。【返回值】無。【考前須知】無。MMIAUDIO_ResumeRecord【函數(shù)原型】PUBLICvoidMMIAUDIO_ResumeRecord(void);【函數(shù)功能】該函數(shù)用于恢復(fù)一個已暫停的錄音操作?！緟?shù)說明】無?！痉祷刂怠繜o?！究记绊氈繜o。背景播放控制接口MMIAUDIO_PauseBgPlay【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlay(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放?！緟?shù)說明】pause_type：需要暫停的背景播放的類型；module：當(dāng)前處理的模塊或事件的類型。【返回值】無?！究记绊氈繜o。MMIAUDIO_PauseBgPlayAndA2dp【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlayAndA2dp(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放，同時暫停藍牙A2DP。【參數(shù)說明】pause_type：需要暫停的背景播放的類型；module：當(dāng)前處理的模塊或事件的類型?！痉祷刂怠繜o?！究记绊氈繜o。MMIAUDIO_PauseBgPlayII【函數(shù)原型】PUBLICvoidMMIAUDIO_PauseBgPlayII(MMIBGPLAY_TYPE_Epause_type,MMIBGPLAY_MODULE_Emodule);【函數(shù)功能】該函數(shù)用于進入某些和背景播放有沖突的模塊時，暫停背景播放。此函數(shù)為：MMIAUDIO_PauseBgPlay和MMIAUDIO_PauseBgPlayAndA2dp的一個合集，當(dāng)平臺支持藍牙A2DP時功能與MMIAUDIO_PauseBgPlayAndA2dp相同，不支持時為MMIAUDIO_PauseBgPlay相同?！緟?shù)說明】pause_type：需要暫停的背