moduleSMS

来自于：开发者

getSmsNumber startListening stopListening getSmsFromDB

概述

moduleSMS模块已更新。

moduleSMS模块功能：

1.获取手机本机号码

2.监听短信，收到短信后，截获短信内容返回js

3.停止短信监听

4.查询历史短信，通过查询android手机短信数据库获取短信内容

使用此模块之前需先配置config文件的permission，方法如下：

  1. 配置示例：
  1.  <permission name="sms"/>

getSmsNumber

获取本机手机号码

getSmsNumber(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

  1. {
  2.     number:185*********           //获取到的手机号码内容
  3. }

err：

类型：JSON 对象

内部字段：

  1. {    
  2.    code:0,      //错误码    
  3.    msg:""    //错误描述
  4. }

示例代码

  1. var sms = api.require('moduleSMS');
  2. var resultCallback = function(ret, err) {
  3.     document.getElementById("tel").value = ret.number
  4. }
  5. sms.getSmsNumber(resultCallback);

补充说明

获取本机号码，没有获取到则返回空值

可用性

Android系统 可提供的1.0.0及更高版本

startListening

开启短信监听服务

param :

类型：JSON 对象

内部字段:

  1. {
  2.     time:1        //监听周期 类型是正数的int类型不得超过int类型的上限，单位是分钟，如果time为0或空时，表示监听没有时间限制，一直运行直到app退出或执行stopListening。time的值为1表示监听1分钟，1分钟后自动关闭监听。
  3. }

startListening(param,callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

  1. {
  2.     strAddress:10652238        //发信人号码
  3.     strbody:*******        //截取收集新接收到的短信全部内容
  4.     strType:接收        //短信类型，接收表示接收到的短信
  5.     strDate:YYYY-MM-dd hh:mm:ss        //短信时间
  6. }

err：

类型：JSON 对象

内部字段：

  1. {
  2.     msg:””        //错误描述
  3. }

示例代码

  1.   var resultCallback = function(ret, err) {
  2.     if (err) {
  3.         api.alert({
  4.             title: '错误信息',
  5.             msg: ret.msg + " :: " + err.msg,
  6.             buttons: ['确定']
  7.         }, function(ret, err) {
  8.             //coding...
  9.         });
  10.     } else {
  11.         api.alert({
  12.             title: '监听短信',
  13.             msg: JSON.stringify(ret.strAddress) + " , " + JSON.stringify(ret.strbody) + " , " + JSON.stringify(ret.strType) + " , " + JSON.stringify(ret.strDate),
  14.             buttons: ['确定']
  15.         }, function(ret, err) {
  16.             if (ret) {} else {}
  17.         });
  18.     }
  19. }
  20. param = {
  21.     time: '1'
  22. }
  23. bekeerSMS.startListening(param, resultCallback);
  24. api.toast({
  25.     msg: '开始监听短信'
  26. });

补充说明

如果没有传入time参数，则监听程序一直运行，否则只运行指定的分钟数。

可用性

Android系统

可提供的1.0.0及更高版本

stopListening

停止短信监听服务

stopListening(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

  1. {
  2.     msg:监听成功关闭        //监听关闭后返回该字符串，表示关闭成功，如果返回“监听未启动，无需关闭”则表示监听服务已被关闭或未启动
  3. }

err：

类型：JSON 对象

内部字段：

  1. {
  2.     msg:””        //错误描述
  3. }

示例代码

  1. function stopListening() {
  2.             var resultCallback = function(ret, err) {
  3.                 if (err) {
  4.                     api.alert({
  5.                         title : '错误信息',
  6.                         msg : ret.msg + " :: " + err.msg,
  7.                         buttons : ['确定']
  8.                     }, function(ret, err) {
  9.                         //coding...
  10.                     });
  11.                 } else {
  12.                     api.alert({
  13.                         title : '停止监听',
  14.                         msg : ret.msg,
  15.                         buttons : ['确定']
  16.                     }, function(ret, err) {
  17.                     });
  18.                 }
  19.             }
  20.             bekeerSMS.stopListening(resultCallback);
  21.         }

补充说明

可用性

Android系统

可提供的1.0.0及更高版本

getSmsFromDB

获取历史短信

getSmsFromDB(param,callback(ret, err))

param:

类型：JSON 对象

描述：可根据发信人号码、起始日期、结束日期进行筛选短信，如果没有传入某个参数或为空，表示筛选不受该参数约束。

内部字段：

  1. {
  2.     address : '',        //发信人号码
  3.     sdate : '2016-03-01',    //查询起始日期，接收短信日期
  4.     edate : '2016-03-07'    //查询结束日期，接收短信日期
  5. }

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

  1. {
  2.     strAddress:10652238        //发信人号码
  3.     strbody:*******        //截取收集新接收到的短信全部内容
  4.     strType:接收        //短信类型，接收表示接收到的短信
  5.     strDate:YYYY-MM-dd hh:mm:ss        //短信时间
  6. }

err：

类型：JSON 对象

内部字段：

  1. {
  2.     msg:        //错误描述
  3. }

示例代码

  1. function getSmsFromDB() {
  2.     var resultCallback = function(ret, err) {
  3.         if (err) {
  4.             api.alert({
  5.                 title: '错误信息',
  6.                 msg: ret.msg + " :: " + err.msg,
  7.                 buttons: ['确定']
  8.             }, function(ret, err) {
  9.                 //coding...
  10.             });
  11.         } else {
  12.             for (var data in ret) {
  13.                 api.alert({
  14.                     titile: '',
  15.                     msg: "text : " + JSON.stringify(ret[data].strAddress) + " : " + JSON.stringify(ret[data].strDate) + " : " + JSON.stringify(ret[data].strbody) + " : " + JSON.stringify(ret[data].strType),
  16.                     buttons: ['确定']
  17.                 }, function(ret, err) {
  18.                     //coding...
  19.                 });
  20.             }
  21.         }
  22.     }
  23.     param = {
  24.         address: '',
  25.         sdate: '2016-03-01',
  26.         edate: '2016-03-07'
  27.     }
  28.     bekeerSMS.getSmsFromDB(param, resultCallback);
  29. }

补充说明

param参数可用可不用，不用param时，将查询手机内所有短信，否则按照参数条件进行查询.

可用性

Android系统

可提供的1.0.0及更高版本