moduleSMS

startListening getSmsFromDB

概述

moduleSMS模块已更新。

moduleSMS模块功能：

1.获取手机本机号码

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

3.停止短信监听

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

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

getSmsNumber

获取本机手机号码

getSmsNumber(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 对象

内部字段:

startListening(param,callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象

内部字段：

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

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: ['确定']
  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. }

类型：JSON 对象

内部字段：

示例代码

  1. function stopListening() {
  2.             var resultCallback = function(ret, err) {
  3.                 if (err) {
  4.                     api.alert({
  5.                         title : '错误信息',
  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. {

示例代码

补充说明

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

Android系统