金笛短信OCX开发控件

内容主题 :

发布时间 : 2017-05-09

运行平台

winxp/ win2000/ 32位win2003/ 64位win2003/ 32位win2008/ 64位win2008/ win7

文件大小

23.54MB

产品简介

随着企业短信的蓬勃发展，短信息的使用越来越广泛，它已逐渐成为年轻人日常沟通及行业集成商与软件开发商的重要手段。短信猫，一般也叫做GSM / GPRS MODEM，从英文名翻译过来，其实就是支持GSM/GPRS制式通讯的调制解调器，所以，俗称短信猫。通过短信猫接入各大通信网（运营商，即SIM），实现企业短信接入，已经成为行业集成商与软件开发商的主要选择。因此，一些软件开发企业看到了短信的应用前景，纷纷计划将短信功能加入到公司的产品中。如何应用短信猫进行二次开发，也成为了他们最关心的问题。金笛短信开发包是以DLL控件的形式提供，支持Windows平台下常用的开发工具：如VC++、VB、.NET、DELPHI、PB等。

金笛短信网作为业界卓越的短信猫设备供应商，其突出的优势更在于提供优秀的短信猫二次开发解决方案。短信猫开发包是金笛短信几年研发精髓、经千百客户锤炼已经成为业界最成熟稳定的短信猫二次开发接口。

该控件具有短信发送、短信自动接收、连接状态测试、从SIM卡中读取短信、从SIM卡中短信删除等功能。目前版本的开发包还提供了用VB6.0、VC6.0、PB8.0、C#和Delphi7.0写成的利用短信控件收发信息的例子。

要使自己的应用软件拥有短信收发功能，如全部从底层开发做起要耗费大量的人力、物力，还要研究GSM的相关通讯标准，开发周期也比较长。支持中英文短信的收发，支持目前市场上大部分的手机和GSM专用模块。为了简化软件开发流程，减少各应用系统相同模块的重复开发工作，提高系统稳定性和可靠性，应用系统软件：OA系统，ERP系统、CRM管理系统、商务网站等等。

功能说明

连接计算机采用工业标准的RS232串口或USB接口。本短信二次开发接口适用于WAVECOM、索爱等支持标准AT指令的GSM短信终端。

一、支持短信发送和短信接收

连接短信猫及发送短信支持阻塞及无阻塞模式：阻塞模式就是调用时直到操作完成才返回，而无阻塞模式调用后马上返回，后台执行具体的操作，完成后以事件的方式通知操作的实际结果；

二、支持呼叫转移

支持短信猫接收到来电时的事件通知，并实现了呼叫转移(需要相应的SIM卡支持)，以防来电时可能干扰正常的短信服务；

三、支持超长短信发送

发送内容长度不限，而且针对每条短信提供发送结果的事件通知；

四、发送短信支持阻塞及无阻塞模式

工作于无阻塞模式时发送短信支持队列和优先级机制：队列支持在很短的时间内可以任意调用发送请求，而优先级类似于操作系统提供的线程优先级、发送队列中有很多短信等待发送时优先发送级别高的短信，同优先级的首先发送先进入队列的短信，而定时发送短信功能需求可在指定时间采用阻塞模式发送来实现(阻塞模式发送就是意味着发送优先级最高)，特别地，对于无阻塞模式发送短信，当发送失败时可以根据指定次数再次自动尝试发送；

五、支持群发短信

调用一次可以为多个号码发送相同内容的短信，并提供对每个发送目标号码提供状态结果的事件通知；

六、支持短信署名

短信署名，在每条发送的短信前自动加入姓名、电话号码或公司名称，有力增加发送短信的亲和力；

七、支持状态报告

支持发送短信的状态报告，同时支持中英文短信的发送；

八、支持WAP PUSH 、闪信发送

支持发送普通文字短信、闪烁短信、WAP PUSH、免提短信等，需要说明的是不是所有的手机都支持闪烁短信等，一般诺基亚的手机基本都支持闪烁；

九、支持获取当前信息

提供SIM卡相关的接收新短信、存储空间已满、获得短信猫当前的工作状态及信号强度、获得短信数量、帐户余额不足等事件通知，有效掌握短信猫的服务状态；

十、支持读取短信自动删除功能

十一、支持全英文发送及优先发送

支持全英文发送、汉字及英文合发送、支持优先发送。

十二、支持 GSM GPRS及CDMA MODEM

控件模块提示

本控件使用时需要SmsCore.dll和DBEngine.dll的支持，部署时必须放在同一目录，所有DLL都不需要注册。

本控件类型库名称：JinDi SmsCom 2.0 TypeLib，引用后缺省名字空间JinDI_SmsComLib。具体使用范例请参考C# 的JinDiOcxDemo演示工程。

ocx模块名称

JindiSMSControl.ocx

金笛短信ocx模块二次开发功能演示如图

控件使用说明

序号	属性名称	数据类型	说明
1	AutoDelMsg	Boolean	设置调用读取短信方法后是否要自动从SIM卡中删除对应的短信。 true自动删除 false不自动删除默认为false，运行时可读写
2	CenterNo	String	SIM入网地的短信中心号码(SMCA) 自动从SIM卡中读取，运行时可读写
3	CommPort	Integer	设备与计算机连接的串口号默认值为1，运行时可读写
4	IsOpen	Boolean	设备是否成功打开运行时只读 True已打开 false未打开
5	Settings	Long	设备与计算机的串口通讯的波特率运行时可读写默认值为115200，如果指定为0，自动判断波特率，一般不是115200就是9600
6	isStatusReport	Boolean	发送短信是否请求状态报告，由于跨网或CDMA等网络不支持，所以一般不推荐使用，设置后对后续的所有发送请求有效直到被改变，运行时可读写
7	IsFlash	Boolean	是否请求发送闪烁短信，接收方是NOKIA的手机才能支持，一般不推荐使用，设置后对后续的所有发送请求有效直到被改变，运行时可读写
8	MsgID	Long	提交短信后生成的编号，运行时可读写，此ID主要用于群发和异步发送时状态通知标识，在一定时间段内需保证唯一
9	SyncWorkMode	Boolean	是否同步工作方式，打开设备前设置对打开设备有效，发送短信前设置对发送短信有效，运行时可读写，同步方式时，直到打开设备成功或发送成功才返回
10	SignName	String	发送短信自动添加的签名，运行时可读写，发送时自动在发送内容前面添加，格式：[签名]:+内容。设置后对后续的所有发送请求有效直到被改变
11	Timeouts	Integer	AT指令执行超时时间，缺省15秒，运行时可读写，设置后对后续操作生效
12	SendStartTime	Date	开始发送短信的开始时间，运行时可读写，缺省不需要设置，全天24小时可发送
13	SendEndTime	Date	结束发送短信的开始时间，运行时可读写。缺省不需要设置，全天24小时可发送
14	AutoSplite	Boolean	是否强制拆分长短信发送，运行时可读写。CDMA短信猫都是强制拆分，GSM短信猫可支持长短信发送，True表示强制。设置后对后续的所有发送请求有效直到被改变
15	CountryCode	String	国际代码，缺省86表示中国，如果设为空，发送短信目标号码都需要添加国际代码，短信中心号码设置也需要添加国际代码。，运行时可读写
16	SendPriority	Integer	发送优先级，1-32，缺省16，数越大，优先级越高。如果在异步工作模式同时提交很多短信，优先级高的优先发送，设置后对后续的所有发送请求有效直到被改变，运行时可读写
17	EnglishMsg	Boolean	是否请求发送全英文短信，缺省False，如果设为True，包括签名和内容，都需要是英文内容，否则对方接收后是乱码，设置后对后续的所有发送请求有效直到被改变，运行时可读写
18	MsgValidMinute	Integer	发送短信的有效期，分钟为单位，缺省一天1440，主要用于对方如果没有开机，在有效期内开机，对方都可以收到短信。设置后对后续的所有发送请求有效直到被改变，运行时可读写
19	Signal	Integer	设备信号强度，运行时只读，连接设备后可获取，一般15-25算正常，信号过弱可能导致发送短信速度慢，失败率也高。
20	ModemName	String	设备名称，运行时只读，连接设备后可获取
21	ModemModel	String	设备型号，运行时只读，连接设备后可获取
22	ModemIMEI	String	设备IMEI唯一标识，个别设备是硬盘ID或MAC地址，运行时只读，连接设备后可获取
23	SimCardID	String	设备上SIM卡的卡号，主意不是手机号，运行时只读，连接设备后可获取
24	CallTransfer	String	呼叫转移号码，连接设备后可读写，CDMA设备不能获取，只能写，设为空表示取消呼叫转移
25	WaitSend	Integer	当前设备等待发送的短信数量，运行时只读，连接设备后可获取
26	FirewareVerion	String	Fireware Verion，运行时只读，连接设备后可获取
27	ErrInfo	String	最近一次操作失败或错误时的描述

方法

发送AT指令（ATCommand）

功能描述：向端口发送AT指令

参数：ATCmd 字符串您要发送的AT指令

返回：字符串 AT指令返回结果

关闭通讯端口（CloseCom）

功能描述：关闭与设备的通讯端口

参数：无

返回：0 成功

其它失败

删除短消息（DelMsgForIndex）

功能描述：删除SIM卡中指定位置的短信

参数：Index 字符串要删除SIM卡中短信的位置

返回：0 删除成功

其他删除失败

打开通讯端口（OpenCom）

功能描述：打开与设备的通讯端口，调用前请先设置串口序号和通讯波特率

参数：无

返回：0 成功

其他失败

读取设备新收到的短消息（ReadMsg）

功能描述：读取设备新收到的短消息

参数：OA 字符串收到短信的来源号码

Msg 字符串收到短信的内容

TimeStamp 字符串收到短信的时间

返回：0 读取成功

其他读取失败

读取短消息（ReadMsgForIndex）

功能描述：读取SIM卡中指定位置的短消息

参数：OA 字符串收到短信的来源号码

Msg 字符串收到短信的内容

TimeStamp 字符串收到短信的时间

Index 字符串 SIM中短信的位置

返回：0 读取成功

其他读取失败

发送短消息（SendMsg）

功能描述：发送一条短信息

参数：PhoneNo 字符串对方的手机号码

Msg 字符串短消息内容

返回：0 发送成功

其他发送失败

发送wappush （SendWappush）

功能描述：发送一条短信息

参数：PhoneNo 字符串对方的手机号码

Subject 字符串 wappush主题

URL 字符串 wappush Url

返回：0 发送成功

其他发送失败

短信数量（GetSimNum）

功能描述：获得当前SIM卡上的短信数量

参数：pUsed ，数值，当前SIM卡上已经有的短信数量

返回：pTotal，数值，SIM卡的短信容量

清理短信（GetSimNum）

功能描述：清理SIM卡上所有短信

参数：无

删除指定范围短信（DelRangeMsg）

功能描述：删除指定范围内的所有短信

参数：sStartPosition ，数值，起始序号 sEndPosition，数值，结束序号，如果起始序号等于结束序号，表示之删除一条返回是否删除成功标记

事件

NewMessage 当有新的短信到达时触发这个事件

参数：sMsgType 数值来信类别，0表示普通文字短信，10表示接收到WAP PUSH sSimPosition 数值来信在SIM卡上的序号，可根据此序号调用方法DelRangeMsg删除

bstrFromNumber 字符串来信号码

bstrContent 字符串来信内容

dtSentTime 日期对方发送时间

ReceivedCall 当有来电时通知

参数： bstrFromNumber 字符串来电号码

ConnectModemResult 异步打开设备时事件通知

参数： bSucceed 真假打开成功标记

SimCardNoMemory SIM卡已满通知

无参数，这一般都是由于没有及时调用删除短信方法导致的，一般收到来信后及时删除处理为好

SimCardNoMoney SIM已欠费通知

当发送时收到此事件，就无法再发送短信，需要及时充值或缴费才能继续发送

SentMsgStatus 发送短信的状态通知，一般群发或异步发送短信才有此事件

参数：ulMsgID 数值消息ID，提交短信后可获取，提交短信前设置的话，提交一次将累加1

bstrDestNumber 字符串，目标号码

bstrContent 字符串，目标内容

sSplitIndex 数值，拆分序号，只有长短信设置了强制拆分才会超过1，否则都是1

bSucceed 真假，是否发送成功标记

应用下载

下载地址1

文档下载

OCX API 二次开发接口说明

服务支持