|
 产品说明文档.PDF
产品简介
 惠通短信控件DLL动态库开发文档.pdf
惠通短信控件DLL动态库网站下载.rar
控件特点：
1.两种OCX控件和DLL动态链接库形式提供，使用极其使用终端调用
2.属性、方法、事件抽象合理、精简，容易理解使用
3.同时支持同步及异步发送两种方式，异步发送以事件的方式通知成功，满足各种应用
4.支持GSM短信发送，中英文短信息发送，支持发送闪烁短信、免提短信。
5.支持超长短信发送，发送长短信是能将中文超过70字,英文超过160字符的短信自动分割成若干条发送出去,而接收方6.最后接收到的短信则是自动合并成一条短信的,编码方式采用了自动方式
7.支持BIT7格式发送（即对于英文，长度可达160个字符）
8.支持WAP PUSH发送，支持状态报告，来电通知，来短信通知，支持自动回复功能
9.支持小灵通号码发送，支持国际手机号码发送，支持16进制数据
10.接收短信时，可自行选择是否将短信保存于SIM卡中
11.提供At Command接口，通过这一接口开发者可以完成其他各种功能
短信收发控件&语音接口安装使用手册
安装方法二种
1.
执行注册组件.bat
2.
将OCX中的文件COPY到SYSTEM32下参考注册组件.bat人工注册
提示：
用户在自己程序发布时，除了要分发本控件外，还要将装加密组件HTCOM.DLL复制到操作系统的系统目录中。如XP的C:\WINDOWS\SYSTEM32
中，否则不能发送短信
功能：
短信&语音功能：
支持发送7位纯英文短信，8位汉字短信以及十六进制的工业控制设备短信，支持向小灵通发送短信，支持向SP发送短信，如移动查询余额：发送yecx
到10086及可。移动话费查询是编辑短信HF(大小写必须一致)到1001如：联通余额查询是编辑短信YE(大小写必须一致)到1001，
话费查询是编辑短信HF(大小写必须一致)到1001。支持长短信，系统自动发分，支持闪信等特色短信支持来电通知，新短信到达通知，发送报告返回通知，短信自动回复功能，手机自动充值功能。16进制编码短信还可以应用于韩文等多国文字短信发送及其它灵活特殊功能处
控件使用说明
◆
属性
RsId SMS卡中短信存放位置,
RsCenteNo
发送信方的短信中心号码,
RsTel
发信人的手机号码,
RsDate
发信人的发信日期,
RsCon
接收的短信内容.
UseReport 使用短信回报事件
UseNewSms
使用新到短信事件
UseNewRing
使用电话到达事件
SmsFlash
闪信标致，真代表发送的是闪信
Trys
发送失败尝试次数
Waittime
设置多少秒后短信中心无任何反应视为发送失败
◆
方法
☆ 打开通讯端口 （YhOpenModem）
功能描述： 打开与设备的通讯端口
参数：YhOpenModem(CommPort As
Long,Settings As String, sN As String) As String
CommPort 端口号
Settings
串口通讯设置
sN
设备注册号
返回：String 返回值前二个 “-1”字符
表示失败；其它表示成功 返回值为短信中心号；
☆ 关闭通讯端口 （YhCloseModem）
功能描述：关闭与设备的通讯端口
参数：YhCloseModem()
As String
返回：String “1” 成功， 前二字是”-1”表示
失败
☆
发送短消息 （YhSendSms）
功能描述：关闭与设备的通讯端口
参数：YhSendSms(CenterNo
As String, sNo As String, sCon As String, sBit As Long) As String
CenterNo
短信中心号
sNo
对方手机号
sCon 待发短信内容
sBit
短信发送类别
7为纯英文，8为汉字。其它数字代表系统自动选择
注： 9为
发送16进制字符（多用于工控设备）
1为
发送SP服务号比如13800138000
手机号开头为0的识别为小灵通号；非零的长度为11的识别为手机号
手机小灵通的发送由系统自动实现完成
返回：String
前二字是“-1” 表示失改， 其他 成功，
注：发送成功后。如果短信中心发回短信到达短信中心的确认编号，则此函数值就将等于这个编号值。 如果发送大于70字的长短信，发送后返回各条短信的确认编号并组，如
213,214,215， 如果长短信发送不完整,中间某条开始发送失败，那将返回为
213,-1 等试样.也就是说，如果是长短信，最后一个编码是-1表示未完整发送出去。长短信用户查收的确认报告号与长短信中的最后一条编号相等。
为确保短信发发送成功率，用户可调高Waittimer的属性值。
☆
读取短消息 （YhReadSms）
功能描述：读取短信内容
参数：YhReadSms
(sId as string,sDel AS String) As String
SID
短信存放位置，０为所有已读短信
Sdel
值为“是”，时读后删除些短信，别的值，不做删除处理
返回：String前二字符”-1”失败，其它为成功，值为短信内容串。
读取成功同时将短信值放入属性中
RsId SMS卡中短信存放位置,
RsCenteNo
发送信方的短信中心号码,
RsTel
发信人的手机号码,
RsDate
发信人的发信日期,
RsCon
接收的短信内容.
注：SID=-1表示所有新到短信，SID=0表示列例所有已读短信，SID=n
表示第N个位置的短信内容。 当SID=-1和SID=0时。返回多条记录到各属性中。记录间以CHR$(11)分隔，二次开发商可以用SPLIT分离出来。各属性次序相对应。
☆
发送AT指令（YhATCommand）
功能描述：向端口发送AT指令
参数：YhATCommand(At
As String) As String
AT 您要发送的AT指令
返回：string AT指令返回结果
如为错误，返回ERROR
☆ 删除短消息 （YhDelSms）
功能描述：删除SIM卡中指定位置的短信
参数：YhDelSms(sId
As String)
Sid
要删除SIM卡中短信的位置
返回：String 1
成功，-1 失败
☆ 电话语音
(VoiceInterface)
功能描述:
拔打电话号码，接着步骤按设置好的仿真键
参数：VoiceInterface
(Keys As String) As String
Keys
按控步骤。
延时长单位为 秒
格式：手机号+”,”+延时长+”,”+键盘值+”,”+延时长+”,”+键盘值+…+”,”+键盘值+“，*END*”
比如深圳拔打13800138000充值。Keys值如下：
13800138000,2,1,2,1,2,1#,2,4124151234125#,6,*END*
解说：打通手机
13800138000 后过2秒，按 1
键，再过2秒按1键，再过2秒接
1# 键，再过2秒按4124151234125#
键，再过6秒 挂断电话。（*END*特指挂断电话*）
返回：String
操作成功返回 1 “操作完成” ,操作失败，返回”-1”+步骤位置。
☆ 电话信息号质量
(SignalQuality)
功能描述：获取当前设备的信号值量
返回：String
0-30 数字
18以上信号可以正常工作，信号值越大说明信号越好，如果CSQ：返回99说明没有正常入网
☆ 短信存贮数量
(GetSmsNum)
功能描述：获取当前SMS卡上保存的短信数量
返回：String 18，40
当前短信数18，总可存短信数40
☆ 获取可用端口
(YhGetComPort)
功能描述：获取电脑上可用串口列表
返回：String 1，3，40
串口列表用“，”号分隔。
示例表示： 当前可用端口为COM1，COM3和COM4口
◆
事件
三个事件。来电通知，新短信到达通知，发送报告返回通知
☆
来电通知（NewRing）
NewRing(iTel As
String, iDate As String)
记录打进电话时的号码，
第一个参数返回来电电话号码，第二个参数返回来电时间
☆
新短信通知（NewSms）
NewSms(iSms As
String, sId As String, sCenterNo As String, sTel As String, sDate As String,
sCon As String)
新短信到来时，自动读取变返回内容保存到后五个参数中。
第一个参数为新到短信的存放位置编号，后面五个参考与读短信的函数中参数原理结构一样。
☆
报告返回通知 （SmsReport）
SmsReport(SmsID As
String, sTel As String, ToCenterDate As String, ToUserDate As String,iLog as
String)
短信发送成功后将返回一个短信中心收到此短信的确认号，当此短信由短信中心发送到用户手机后，将返回一个报告，此报告反应在报告事件中，第一个参数为短信中心为此短信提供的编号，他等于发送短信成功时返回的编码号。第二个参数是发送的手机号，第三个参数为短信中心收到此短信的时间，第四个参数为短信中心将此短信发送到用户手机上的时间,第五个参数为短信确认值，一般00表示成功到达用户手机。别的代码用户未接收到此短信，可能各短信中心有一点差别。所以将些值做出来由用户根据情况判断。
要做短信回报的用户，短信发送成功后，将返回的编号和发送内容记录下来。有新报告事件时，就将这些值与选取前保存的编号进行对比。相同的就表示此条短个正确发送，并且正确的到达对方用户的手机中 | 
