北京清扬创新将尝试提供部分可以利用清扬软件的API接口,以方便用户的使用。这里介绍的是利用清扬短信服务器软件发短信的接口,通过该API接口,"电脑发送短信、自动短信报警等功能可以集成到各行业软件开发中",为软件开发人员提供便利。
清扬短信服务器软件是一个利用了短信猫(Gsm Modem)来收发短信的软件,并支持繁体、日语、韩文等多语言短信的发送,在某些环境下,比如:在隔离网络中,似乎是收发短信的主要选择。
北京清扬创新提供了一个qyVDevApi.dll,用此dll可建立和短信服务器的沟通。
现在我们就来看具体的介绍。
一. 开放的api介绍
int qvdSendSm( void * p0, WCHAR * sm, char * phoneNo, HWND hWnd_notify, int iUsrData );
参数说明:
p0, 保留
sm, 要发送的短信文本, 字符串
phoneNo, 手机号码, 要加区号;比如: 8613146630221
hWnd_notify, 可收发送后通知的窗口句柄
iUsrData, 一个用户定义的标识
注意:
1.短信服务器发送短信后,将用WM_COPYDATA的消息发送一个响应包到hWnd_notify, 响应包格式如下:
typedef struct __qvdSmResp_t {
int id;
int iErr;
} QVD_SM_RESP;
hWnd_notify不是必需的,如果对响应包不感兴趣,不用传入。
如何使用:
1.把自备GSM MODEM短信猫硬件接入电脑。选择合适的型号,请参看:如何为清扬即时通信挑选短信猫(GSM MODEM)和测试发送短信。
2.用清扬短信服务器软件控制短信猫发送短信。下载软件,请参看:清扬短信服务器软件快速入门。
3.使用发送短信API接口编译测试。API接口的例子程序,请参看:清扬短信服务器发送短信API接口说明和例子程序,下载例子:qySrc_smDemo,可以编译测试。该例子qySrc_smDemo利用动态装载将dll装入,找到相关函数地址,即可在后面调用。在使用时,注意将dll目录下的qyVDevApi.dll拷在生成的qyVDevSample.exe同一个目录下。
二. 清扬短信服务器的使用
短信服务器的使用,请见http://www.skycn.com/soft/45545.html上的清扬短信服务器软件介绍,也有flash教程可以看如何使用。
注意: 在利用api向短信服务器发送短信时,要打开菜单[配置]/[个性化配置]里的设置, 允许第三方软件发送短信。
同时注意: 此设置必须在管理员权限下才能设置。
三. 其他说明
短信modem的选择,请见清扬文章如何为清扬即时通信挑选短信猫(GSM MODEM)和测试发送短信。
如果短信modem的波特率不是9600,请在菜单[配置]/[个性化配置]里,重设波特率(baud)。
图:清扬短信服务器软件(单机版):支持API接口的配置
到此为止,就轻松实现了发送短信的API调用。