PHP (SMGW)短消息网关客户端开发包使用详细说明(new).docVIP

技 术 文 件 技术文件名称：短消息网关客户端开发包使用详细说明 技术文件编号： 版 本：V3.5 文件质量等级： 共26页 包括封面 拟 制 审 核 会 签 标准化 批 准 深圳市中兴通讯股份有限公司 目录 1 功能说明 3 2 安装 3 3 目录结构 3 4 接口函数功能说明 4 4.1 初始化API函数 4 4.2 发送和接收函数 4 4.2.1 发送1 条短信 4 4.2.2 群发短信 4 4.2.3 获取群发短信结果 4 4.2.4 接收短信 4 4.2.5 设置参数函数 5 4.3 查询和测试函数 5 4.3.1 检查短信网关是否能够提供服务 5 4.3.2 查询短消息信息 5 5 函数参数和数据结构说明 5 5.1 初始化API函数 5 5.2 发送一条短消息 5 5.3 群发短消息 7 5.4 获取群发短信结果 8 5.5 接收短信 8 5.6 设置参数函数 9 6 配置参数说明 9 7 短信的自动分割功能 9 8 编译说明 10 8.1 UINX平台 10 8.2 WINDOWS平台 10 9 网关客户端开发包支持的平台 10 10 例子程序说明 10 10.1 简单测试程序 10 10.2 综合测试程序 10 11 错误代码 10 12 ICP如何就V1.3版本协议进行处理的说明 11 12.1 交互式订阅、点播流程 动态菜单功能、多次交互功能 12 12.1.1 数据包格式 13 12.2 非交互式服务流程 16 12.2.1 信息订阅流程 16 12.2.2 信息点播流程 17 12.2.3 数据包格式 17 12.3 参数定义 19 12.3.1 操作码参数表 19 12.3.2 加密方式参数表 19 12.3.3 订阅标识参数表 20 12.3.4 询问方式参数表 20 12.3.5 计费方式参数表 20 12.3.6 服务代码参数表 20 12.3.7 数据类型说明 20 12.3.8 回执格式： 21 13 ICP开发中常遇到的问题 22 14 关于从PC到点的的点对点短消息相关规范 23 15 其它说明 25 短消息网关客户端开发包使用详细说明 功能说明 短消息网关客户端开发包的主要功能是：为ICP SP 应用提供标准的API接口，通过该接口,ICP可以基于SMGP协议和短消息网关SMGW通讯。 该开发包具有以下特点。 [1]与SMGW通讯既支持短连接方式也支持长连接方式； [2]支持SMGP协议； [3]参数配置功能； [4]友好的参数接口。 安装 [1]把SMGP API 软件包解压到一个目录。 [2]修改../ SmGw_Client_API /config/smgpc.ini ，修改IcpId （ICP 编号）、IcpShareKey （ICP密码，缺省是1座机电话号码）、ClientIP （客户主机的IP 地址）和ServerIP （短信网关地址）。 [3]使用../ SmGw_Client_API /Test/ActiveTest测试通讯链路和网关服务器端是否激活。 [4]使用../ SmGw_Client_API /Test/SendMsg 尝试发送短消息。 [5]使用../ SmGw_Client_API /Test/RecvMsg尝试接收消息。 [6]使用../ SmGw_Client_API /Test/SendBatch尝试群发消息。 目录结构 目录名 子目录名 文件名 功能说明 SmGw_Client_API Config smgpc.ini 参数配置文件 Lib SmGwAPI.lib 网关客户端开发包 Include smgpapi.h 网关客户端开发包C头文件 smgpdef.h SMGP协议头文件 Test unix平台 ActiveTest.exe 链路测试文件 SendMsg 发送短消息测试文件 RecvMsg 接收短消息测试文件 SendBatch.exe 群发短消息测试文件 sendmsgc.txt 发送短消息缺省配置文件 sendbatchmsgc.txt 群发短消息缺省配置文件 num.txt 群发短消息目的号码配置文件 Msg.txt 短消息内容配置文件 Example win32平台 sendmsg.c 发送短消息例子C源文件 recvmsg.c 接收短消息例子C源文件 sendrecv.c 接收发送短消息多线程例子C源文件 接口函数功能说明 初始化API函数 函数名：InitSMGPAPI ; 功能：读取配置文件，完成初始化的工作。 [1]系统资源的初始化：包括线程和线程同步所涉及的系统资源的创建和设置；定时资源的设置；通信消息机制的设