BREW开发第十六章ITAPI.pptVIP

主要内容 获取状态信息以及进入或正在呼叫的主叫号码 安排语音呼叫 短消息的提取和发送 BREW短消息 呼叫状态 呼叫状态的信息可以通过ITAPI_GetStatus()获得，所得到的信息存储在数据结构TAPIStatus中 typedef structure { char szMobileID[MOBILE_ID_LEN +1]; PhoneState state; flg bData:1; flg bDigital:1; flg bRoaming:1; flg bCallEnded:1; flg bE911CallbackMode:1; flg bRestricted:1; flg bRegistered:1; flg bDormancy:1; } TAPIStatus; 设备的状态 PhoneState 用于 ITAPI_GetStatus()，以获取设备的当前状态。 它是 TAPIStatus 数据结构中的一个成员，该结构将由 ITAPI_GetStatus() 函数填充。 typedef enum { PS_OFFLINE, PS_IDLE, PS_INCOMING, PS_ORIG, PS_CONVERSATION } PhoneState; 呼叫相关的用户信息 获取进入或外发语音呼叫的用户号码 通过ITAPI_GetCallerID()得到 获得设备的 IMSI/MIN ITAPI_GetStatus() 返回的 TAPIStatus 结构中的 szMobileID - 所有 BREW SDK 版本。 设备项目 AEE_DEVICEITEM_MOBILE_ID 的 ISHELL_GetDeviceInfoEx() - BREW SDK 2.1 以上 呼叫状态发生变化时的通知 ITAPI_OnCallStatus()方法用于注册回调函数，当呼叫状态发生变化时， BREW 将调用该回调函数。 它支持用于指定应用程序所关注呼叫状态类型的标记 int ITAPI_OnCallStatus ( ITAPI * pITAPI, PFNNOTIFY pfn, void * pUser, uint32 dwDelay, uint16 wFlags ) 语音呼叫的特点 ITAPI_MakeVoiceCall()方法用于安排语音呼叫 拨叫的号码通过数字字符串指定。 如果输入的是空串或NULL，则不安排呼叫 只允许使用以下数字：0-9、#、*。其它数字均将忽略 如果正在进行语音呼叫，则返回 EALREADY 如果正在进行数据呼叫但是没有网络活动 (TCP)，则结束数据呼叫而安排语音呼叫。 该函数可以实现运营商确立的保密策略， 其中包括以对话框方式提供给用户的中间提示 语音呼叫的事件流程 向用户显示对话框。 清除对话框时，将事件 EVT_DIALOG_END 发送至应用程序。 此时，应用程序必须刷新屏幕。 如果用户同意安排呼叫，则将事件 EVT_APP_SUSPEND 发送至应用程序。 呼叫完成时，将事件 EVT_APP_RESUME 发送至应用程序。 应用程序必须刷新屏幕。 普通短消息的接收 使用 MIF Editor （或使用 ISHELL_RegisterNotify()）注册 AEECLSID_TAPI 类的NMASK_TAPI_SMS_TEXT 通知。 当入局 SMS 文本消息进入系统时，向应用程序发送 EVT_NOTIFY 事件，其中， dwParam 指向的 AEENotify 结构的 pData 将指向 AEESMSMsg 结构。 将此结构传至 ITAPI_ExtractSMSText()，以提取消息的格式化文本部分。 AEESMSTextMsg * ITAPI_ExtractSMSText ( ITAPI * pITAPI, const AEESMSMsg * pMsg ) 普通短消息的发送 用BREW的ITAPI_SendSMS()函数来发送中／英文短消息。ITAPI_SendSMS()函数的原形如下 int ITAPI_SendSMS ( ITAPI *pITapi, const char * pszDst, const char * pszMsg, AEECLSID clsDst, PFNSMSSTATUS pfn, void *pUser ) 普通短消息的发送示例 英文短消息 ITAPI_SendSMS(pITapi, 8581112222, Hello World, 0, MyMOSMSNotify, pMe); 中文短消息: AECHAR w_string[]= { 0x4F60, 0x597D,0x4e2D,0x56FD, ‘\0’}; //你好中国