Mocor MMI Multim Interface User Guide文档格式.docx

Mocor MMI Multim Interface User Guide文档格式.docx

《Mocor MMI Multim Interface User Guide文档格式.docx》由会员分享，可在线阅读，更多相关《Mocor MMI Multim Interface User Guide文档格式.docx（18页珍藏版）》请在冰豆网上搜索。

文档约定

本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。

注意：

提醒操作中应注意的事项。

相关文档

无。

目录

第1章模块的总体结构1-1

1.1模块总体框架1-1

1.2模块功能概述1-1

第2章数据类型2-1

2.1枚举2-1

2.1.1MMIAUDIO_TYPE_E2-1

2.1.2MMIMULTIM_MUSIC_TYPE_E2-2

2.1.3MMIMULTIM_DEVICE_TYPE_E2-3

第3章提供给其他模块的接口3-1

3.1初始化接口3-1

3.1.1MMIAPIMULTIM_Init3-1

3.1.2MMIAPIMULTIM_InitModule3-1

3.2其它接口3-2

3.2.1MMIAPIMULTIM_FileNameIsValid3-2

3.2.2MMIAPIMULTIM_GetMusicType3-2

3.2.3MMIAPIMULTIM_GetNameAndSuffix3-3

3.2.4MMIAPIMULTIM_OpenSelectMovieWin3-4

3.2.5MMIAPIMULTIM_CloseSelectMovieWin3-5

3.2.6MMIAPIMULTIM_OpenSelectMusicWin3-5

3.2.7MMIAPIMULTIM_CloseSelectMusicWin3-6

3.2.8MMIAPIMULTIM_PlayMusicFile3-6

3.2.9MMIAPIMULTIM_CloseSelectPictureWin3-7

3.2.10MMIAPIMULTIM_InitWallPaper3-8

3.2.11MMIAPIMULTIM_IsWallPaperFile3-8

3.2.12MMIAPIMULTIM_SetPictureToWallpaper3-9

3.2.13MMIAPIMULTIM_CloseWin3-9

3.2.14MMIAPIMULTIM_DoFileOperat3-10

3.2.15MMIAPIMULTIM_OpenFileListWin3-10

3.2.16MMIAPIMULTIM_PostMsgFileOptWin3-11

3.2.17MMIAPIMULTIM_StopOperaSDPlug3-11

第一章模块的总体结构

一.1模块总体框架

总体结构图如图11所示。

图11MULTIM模块在总体结构中的位置

一.2模块功能概述

MULTIM模块主要是提供其他模块访问图片、音乐、视频文件的接口，主要功能有：

•浏览：

浏览图片或音乐或视频；

•发送：

将多媒体内容作为MMS发送；

•删除：

删除一条图片/音乐或所有图片/音乐；

•设为：

将图片设为墙纸或将音乐设为来电铃声；

•重命名；

•详情：

查看一条图片/音乐的详细情况；

•下载；

保存下载铃声；

第二章数据类型

二.1枚举

二.1.1MMIAUDIO_TYPE_E

【含义】

MMIAUDIO_TYPE_E定义了音频类型。

【定义】

typedefenum

{

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音乐格式

MMIAUDIO_GENERIC_TONE

GenericTone

MMIAUDIO_CUSTOM_TONE

CustomTone

MMIAUDIO_DTMF_TONE

DTMFTone

MMIAUDIO_SMAF

SMAF音乐格式

MMIAUDIO_WAVE

WAV文件

MMIAUDIO_MP3

MP3类型

MMIAUDIO_WMA

WMA类型

MMIAUDIO_AMR

AMR类型

MMIAUDIO_ADPCM

ADPCM格式

MMIAUDIO_PCM

PCM格式

MMIAUDIO_AAC

AAC类型

MMIAUDIO_M4A

M4A格式

系统保留，不可使用

二.1.2MMIMULTIM_MUSIC_TYPE_E

MMIMULTIM_MUSIC_TYPE_E定义了下载铃声类型。

MMIMULTIM_MUSIC_NO_TYPE,

MMIMULTIM_TYPE_MIDI,

MMIMULTIM_TYPE_MID,

MMIMULTIM_TYPE_MMF,

MMIMULTIM_TYPE_SMAF,

MMIMULTIM_TYPE_WAV,

MMIMULTIM_TYPE_MP3,

MMIMULTIM_TYPE_WMA,

MMIMULTIM_TYPE_AMR,

MMIMULTIM_TYPE_AAC,

MMIMULTIM_TYPE_M4A,

MMIMULTIM_TYPE_MP4,

MMIMULTIM_TYPE_3GP,

MMIMULTIM_MAX_MUSIC_TYPE_NUM

}MMIMULTIM_MUSIC_TYPE_E;

MMIMULTIM_MUSIC_NO_TYPE

无类型

MMIMULTIM_TYPE_MIDI

MIDI类型

MMIMULTIM_TYPE_MID

MMIMULTIM_TYPE_MMF

MMF类型

MMIMULTIM_TYPE_SMAF

SMAF类型

MMIMULTIM_TYPE_WAV

WAV类型

MMIMULTIM_TYPE_MP3

MMIMULTIM_TYPE_WMA

MMIMULTIM_TYPE_AMR

MMIMULTIM_TYPE_AAC

MMIMULTIM_TYPE_M4A

M4A类型

MMIMULTIM_TYPE_MP4

MP4类型

MMIMULTIM_TYPE_3GP

3GP类型

音乐的类型总数

二.1.3MMIMULTIM_DEVICE_TYPE_E

MMIMULTIM_DEVICE_TYPE_E定义了存储设备类型

typedefenum

MMIMULTIM_DEVICE_NULL,

MMIMULTIM_UDISK_ONLY,

MMIMULTIM_SD_ONLY,

MMIMULTIM_DEVICE_ALL,

MMIMULTIM_DEVICE_MAX

}MMIMULTIM_DEVICE_TYPE_E;

MMIMULTIM_DEVICE_NULL

无存储设备

MMIMULTIM_UDISK_ONLY

U盘

MMIMULTIM_SD_ONLY

SD卡

MMIMULTIM_DEVICE_ALL

U盘和SD卡

设备类型最大值

第三章提供给其他模块的接口

三.1初始化接口

三.1.1MMIAPIMULTIM_Init

【函数原型】

voidMMIAPIMULTIM_Init（void）;

【函数功能】

该函数用于开机初始化，创建Picture、Music、Movie目录，初始化墙纸。

【返回值】

【注意事项】

三.1.2MMIAPIMULTIM_InitModule

voidMMIAPIMULTIM_InitModule（void）

该函数用于初始化Multim模块。

三.2其它接口

三.2.1MMIAPIMULTIM_FileNameIsValid

BOOLEANMMIAPIMULTIM_FileNameIsValid（

TEXTEDIT_STRING_INFO_T*file_name_ptr

）;

判断文件名是否有效。

file_name_ptr：

文件名结构指针。

TRUE：

有效；

FALSE：

无效。

三.2.2MMIAPIMULTIM_GetMusicType

MMIAUDIO_TYPE_EMMIAPIMULTIM_GetMusicType（

uint8*file_name_ptr,

uint16name_len

获得音频文件类型。

文件名数据指针；

name_len：

文件名长度。

MMIAUDIO_TYPE_E。

三.2.3MMIAPIMULTIM_GetNameAndSuffix

voidMMIAPIMULTIM_GetNameAndSuffix（

uint16*name_suffix_ptr,

uint16name_suffix_len,

MMI_STRING_T*name_ptr,

MMI_STRING_T*suffix_ptr

获得没有后缀名的文件名称，以及后缀名。

name_suffix_ptr：

输入的文件名指针

name_suffix_len：

输入文件名的长度

name_ptr：

输出不带后缀名的文件名指针

suffix_ptr：

输出后缀名指针

三.2.4MMIAPIMULTIM_OpenSelectMovieWin

BOOLEANMMIAPIMULTIM_OpenSelectMovieWin（

MMIMULTIM_DEVICE_TYPE_Eselect_device,

uint32select_movie,

uint32max_size,

BOOLEANis_need_data,

MMI_WIN_ID_Twin_id,

uint8*ticked_file,

uint16cked_file_len

）;

打开视频列表窗口。

select_device：

选择设备；

select_movie：

视频类型；

max_size：

允许的最大moviesize；

is_need_data：

是否需要返回数据；

win_id：

窗口ID；

ticked_file：

需要打勾的文件名；

ticked_file_len：

需要打勾的文件名长度。

成功；

失败。

窗口的选项少，主要用于设置和彩信。

三.2.5MMIAPIMULTIM_CloseSelectMovieWin

voidMMIAPIMULTIM_CloseSelectMovieWin（void）;

关闭视频列表窗口和视频选项窗口。

三.2.6MMIAPIMULTIM_OpenSelectMusicWin

BOOLEANMMIAPIMULTIM_OpenSelectMusicWin（

MMIMULTIM_DEVICE_TYPE_Eselect_device,

uint32select_music,

uint16ticked_file_len

打开音频列表窗口。

音频类型；

窗口的选项少。

三.2.7MMIAPIMULTIM_CloseSelectMusicWin

voidMMIAPIMULTIM_CloseSelectMusicWin（void）;

关闭音频列表窗口。

三.2.8MMIAPIMULTIM_PlayMusicFile

BOOLEANMMIAPIMULTIM_PlayMusicFile（

MMIAUDIO_HTYPEhandle_type,

uint8*full_path_ptr,

uint16full_path_len,

uint32play_times,

uint32vol,

MMIAUDIO_END_CALLBACK_PFUNCcall_back

播放音频文件。

handle_type：

handle类型；

full_path_ptr：

文件全路径名指针；

full_path_len：

文件全路径名长度；

play_times：

播放次数；

vol：

播放音量；

call_back：

播放完的回调函数。

三.2.9MMIAPIMULTIM_CloseSelectPictureWin

voidMMIAPIMULTIM_CloseSelectPictureWin（void）;

关闭图片列表窗口。

三.2.10MMIAPIMULTIM_InitWallPaper

voidMMIAPIMULTIM_InitWallPaper（void）;

从NV中读取墙纸信息。

三.2.11MMIAPIMULTIM_IsWallPaperFile

BOOLEANMMIAPIMULTIM_IsWallPaperFile（

uint8*full_path_ptr,

uint16full_path_len

判断输入文件是否是墙纸。

全路径名指针；

全路径名长度；

是；

不是。

三.2.12MMIAPIMULTIM_SetPictureToWallpaper

BOOLEANMMIAPIMULTIM_SetPictureToWallpaper（

设置图片为墙纸。

三.2.13MMIAPIMULTIM_CloseWin

voidMMIAPIMULTIM_CloseWin（void）;

关闭Multim模块所有相关窗口。

三.2.14MMIAPIMULTIM_DoFileOperat

BOOLEANMMIAPIMULTIM_DoFileOperat（void）;

该函数用于当前是否对文件进行操作。

三.2.15MMIAPIMULTIM_OpenFileListWin

voidMMIAPIMULTIM_OpenFileListWin（

MMIMULTIM_FILE_TYPE_Efile_type,

uint32file_format

打开对应类型的文件列表窗口。

file_type：

需要打开文件列表的类型；

file_format：

文件格式。

打开窗口后，左软键（选项）选择项多。

三.2.16MMIAPIMULTIM_PostMsgFileOptWin

PUBLICvoidMMIAPIMULTIM_PostMsgFileOptWin（

MMI_MESSAGE_ID_Emsg_id,

DPARAMparam

该函数用于向对应文件类型窗口发送消息。

msg_id：

要发送的消息ID；

param：

参数。

三.2.17MMIAPIMULTIM_StopOperaSDPlug

voidMMIAPIMULTIM_StopOperaSDPlug（void）;

附录A附录ARevisionHistory

Version

Date

Owner

Notes

1.0.0

2008-03-03

Vincent.shang

Created