sms - 短信功能
适用范围
| 层面 | 说明 |
|---|---|
| 运行环境 | LuatOS-Air 脚本框架,展锐 8910 平台(Air724UG / Air722UG / Air795UG / Air720UH 等) |
| 前提条件 | 需 SIM 卡、已驻网,且卡开通了短信业务 |
| 不适用 | Air780E 及以后跑 LuatOS 的 Cat.1 模组;这些模组的同名库在 osapi 里是另一套接口,不能照抄 |
sms.send(num, data, cbFnc, idx)
发送短信
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| num | string | 短信接收方号码,ASCII码字符串格式 |
| data | string | 短信内容,GB2312编码的字符串 如果短信内容中只有ascii可见字符,则超过160个字符时,会被拆分为几条长级联短信进行发送 如果短信内容中包含除ascii可见字符外的其他字符,例如包含汉字,一个汉字算作一个字符,一个ascii可见字符也算作一个字符,超过70个字符时,会被拆分为几条长级联短信进行发送 |
| cbFnc | function | 可选参数,默认为nil 短信发送结果异步返回时的用户回调函数,回调函数的调用形式为:cbFnc(result,num,data) num:短信接收方的号码,ASCII码字符串格式 data:短信内容,unicode大端编码的HEX字符串 |
| idx | number | 可选参数,默认为nil 插入短信发送缓冲表的位置,默认是插入末尾 |
返回值
result,true表示调用接口成功(并不是短信发送成功,短信发送结果,通过sendcnf返回,如果有cbFnc,会通知cbFnc函数);返回false,表示调用接口失败
例子
sms.send("10086","test",cbFnc)
sms.setNewSmsCb(cbFnc)
设置新短信的用户处理函数
参数
| 名称 | 传入值类型 | 释义 |
|---|---|---|
| cbFnc | function | 新短信的用户处理函数 |
返回值
nil
例子
sms.setNewSmsCb(cbFnc)