《展讯视频通话模块接口简介.doc》由会员分享，可在线阅读，更多相关《展讯视频通话模块接口简介.doc（23页珍藏版）》请在金锄头文库上搜索。
1、Mocor MMI VT Interface User GuideVersion: 1.0.0DocCode: SW-MOCOR-UG-0006Date: 2008-01-重要声明版权声明本文档中的任何内容受中华人民共和国著作权法的保护，版权所有 2008，展讯通信有限公司，保留所有权利，但注明引用其他方的内容除外。商标声明展讯通信有限公司和展讯通信有限公司的产品是展讯通信有限公司专有。在提及其他公司及其产品时将使用各自公司所拥有的商标，这种使用的目的仅限于引用。不作保证声明展讯通信有限公司不对此文档中的任何内容作任何明示或暗示的陈述或保证，而且不对特定目的的适销性及适用性或者任何间接、特殊或
2、连带的损失承担任何责任。保密声明本文档（包括任何附件）包含的信息是保密信息。接收人了解其获得的本文档是保密的，除用于规定的目的外不得用于任何目的，也不得将本文档泄露给任何第三方。第2章 API函数前 言文档说明本文档描述了VT模块的对外开放的数据类型和接口的具体情况。阅读对象本文档适合与VT模块相关的开发人员使用。内容介绍本文档包括二个章节，分别为： 第一章：数据类型。介绍了VT接口所涉及到的各种数据类型，如枚举、结构等； 第二章：API函数。详细描述了VT接口包含的所有API函数的定义及相关说明。文档约定本文档采用下面醒目标志来表示在操作过程中应该特别注意的地方。注意：提醒操作中应注意的事项
3、。相关文档目 录第1章 数据类型1-11.1 宏定义1-1第2章 API函数2-12.1 MMIAPIVT_ReqVideoModeCall2-12.2 MMIAPIVT_HandlePsMsg2-12.3 MMIAPIVT_OpenCommWin2-22.4 MMIAPIVT_CreateVTSetWin2-22.5 MMIAPIVT_SetVtCallInfo2-32.6 MMIAPIVT_SetFallbackEnable2-32.7 MMIAPIVT_GetFallbackEnable2-42.8 MMIAPIVT_GetIsFallbackCall2-42.9 MMIAPIVT_Cr
4、eateVtMtAnimationWinTimer2-52.10 MMIAPIVT_CloseVtMtAnimationWin2-52.11 MMIAPIVT_IsCauseForFallBack2-62.12 MMIAPIVT_IsOpenCommWin2-72.13 MMIAPIVT_IsCommWinFocus2-72.14 MMIAPIVT_SendMsgToCommWin2-82.15 MMIAPIVT_Init2-82.16 MMIAPIVT_OpenMtAnimationWin2-92.17 MMIAPIVT_SwitchLcdCtrl2-92.18 MMIAPIVT_Close
5、AllVTWin2-102.19 MMIAPIVT_InitModule2-102.20 MMIAPIVT_IsMmrState2-11附录A Revision HistoryA-12-11第1章 数据类型1.1 宏定义常量名取值说明MMI_CALL_TYPE_DATAMN_CALL_TYPE_DATA说明本次通话类型为可视电话第2章 API函数2.1 MMIAPIVT_ReqVideoModeCall【函数原型】voidMMIAPIVT_ReqVideoModeCall (uint8*tele_num, uint8tele_len);【函数功能】发起视频呼叫。【参数说明】tele_num：拨
6、出号码的内容；tele_len：亮度值。【返回值】无。【注意事项】无。2.2 MMIAPIVT_HandlePsMsg【函数原型】BOOLEANMMIAPIVT_HandlePsMsg (uint16msg_id, DPARAMparam);【函数功能】对底层传来的消息进行处理。【参数说明】msg_id：上传消息的ID值；param：与上传消息对应的参数。【返回值】TRUE：该消息处理完毕；FALSE：该消息还需要让CC等其他模块进行处理。【注意事项】该接口通常只由CC模块相应接口进行调用。2.3 MMIAPIVT_OpenCommWin【函数原型】voidMMIAPIVT_OpenCommW
7、in (void);【函数功能】打开VT通讯窗口。【参数说明】无。【返回值】无。【注意事项】无。2.4 MMIAPIVT_CreateVTSetWin【函数原型】voidMMIAPIVT_CreateVTSetWin (void);【函数功能】创建VT设置窗口。【参数说明】无。【返回值】无。【注意事项】无。2.5 MMIAPIVT_SetVtCallInfo【函数原型】voidMMIAPIVT_SetVtCallInfo (MN_CALLED_NUMBER_Tcall_info);【函数功能】设置VT Call的相关信息。【参数说明】call_info：OUT记录VT Call相应的信息的变量
8、。【返回值】无。【注意事项】该接口通常只由CC模块相应接口进行调用。2.6 MMIAPIVT_SetFallbackEnable【函数原型】voidMMIAPIVT_SetFallbackEnable (BOOLEANflag);【函数功能】设置是否开启VT回落功能项的参数值。【参数说明】flag：需要设置的参数值。【返回值】无。【依赖关系】s_mmivt_global_info。【注意事项】该接口通常只由CC模块相应接口进行调用。2.7 MMIAPIVT_GetFallbackEnable【函数原型】BOOLEANMMIAPIVT_GetFallbackEnable (void);【函数功能
9、】获得用是否开启VT回落功能项的参数值。【参数说明】无。【返回值】TRUE：VT回落功能打开；FALSE：VT回落功能关闭。【注意事项】无。2.8 MMIAPIVT_GetIsFallbackCall【函数原型】BOOLEANMMIAPIVT_GetIsFallbackCall (void);【函数功能】判断该通电话是否是VT回落的语音电话。【参数说明】无。【返回值】TRUE：为回落电话；FALSE：为普通语音电话。【依赖关系】s_isneedfallback。【注意事项】该接口和参数s_isneedfallback不推荐使用，未来版本会做相应修改。2.9 MMIAPIVT_CreateVtM
10、tAnimationWinTimer【函数原型】uint8MMIAPIVT_CreateVtMtAnimationWinTimer (uint32timeout);【函数功能】创建VT来电窗口的计数器。【参数说明】timeout：对应计数值。【返回值】产生的计数器的ID值。【注意事项】该接口通常只由CC模块相应接口进行调用。2.10 MMIAPIVT_CloseVtMtAnimationWin【函数原型】BOOLEANMMIAPIVT_CloseVtMtAnimationWin (void);【函数功能】关闭VT来电窗口。【参数说明】无。【返回值】TRUE：窗口关闭成功；FALSE：窗口关闭失
11、败。【注意事项】该接口通常只由CC模块相应接口进行调用。2.11 MMIAPIVT_IsCauseForFallBack【函数原型】MMI_RESULT_E MMIAPIVT_IsCauseForFallBack (MN_CALL_DISCONNECT_CALL_CAUSE_Ecause);【函数功能】底层传来MN_CALL_DISCONNECTED_IND消息之后，根据原因值判断是否是回落原因值。【参数说明】cause：电话断开消息所对应的原因值。【返回值】MMI_RESULT_TRUE：是回落原因值；MMI_RESULT_FALSE：不是回落原因值。【注意事项】无。2.12 MMIAPIV
12、T_IsOpenCommWin【函数原型】MMI_RESULT_EMMIAPIVT_IsOpenCommWin (void);【函数功能】判断VT通讯窗口是否打开。【参数说明】无。【返回值】MMI_RESULT_TRUE：VT通讯窗口已经打开；MMI_RESULT_FALSE：VT通讯窗口没有打开。【注意事项】无。2.13 MMIAPIVT_IsCommWinFocus【函数原型】BOOLEANMMIAPIVT_IsCommWinFocus (void);【函数功能】判断VT通讯窗口是否是焦点窗口。【参数说明】无。【返回值】MMI_RESULT_TRUE：VT通讯窗口是焦点窗口；MMI_RES
13、ULT_FALSE：VT通讯窗口不是焦点窗口。【注意事项】无。2.14 MMIAPIVT_SendMsgToCommWin【函数原型】BOOLEANMMIAPIVT_SendMsgToCommWin (MMI_MESSAGE_ID_Emsg_id, DPARAMparam);【函数功能】向VT通讯窗口发送消息。【参数说明】msg_id：所要发送消息的ID值；param：与所要发送消息对应的参数。【返回值】TRUE：消息发送成功；FALSE：消息发送失败。【注意事项】无。2.15 MMIAPIVT_Init【函数原型】voidMMIAPIVT_Init (void);【函数功能】开机的时候处理V
14、T的相关信息，设置4个默认图片的信息。【参数说明】无。【返回值】无。【注意事项】无。2.16 MMIAPIVT_OpenMtAnimationWin【函数原型】voidMMIAPIVT_OpenMtAnimationWin (void);【函数功能】打开VT来电画面。【参数说明】无。【返回值】无。【注意事项】无。2.17 MMIAPIVT_SwitchLcdCtrl【函数原型】MMI_RESULT_EMMIAPIVT_SwitchLcdCtrl (BOOLEANis_arm_control);【函数功能】切换LCD的控制权。【参数说明】is_arm_control：TRUE表示由ARM控制LCD；FALSE表示由8602控制LCD。【返回值】TRUE：该命令已经发给8602控制模块；FALSE：该命令没有发给8602控制模块。【注意事项】该接口通
