新酷卡socket对接支持读取信息发送/接收短信及参数命令

参数命令

SOCKET接口使用说明

功能说明：新酷卡可以作为服务端，实现SOCKET通讯，实现三大功能：

1> 支持端口信息和新短xin主动上报。

2> 客户端可以向新酷卡软件发送xx，提交新酷卡任务设置里所有格式的任务。

3> 客户端支持发送指令给新酷卡软件，操作卡池设备自动换卡。

新酷卡配置SOCKET功能:

1> 软件默认已开启SOCKET服务功能，端口号为：16908，可在【工具】->【SOCKET服务对接设置】配置，重启软件生效。

2> 目录下有SOCKET测试工具可用于测试SOCKET指令。

SOCKET指令使用说明：

1> 端口信息上报，只要client连接上新酷卡，端口信息有变会自动往client发送xx，格式为：+DEVICES:端口信息xx长度,端口信息|。

如：+DEVICES:66,COM12,13800000001,460010000000002,89860000000085125121,350212021210245|

2> 客户端收到新短xin格式为：+NEW_SMS:端口号┇手机号┇发送号码┇接收时间┇短xin内容。

3> 客户端提交的短xin发送成功上报格式为：+NEW_SMS:短xinID┇端口号┇手机号┇发送号码┇接收时间┇短xin内容。

4> 客户端提交的短xin发送失败上报格式为：+SMS_FAIL:短xinID┇端口号┇手机号┇发送号码┇接收时间┇短xin内容。

5> 客户端指定端口发送短xin格式为：AP$SENDSMS=xx库ID,端口号,发送号码,发送内容 （注：xx库ID没有可指定一个整数）

6> 客户端提交任务设置任务格式为：AP$TASK=xx长度,端口号,xx (注：端口号小于或等于0表示该任务发送到所有通道)

xx格式为json格式: 如：{"taskname":"短xin","tasktype":"短xin","number":"10001","content":"102","count":1,"waittime":2}

字段值参照软件任务设置，如果是语音，则tasktype对应的类型是"语音"，同理彩信对应的类型是"彩信"，以任务设置类型为准。

xx长度仅计算xx的长度不含端口号。

如发送短xin102到10001,xx长度93（注：中文占两字节）发送到COM66，指令参考：AP$TASK=93,66,{"taskname":"短xin","tasktype":"短xin","number":"10001","content":"102","count":1,"waittime":2}

同样刷流量任务（注：流量任务content对应内容中括号不带必须去掉），指令参考：AP$TASK=213,66,{"taskname":"流量任务","tasktype":"刷流量","number":"","content":"2┇2,网址自动轮转┇1.00-1.00┇NokiaN82/1.0 (20.1.062) SymbianOS/9.2 Series60/3.1 Profile/MIDP-2.0 Configuration/CLDC-1.1┇","count":1,"waittime":2}

其他任务同样参考设置，互打互发除外。

7> 卡池换卡指令：AP$SIM=端口号,序号; (注：如果端口号小于0表示全部通道一起换卡)

8> 卡池指定手机号换卡指令：AP$SIMPHONUM=手机号; (注：必须先保存手机号对应的卡池位置)

9> 获取指令端口信息：AP$PORTREAD=端口号，如：AP$PORTREAD=66，获取COM66端口信息，AP$PORTREAD=-1，获取全部端口信息。

10> 读取新短xin指令：AP$SMS=端口号 (端口号小于0是表示读取全部端口新短xin)

11> 获取端口号信息：AP$DEVICES=端口号，端口号小于0是表示读取全部端口信息。

12> 任务执行结果cha询：AP$TASKRESULT?

13> 根据ICCID换卡：AP$SIMICCID=ICCID

14> 清空未读短xin：AP$SMSCLEAR

15> 发送USSD指令：AP$USSD=端口号,任务ID(大于0整数),"USSD指令"; （端口号小于0是表示全部端口发送USSD指令）

16> 增强读取新短xin指令：AP$EX_SMS=端口号 (端口号小于0表示读取全部端口新短xin,内容经过base64加密处理，1次只上报1条,配置需要关闭端口主动上报信息)

17> AP$SETUPDATE=1;设置主动上报端口及新短xin开关，=1关闭,=0开启，返回xx以：\r\nOK\r\n结束

18> AP$SMS="ALL";上报多条短xin一次最多上报128条，返回xx以：\r\nOK\r\n结束

19> AP$EX_SMS="ALL";上报多条短xin一次最多上报128条，返回xx以：\r\nOK\r\n结束

20> AP$DEVICES="online";上报在线端口信息，返回xx以：\r\nOK\r\n结束

21> AP$SIM_ID=ID,index; 根据通道ID(ID从0开始)卡池2指定序号index换卡

22> AP$SIM_NEXT=端口号(整数); 指定端口换到下一张卡