BREW开发第十八章铃音管理接口.pptVIP

主要内容 铃音格式介绍 IRingerMgr接口用法 IRingerMgr接口概览 铃音格式介绍 常见格式 MIDI/CMX/SMAF/QCP/MP3/ … 手机差异性 格式支持情况 OEM铃音格式头文件 IRingerMgr接口用法 IRingerMgr接口使用步骤 设置MIF权限 引用AEERinger.h头文件 以AEECLSID_RINGERMGR调用ISHELL_ CreateInstance ()创建接口指针 IRINGERMGR_RegisterNotify()注册回调函数 铃音操作（创建，设置，删除 …） 释放铃音接口 IRingerMgr接口概览 int IRINGERMGR_Create(IRingerMgr * pIRingerMgr, const AECHAR * pszName, AEESoundPlayerFile format, IAStream * ps); typedef enum { AEE_SOUNDPLAYER_FILE_UNKNOWN, AEE_SOUNDPLAYER_FILE_MIDI, AEE_SOUNDPLAYER_FILE_MP3, AEE_SOUNDPLAYER_FILE_LAST } AEESoundPlayerFile; IRingerMgr接口概览 IRINGERMGR_EnumCategoryInit() IRINGERMGR_EnumNextCategoryInit() 枚举铃音目录 IRINGERMGR_EnumRingerInit() IRINGERMGR_EnumNextRinger() 枚举铃音 IRINGERMGR_GetNumberFormats() IRINGERMGR_GetFormats() 获取手机支持铃音格式 IRingerMgr接口概览 IRINGERMGR_GetRingerID() 由铃音文件命获得铃音ID IRINGERMGR_GetRingerInfo() 根据铃音ID获得铃音信息 typedef struct _AEERingerInfo { AEERingerID id; AEESoundPlayerFile format; char szFile[MAX_FILE_NAME]; AECHAR szName[MAX_RINGER_NAME]; } AEERingerInfo; IRingerMgr接口概览 IRINGERMGR_Play() 播放特定ID铃音 IRINGERMGR_PlayEx() 根据铃音ID播放 根据文件名播放 从铃音流播放 IRINGERMGR_PlayFile() 从文件播放铃音 IRINGERMGR_PlayStream() 从流播放铃音 IRingerMgr接口概览 IRINGERMGR_Stop() 停止播放铃音 IRINGERMGR_RegisterNotify() typedef void ( * PFNRINGEREVENT) ( void * pUser, AEERingerEvent evt, uint32 dwParm, int nErr); AEERingerEvent ARE_NONE, ARE_PLAY, ARE_CREATE, ARE_WRITE IRINGERMGR_Remove() 根据铃音ID删除铃音 IRINGERMGR_SetRinger() 根据铃音ID设置某一铃音分组的默认铃音 本章关键点 铃音格式介绍 IRingerMgr接口的使用方法 IRingerMgr接口说明 问题回顾 BREW支持哪些铃音？ IRingerMgr接口的使用方法？ 如何得到手机支持的铃音格式？ 如何创建一个铃音? * * BREWTM Developer Training 第十八章 铃音管理接口 Instructor notes: 创建操作为异步，因此无法立刻得到创建的ringer ID, 可以通过IRINGERMGR_RegisterNotify()函数注册回调函数获取创建成功的ringer ID。 * *