摘要
本文介绍了BREW短消息的另一种用途,用户可以通过发送一条基于BREW的特定格式的短信,来启动手机的某一个BREW应用。BREW应用开发商可以采用本文提供的方法可以灵活地实现各种对BREW应用程序的远程启动功能;例如新闻订阅、通知、提醒,天气预报提示等等。
关键字 BREW, SMS, 短消息,ITAPI
BREW特定短信的发送和接收过程的底层实现机制
BREW定义了一种特定的短消息格式来启动应用程序。BREW把这种格式的短消息称为BREW特定应用消息(BREW application-directed message),即这种特殊的短消息是发送给某一个特定的BREW应用程序的。为方便起见,以下文中我们统称之为BREW短信,以区别普通短信。
BREW短信的格式如下:
//BREW:
:
其中:
//BREW——消息头,表示本短信为BREW短信;
Class ID——表示接收短信的应用程序的Class ID 号;
Text Payload——附加的消息文本,ASCII格式;
例如:
//BREW:01009FF0:test
//BREW:0x01009FF0:Hello world
BREW短信的发送非常简单。和发送普通短信一样,调用ITAPI_SendSMS()函数发送就可以了。例如:
ITAPI_SendSMS(pMe->m_pITAPI,”13331016512”,”//BREW:0x01009FF0:Hello world”, 0, (PFNSMSSTATUS)MySmsNotify, pMe);
BREW短信的接收过程如下:
1. BREW手机的底层软件首先截获短消息,判断消息头是否为 //BREW;
2. 如果判断是BREW短信,则启动BREW应用管理器;
3. BREW应用管理器根据收到的Class ID加载对应的BREW应用程序,并完成该应用程序的初始化工作;
4. BREW应用管理器发送EVT_APP_MESSAGE事件给应用程序;
5. 应用程序的HandleEvent()函数处理EVT_APP_MESSAGE事件,如果需要启动应用,则调用ISHELL_StartApplet()函数来启动;或者也可以“悄悄地”进行处理而不用启动应用程序。
通过以上的描述我们知道,BREW应用管理器是通过发送EVT_APP_MESSAGE来唤醒应用程序的,所以应用程序必须处理EVT_APP_MESSAGE才能接收BREW短信,才能完成程序的启动。具体例子如下:
……
case EVT_APP_MESSAGE:
//start up applet
ISHELL_StartApplet(pMe->a.m_pIShell,
AEECLSID_HELLOWORLD);
return TRUE;
……
注意:代码中的 return TRUE 语句是必须要加上的。
如果应用程序想得到BREW短信的文本信息,可以通过EVT_APP_MESSAGE事件的dwParam参数来得到。即参数dwParm的内容实际上是指向Text Payload消息体的指针。具体例子如下:
case EVT_APP_MESSAGE:
{
char* textPayload = (char *)dwParam;
return TRUE;
}
如何在BREW短信中发送和接收中文
为简单起见,前面都是以发送英文ASCII字符为例子的,其实BREW短信也可以发送/接收中文字符,只是步骤上比发送英文复杂一些。
我们知道,中文短消息需要用UNCODE码格式,但是BREW短信的消息头必须用ASCII码发送(包括Class ID),即字符串 //BREW:
: 须用英文发送才能被BREW的底层软件正确识别,如果是UNICODE字符,会被认作是普通短消息而不会启动相应的应用程序。这就产生了一个矛盾:如果用ASCII码,则无法发送中文;如果用UNICODE码,则会被认作普通短消息。
解决办法是采用拼接的办法“骗过”BREW底层。即BREW短消息的消息头部分采用ASCII码,后段的消息体部分采用UNICODE码,把这两段拼起来发送出去就可以了。具体步骤如下:
1. 定义变量wStrMessage, 类型为(AECHAR*),指向一段UNICODE字符串的缓冲区;
2. 定义变量BrewHeader存储BREW短信的消息头字符串,这里假设为 //BREW:0x01009FF0:。将这段ASCII字符串拷贝到wStrMessage缓冲区的开始段。可以用STRNCPY函数来完成拷贝,例子如下:
STRNCPY( (char *)(wStrMessage), BrewHeader, STRLEN(BrewHeader) );
3. 在wStringMessage缓冲区中,紧接着BREW短消息头的后面,将中文字符串ChineseTextMsg拷贝过来;
例如:WSTRCPY(&(wstrMessage[STRLEN(BrewHeader)/2]),
ChineseTextMsg);
4. 调用ITAPI_SendSMS()函数发送,注意UNICODE字符串wStrMessage要强制转换成(const char*),这是ITAPI_SendSMS()函数要求的。
经过以上的处理,在要发送的UNICODE字符串的前面实际上是包含了BREW消息头的ASCII字符,所以能被BREW底层正确识别,而BREW底层对其后面的数据不作任何处理。
在接收方处理中文短信很简单,EVT_APP_MESSAGE事件的dwParam变成了指向UNICODE字符串的指针,只要把该段的数据拷贝过来即可。例子如下:
case EVT_APP_MESSAGE:
{
WSTRCPY( (AECHAR*)wTextPayload, (AECHAR*)dwParam);
return TRUE;
}
采用上述方法,即可以发送中文,也可以发送中英文混排的字符串。我们在几款手机上测试通过。需要注意的是由于中文短信最多是70个,扣除掉BREW短信头,大约还能够发送60个中文字符。
用BREW短信开发应用程序的几种解决方案
开法商可以BREW短信功能可以根据不同的需求灵活地实现各种应用,这里我们提供几种方案,以供参考:
1. 在短信中直接传送消息。如果在用户的数据量不大的情况下,是最简单实用的方法。缺点是当数据量变大时,不适用;
2. 在短信中传送应用程序的启动参数。和命令行参数类似,通过发送不同的参数来执行程序的不同分枝。可以用ISHELL_StartAppletArgs()函数来实现。
具体例子如下:
case EVT_APP_MESSAGE:
{
char * lpszMsg = (char *)dwParam;
ISHELL_StartAppletArgs(pme->a.m_pIShell, AEECLSID_TAPIAPP, lpszMsg);
}
return TRUE;
应用程序可以分成不同种情况,参数1执行A情况,2执行B情况,3执行C情况。。。以此类推。
3. 在短信中传送一个网站的URL地址,应用程序收到短信后可以自动连接网站。
例如:
case EVT_APP_MESSAGE:
const char * url = (const char *)dwParam;
if(url && !STRNICMP(url,”http”,4))
ISHELL_BrowseURL(pme->a.m_pIShell, url);
return(TRUE);
总之,对BREW短信的消息体,开发者可以做任意地解释,开发者可以根据自己的特点加以灵活地运用。
几点说明
有以下几点需要注意:
也可以发送普通短信的方式来发送BREW短信,只要数据格式正确,在任何一台能发短信的手机上都可以发送。但是由于短信格式必须是ASCII,所以要先把 手机的语言设置成英文再发送;在中文环境下即使输入英文,发送的实际上也是UNICODE码,在接收方BREW手机的底层软件也会无法识别,从而无法启动 应用程序;
如果BREW短信的消息头格式错误,则该短信会被手机的短消息信箱接收到。
如果BREW短信的消息头格式正确,但是Class ID错误或者接收方手机中无此应用程序,该短消息会丢弃不用,而不会传到手机的普通短消息信箱中,也不产生任何形式的提示信息。
接收方的应用程序无需在MIF文件中作notification, ITAPI等选项设置。
参考资料
1. BREW 2.0 API Reference
2. BREW 2.0 SDK User’s Guide
3. Handling SMS in BREW", BREW Online Knowledge base, Document ID 52,
http://www.qualcomm.com/brew/developer/resources/ds/kb/52.html
忆龙2009:如何用BREW短消息启动BREW应用程序
最新推荐文章于 2012-05-23 18:58:00 发布