1、创天通信短信控件 Ver 3.0开发使用指南北京创天通信科技有限公司二零零五年九月未经书面授权,严禁复制和传播。Version 3.0,Copyright 2002,All Right Reserved1、简介近两年来,短信息的使用越来越广泛,它已逐渐成为年轻人日常沟通的重要手段。同时,一些软件开发企业也看到了短信的应用前景,纷纷计划将短信功能加入到公司的产品中。要使自己的应用软件拥有短信收发功能,如全部从底层开发做起要耗费大量的人力、物力,还要研究GSM的相关通讯标准,开发周期也比较长。为了能让企业快速开发出具有短信功能的应用软件,我公司提供了一套高可靠性的短信开发包,支持中英文短信的收发,
2、支持目前市场上大部分的手机和GSM专用模块。短信开发包是以OCX控件的形式提供,支持Windows平台下常用的开发工具:如VB、VC+、Power Builder等。目前版本的开发包还提供了用VB6.0写成的利用短信控件收发信息的例子。u 手机与计算机连接1、 通过手机厂商提供的线缆,与计算机的串口相连接u 控件特点1、 OCX控件方式提供,使用极其方便2、 属性、方法、事件抽象合理、精简,容易理解使用3、 事件驱动方式,占用系统资源少,运行效率高4、 接收短信时,不通过手机内部处理,控件直接接收,速度极快u 开发包文件列表文件或目录名称说明短信控件使用指南.doc本文档,介绍控件的使用方法。
3、Example目录控件使用例子的源代码,包括VB6.0TransoftSMSControl30.ocx核心控件,被安装在系统的system32目录下。SMSReg.exe控件注册程序,使之成为正式版本。u 特别提示!1、 由于本控件使用了微软公司的MSCOMM32.OCX,所以用户在自己程序分发时,除了要分发本控件外,还要包括MSCOMM32.OCX。2、 对于用加密狗加密的版本,需要将SoftDogSetup.dll和SMSDoor.dll两个文件拷贝到windows的system32目录下,不用注册。3、 如使用红外口来收发短信,在Windows 98环境下,红外口映射成了一个标准的串口,
4、一般为COM4,您只需将控件的CommPort属性设置为4就可以了;对于Windows2000及以上版本,其红外协议发生了改变,目前版本的控件还不支持。4、 对于西门子6618手机,波特率设为:115200,N,8,15、 新版本发送短信过程采用了异步调用,占用更少的系统资源。2、控件使用说明u 属性序号属性名称数据类型说明1CommPortInteger与计算机连接的串口号2CenterNoString 短信中心号码 默认值为北京的中心号码86138001005003LastReadSenderString LastReadSender、 LastReadMsg和LastReadTime为一
5、组属性,在用控件的ReadMsg方法从gsm设备中读取短信时,用来存储短信的相关信息。 这个属性表明短信发送方的号码 设计时不可用,运行时都可以读4LastReadMsgString LastReadSender、 LastReadMsg和LastReadTime为一组属性,在用控件的ReadMsg方法从手机中读取短信时,用来存储短信的相关信息。 这个属性表明短信的 设计时不可用,运行时都可以读5LastReadTimeDateTime LastReadSender、 LastReadMsg和LastReadTime为一组属性,在用控件的ReadMsg方法从手机中读取短信时,用来存储短信的相关
6、信息。 这个属性表明短信到达的时间 设计时不可用,运行时都可以读6MobileTypeInteger 表示手机类型 设计时和运行时都可以读写 表示手机类型(0=标准手机、1=WaveCom 模块、2= Nokia、3=西门子) 默认值为17SendTimeOutInteger 短信发送时超时时间,单位为秒,超过这个时间,控件认为发送失败 ,回返回发送错误事件 设计时和运行时都可以读写 默认值为10秒8SettingsString 手机与计算机的通讯设置 设计时和运行时都可以读写 默认值为 9600,N,8,1,分别代表波特率、奇偶校验、数据位数和停止位数 不同的手机这个设置会不同11IsReg
7、isterBoolean 启动程序时判断该属性是否为注册,如未注册则需要断开程序与设备的连接,重新连接。12LicenseString 该设备的注册号,如果设置了该属性,则优先于注册表中的数据13IsBusyBoolean 控件状态,发送短信的时候一定要在控件闲的时候进行。u 方法 打开通讯端口 (CommOpen)功能描述:打开与手机的通讯端口参数:无返回:0成功-1失败 关闭通讯端口 (CommClose)功能描述:关闭与手机的通讯端口参数:无返回:0成功-1失败 发送短消息 (SendMsg)功能描述: 发送短信,此过程为异步调用,主程序调用这个过程后,直接返回,是否发送成功控件通过事件
8、的方式返回给主程序参数:MobileNo 字符串 对方的手机号码 Msg 字符串 短消息内容Chinese 布尔型 是否为中文短消息 (True=中文 False=西文)NeedReport 布尔型 是否需状态报告 (True=需要 False=不需要)IsFlash 布尔型 是否为快闪短信返回:无 读取手机中的短消息 (ReadMsg)功能描述:从手机SIM卡中的读取短消息 读回来的短信属性分别存储在LastReadSender、LastReadMsg和LastReadTime中参数:Index SIM卡中短信的记录号码返回:0读取成功-1读取失败 读取SIM卡中所有短信的编号(GetAll
9、SMSIndexFromSim)功能描述:读取sim卡上所有短信的编号,以便于读取短信,或删除短信 参数:无返回: 字符串,用逗号分开的多个短信 ,如sim卡中无短信,则返回空 删除手机中的短消息 (DeleteMsg)功能描述:将手机SIM卡中的短消息删除 参数:Index SIM卡中短信的记录号码返回:0删除成功-1删除失败 发送wappush消息 (SendWapPush)-此功能只有sp专版才提供功能描述: 发送push到对方手机,此过程为异步调用,主程序调用这个过程后,直接返回,是否发送成功控件通过事件的方式返回给主程序参数:MobileNo 字符串 对方的手机号码 Url wap地
10、址 Subject 显示主题NeedReport 布尔型 是否需状态报告 (True=需要 False=不需要)返回:无 u 事件 MsgReceived当短信到达时触发这个事件,具体返回的参数为:MsgSender 字符串型 短信的发送方号码Msg 字符串型 短信内容ArrivedTime 日期时间型 短信到达的时间 ReportReceived当发送的短信包含状态报告时,对方接收到短信触发这个事件, 具体返回的参数为:MsgReference 整型数据 对应于发送短信时产生的MsgReferenceReceiver字符串型 接收者的手机号码OriginSendTime 日期时间型 短信发送
11、到短信中心的时间ArrivedTime 日期时间型 短信实际送达的时间Status 整型数据 保留 SendComplete发送短信成功具体返回的参数为:intMsgReference 整型数据 对应于发送短信时产生的MsgReference Error错误事件具体返回的参数为:Number 整型数据 错误事件类型 -1 未知错误 1 发送短信失败 2 发送短信超时失败Description 字符串型 错误描述 InComingCall 来电具体返回的参数为:InComingCallNo 字符串型 来电号码InComingCallTime 日期时间型 来电时间3、如何随您的应用程序发布该控件在发布您的应用程序时,需将SMSReg.exe这个注册程序一起发布,这样可以在目标计算机上注册该控件。4、服务与支持我公司为产品使用提供电话咨询服务,联系方式如下:北京创天通信科技有限公司地址:北京市海淀区知春路6号锦秋之春G座2001邮编:100088电话:010-51660033电子邮箱:Market网址: