《展讯音频接口简介》由会员分享，可在线阅读，更多相关《展讯音频接口简介（47页珍藏版）》请在金锄头文库上搜索。
1、Mocor MMI Audio Interface User Guide Version:1.0.0 DocCode:SW-MOCOR-UG-0003 Date:2008-02-18 名师资料总结-精品资料欢迎下载-名师精心整理-第 1 页，共 47 页 -名师资料总结-精品资料欢迎下载-名师精心整理-第 2 页，共 47 页 -重要声明版权声明本文档中的任何内容受中华人民共和国著作权法的保护，版权所有?2008，展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。商标声明展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及其他公司及其产品时将使用各自公司所拥有的商标
2、，这种使用的目的仅限于引用。不作保证声明展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或连带的损失承担任何责任。保密声明本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。名师资料总结-精品资料欢迎下载-名师精心整理-第 3 页，共 47 页 -名师资料总结-精品资料欢迎下载-名师精心整理-第 4 页，共 47 页 -前言文档说明本文档为 MMI Audio模块的接口文档，详细描述了本模块提供给其他MMI 模块的 API 接口。阅
3、读对象本文档适合MMI 软件开发人员和相关客户开发人员使用。内容介绍本文档包括三个章节，分别为：第一章：模块的总体结构。简单介绍了MMI AUDIO模块的功能结构；第二章：数据类型。介绍了涉及的数据结构。第三章：提供给其他模块的接口。介绍了MMI AUDIO模块提供给外部模块的接口函数。文档约定本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意：提醒操作中应注意的事项。说明：说明比较重要的事项。相关文档软件设计说明书_Audio 部分名师资料总结-精品资料欢迎下载-名师精心整理-第 5 页，共 47 页 -AudioService 软件设计说明书。名师资料总结-精品资料欢迎下载-
4、名师精心整理-第 6 页，共 47 页 -i-目录第 1章 概述.1-11.1 模块总体框架及概述.1-1 1.2 支持的 Audio 类型.1-2 第 2章 数据类型.2-12.1 枚举 .2-1 2.1.1 MMIAUDIO_HTYPE.2-1 2.1.2 MMIAUDIO_TYPE_E.2-1 2.1.3 MMIAUDIO_RESULT.2-3 2.1.4 MMIBGPLAY_MODULE_E.2-4 2.1.5 MMIBGPLAY_TYPE_E.2-7 2.2 回调函数 .2-7 2.2.1 MMIAUDIO_END_CALLBACK_PFUNC.2-7 第 3章 提供给其他模块的接口
5、.3-13.1 播放相关接口 .3-1 3.1.1 MMIAUDIO_Init.3-1 3.1.2 MMIAUDIO_CreateAudioBufHandle.3-1 3.1.3 MMIAUDIO_CreateA2dpAudioBufHandle.3-2 3.1.4 MMIAUDIO_CreateAudioFileHandle.3-3 3.1.5 MMIAUDIO_CreateA2dpAudioFileHandle.3-4 3.1.6 MMIAUDIO_CloseAudioHandle.3-5 3.1.7 MMIAUDIO_AudioPlay.3-5 3.1.8 MMIAUDIO_AudioS
6、top.3-6 3.1.9 MMIAUDIO_AudioPause.3-6 3.1.10 MMIAUDIO_AudioResume.3-7 3.1.11 MMIAUDIO_AudioSeek.3-7 3.1.12 MMIAUDIO_PlayTone.3-8 3.1.13 MMIAUDIO_StopTone.3-9 3.1.14 MMIAUDIO_AudioGetFileInfo.3-9 名师资料总结-精品资料欢迎下载-名师精心整理-第 7 页，共 47 页 -ii-3.1.15 MMIAUDIO_AudioGetPlayingFileInfo.3-10 3.1.16 MMIAUDIO_Audi
7、oSetSpeed.3-11 3.1.17 MMIAUDIO_SetEQMode.3-11 3.1.18 MMIAUDIO_GetCurVolume.3-12 3.1.19 MMIAUDIO_SetVolume.3-12 3.1.20 MMIAUDIO_SetMute.3-13 3.1.21 MMIAUDIO_GetCurDevMode.3-13 3.1.22 MMIAUDIO_SetCurDevMode.3-14 3.1.23 MMIAUDIO_GetIsPlaying.3-14 3.1.24 MMIAUDIO_GetIsPermitPlay.3-15 3.1.25 MMIAUDIO_Get
8、AudioHtype.3-15 3.1.26 MMIAUDIO_GetAudioHandle.3-16 3.2 录音相关接口 .3-17 3.2.1 MMIAUDIO_StartRecord.3-17 3.2.2 MMIAUDIO_StopRecord.3-17 3.2.3 MMIAUDIO_EndRecord.3-18 3.2.4 MMIAUDIO_PauseRecord.3-18 3.2.5 MMIAUDIO_ResumeRecord.3-19 3.3 背景播放控制接口.3-19 3.3.1 MMIAUDIO_PauseBgPlay.3-19 3.3.2 MMIAUDIO_PauseBgP
9、layAndA2dp.3-20 3.3.3 MMIAUDIO_PauseBgPlayII.3-20 3.3.4 MMIAUDIO_ResumeBgPlay.3-21 3.3.5 MMIAUDIO_StopBgPlay.3-22 3.3.6 MMIAUDIO_InitBgPlay.3-22 3.3.7 MMIAUDIO_Vibrate.3-23 3.3.8 MMIAUDIO_HandleVibratorTimer.3-23 3.3.9 MMIAUDIO_IsBgPlayPaused.3-24 3.3.10 MMIAUDIO_IsPermitPlayNewMsgRing.3-24 3.3.11 M
10、MIAUDIO_HandleNewMsgRing.3-25 3.3.12 MMIAUDIO_HandleNewMsgKey.3-25 名师资料总结-精品资料欢迎下载-名师精心整理-第 8 页，共 47 页 -iii-附录 A Revision History.A-1名师资料总结-精品资料欢迎下载-名师精心整理-第 9 页，共 47 页 -名师资料总结-精品资料欢迎下载-名师精心整理-第 10 页，共 47 页 -1-1 第1章 概述1.1 模块总体框架及概述图 1-1为 Audio Service 模块的系统结构框图，图中虚线框内的模块为Audio Service MMI 的范畴。其中Audi
11、o MMI通过调用Audio API，以及通过处理Audio Service 反馈给 MMI 的一些 confirm、negative confirm、ind 等消息，实现与Audio Service 的交互。Audio app handleAudio player handleAudio normal handleMMI/APPAudio APIH/W DeviceAudio Service图 1-1 模块框架图所有有关 Audio 的操作，均由Audio Service 完成，而对于MMI 来说，则是需要去创建以及控制相关的Audio Handle，包括 play、pause、resume
12、、stop 等操作。根据 Audio Service 的冲突处理，系统中存在的所有Audio，有可能需要打开多个Audio Handle，而每个 Audio Handle 的实现都需要各自的资源，如 CODEC、device以及 Track Buffer（内存）等等，此外Audio Handle 还存在 Buffer 以及 File 的两名师资料总结-精品资料欢迎下载-名师精心整理-第 11 页，共 47 页 -Mocor MMI Audio Interface User Guide 1-2种情况。为了使Audio Handle 不发生冲突并且又使用较少的内存，在实现时，具体分为以下3 个应用
13、。MMIAUDIO_APP（Audio 的具体应用，包括来电、message、闹钟、日程表、备忘录、拍照的铃声、power，以及包括预览铃声）；MMIAUDIO_PLAYER（Audio 播放器，可能以后需要实现这个Audio 播放器）；MMIAUDIO_NORMAL（Audio 一般应用，包括keytone、flip 等等）。其中MMIAUDIO_APP的优先级最高，其次是MMIAUDIO_PLAYER，最后是MMIAUDIO_NORMAL。也就是说高优先级的Handle 可以去打断低优先级的Handle；而同一级别中，后来的Handle，也可以打断前面的Handle。不过由于通话中的特殊情
14、况，在使用时需要先额外去判断时候打断前面的Handle。MMI Audio 模块通过对Audio Service 提供的接口进行封装，构建了MMI Audio相关的整体控制框架，并向MMI 各应用模块提供所有有关Audio 的操作接口，包括创建 handle、play、pause、resume、stop 等操作。1.2 支持的 Audio 类型由于目前存在太多的媒体类型，而且每种类型又存在各种各样的文件类型，所以需要用户自行去控制播放音乐的类型。Audio Service 中支持的Audio 的类型参见MMIAUDIO_TYPE_E定义。名师资料总结-精品资料欢迎下载-名师精心整理-第 12
15、页，共 47 页 -2-1 第2章 数据类型2.1 枚举2.1.1 MMIAUDIO_HTYPE【含义】MMIAUDIO_HTYPE定义了 MMI 具体应用的handle 类型。【定义】typedef enum MMIAUDIO_NONE,MMIAUDIO_APP,MMIAUDIO_PLAYER,MMIAUDIO_NORMAL,MMIAUDIO_MAX MMIAUDIO_HTYPE;【参数说明】参数名称含义MMIAUDIO_NONE 初始化类型MMIAUDIO_APP Audio 的具体应用，包括来电、message、闹钟、日程表、备忘录、拍照的铃声、power，以及包括预览铃声等MMIAUD
16、IO_PLAYER Audio 播放器MMIAUDIO_NORMAL Audio 一般应用，包括keytone、flip 等MMIAUDIO_MAX 系统保留，不可使用2.1.2 MMIAUDIO_TYPE_E【含义】MMIAUDIO_TYPE_E定义了各类音频格式。名师资料总结-精品资料欢迎下载-名师精心整理-第 13 页，共 47 页 -Mocor MMI Audio Interface User Guide 2-2【定义】typedef enum MMIAUDIO_MIDI,MMIAUDIO_GENERIC_TONE,MMIAUDIO_CUSTOM_TONE MMIAUDIO_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_MIDI MIDI 音乐格式MMIAU
