sms - 短信
{bdg-success}已适配 {bdg-primary}Air780EP {bdg-primary}Air780EPS {bdg-primary}Air780EQ {bdg-primary}Air700EAQ {bdg-primary}Air700EMQ {bdg-primary}Air700ECQ
本页文档由[这个文件](https://gitee.com/openLuat/LuatOS/tree/master/luat/../components/sms/luat_lib_sms.c)自动生成。如有错误，请提交issue或帮忙修改后pr，谢谢！
本库有专属demo，[点此链接查看sms的demo例子](https://gitee.com/openLuat/LuatOS/tree/master/demo/sms)
示例
-- 注意, Air780E/Air600E/Air780EG/Air780EG均不支持电信卡的短信!!
-- 意思是, 当上述模块搭配电信SIM卡, 无法从模块发出短信, 也无法在模块接收短信
-- 如果是联通卡或者移动卡, 均可收取短信, 但实名制的卡才能发送短信
sms.send(phone, msg, auto_phone_fix)
发送短信
参数
| 传入值类型 | 解释 |
|---|---|
| string | 电话号码,必填 |
| string | 短信内容,必填 |
| bool | 是否自动处理电话号号码的格式,默认是按短信内容和号码格式进行自动判断, 设置为false可禁用 |
返回值
| 返回值类型 | 解释 |
|---|---|
| bool | 成功返回true,否则返回false或nil |
例子
无
sms.setNewSmsCb(func)
设置新SMS的回调函数
参数
| 传入值类型 | 解释 |
|---|---|
| function | 回调函数, 3个参数, num, txt, metas |
返回值
| 返回值类型 | 解释 |
|---|---|
| nil | 传入是函数就能成功,无返回值 |
例子
sms.setNewSmsCb(function(num, txt, metas)
-- num 手机号码
-- txt 文本内容
-- metas 短信的元数据,例如发送的时间,长短信编号
-- 注意, 长短信会自动合并成一条txt
log.info("sms", num, txt, metas and json.encode(metas) or "")
end)
sms.autoLong(mode)
设置长短信的自动合并功能
参数
| 传入值类型 | 解释 |
|---|---|
| bool | 是否自动合并,true为自动合并,为默认值 |
返回值
| 返回值类型 | 解释 |
|---|---|
| bool | 设置后的值 |
例子
-- 禁用长短信的自动合并, 一般不需要禁用
sms.autoLong(false)
sms.clearLong()
清除长短信缓存
参数
无
返回值
| 返回值类型 | 解释 |
|---|---|
| int | 清理掉的片段数量 |
例子
sms.clearLong()