Call模块快速上手指南.docVIP

Call模块快速上手指南 关于call模块的设计文档可以在服务器上(\Documents\MTK\From MTK\MMI\MMI_Features)，这里笔者就不做重复劳动了，主要从实际的项目开发角度讲一讲call模块的开发。 首先，从大的概念上来说call模块维护了一个状态机，伴随着不同的action在不同状态（idle，active，hold，outgoing，incoming）之间翻转，这里的action指的是1.来自协议层的异步事件，比如说MSG_ID_MMI_CC_CALL_RING_IND这个消息就是协议层通知mmi有一个来电发生了，mmi这时候就会进行相应的状态翻转（idle ( incoming）,并做出界面上的显示，以达到和用户交互的作用。2.用户发起服务请求后，来自协议层的回馈消息，比如说来电后用户按接听键就会给协议层发一个 MSG_ID_MMI_CC_ATA_REQ请求，协议层响应此请求成功后，就回给mmi层一个MSG_ID_MMI_CC_ATA_RSP消息，此时mmi就会又一次进行状态的翻转（incoming ( active），此时屏幕也将由来电窗口进入通话窗口。 在实际开发中修改的最多就是ucmui.c，ucmacthdlr.c了，ucmui.c里面几乎囊括了所有与界面显示相关的函数，其中最重要就是mmi_ucm_entry_incoming_call（来电），mmi_ucm_entry_outgoing_call（去电），mmi_ucm_entry_in_call（通话中），因为是做的mmi的嘛，所以界面上的修改大部分都集中在这三个函数里。Ucmacthdlr.c里主要是处理来自协议层的消息，发负责消息的派发以及逻辑上的处理，下面再详细讲解。 另外有些常用的函数如下： isInCall(void); 这个函数通常被其他模块调用来判断是否有电话业务存在 mmi_ucm_app_total_call(mmi_ucm_call_type_enum call_type) 这个函数通常用来判断当前是否是单个电话 mmi_ucm_conference_option(void) 这个函数用来判断当前是否是电话会议状态 MakeCall(PS8 strNumber) 单卡向外拨打电话的接口 mmi_ucm_app_entry_dial_option(U8 *num_uri, mmi_ucm_callback_func_ptr callback_after_dial, void* callback_para) 双卡向外拨打电话的接口，它会显示一个sim卡选择窗口 mmi_ucm_app_active_call(mmi_ucm_call_type_enum call_type) 当前处于激活状态的电话有多少个 mmi_ucm_app_held_call(mmi_ucm_call_type_enum call_type) 当前处于保持状态的电话有多少个 mmi_ucm_ring_ind(void *act_struct) 来电消息处理的地方 mmi_ucm_connect_ind(void *act_struct) 接通消息处理的地方 mmi_ucm_release_ind(void *act_struct) 当有电话挂断处理的地方 mmi_ucm_alert_ind(void *act_struct) 拨号成功，对方提示播回铃音的地方 mmi_ucm_accept_act_rsp(void *act_struct) 接通来电处理的地方 dt_update_duration(void) 通话过程中计时处理的地方 mmi_ucm_log_call_history(S32 group_index, S32 call_index, MMI_BOOL is_connect)