smssdk
概述
- 配置集成
- 模块使用攻略
  - Android
  - iOS
实例widget下载地址
模块接口
getTextCode
getVoiceCode
commitCode
getSupportedCountries
- callback(ret, err)
- 示例代码：
getFriends
- callback(ret, err)
- 示例代码：
submitUserInfo
- params:
- callback(ret, err)
getVersion
- callback(ret,err)
enableWarn
- params:

smssdk

来自于：Mob官方立即使用

getTextCode getVoiceCode commitCode getSupportedCountries getFriends submitUserInfo getVersion enableWarn

概述

短信验证码SDK，为开发者提供全球通用的短信验证码工具，开发者可以用其在App植入短信验证码SDK、简单设置即可短信验证，集成快速便捷，且后期易于管理。

配置集成

开发者使用本模块之前需要先到Mob官网申请开发者账号，并在账号内填写相应信息创建自己的 APP，从而获取 AppKey和AppSecret，然后添加SMSSDK功能,

*如果需要自定义短信模板，需要获取模板id.

详情参考:快速集成获取apppkey和appSecret

如有问题请联系技术支持:

服务电话:   400-685-2216     
QQ:        4006852216
节假日值班电话:
    iOS：185-1664-1951
Android: 185-1664-1950
电子邮箱:   support@mob.com
市场合作:   021-54623100

模块使用攻略

Android

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

 <meta-data name="Mob-AppKey" value="moba6b6c6d6"/>
 <meta-data name="Mob-AppSecret" value="b89d2427a3bc7ad1aea1e1e8c1d36bf3"/>

另外，1.2.0版开始smssdk模块同时依赖于 mobcommonlib 模块，故需要在模块库搜索 mobcommonlib 模块，并添加至 已添加模块。

注意：从1.2.0版本开始，使用短信SDK需要接入隐私功能，隐私功能的接入方法请参考 mobcommonlib 模块的文档。

iOS

ios 需要将plist 文件放入res目录下，文件内容内容：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>MOBAppKey</key>
    <string>moba6b6c6d6</string>
    <key>MOBAppSecret</key>
    <string>b89d2427a3bc7ad1aea1e1e8c1d36bf3</string>
</dict>
</plist>

字段描述:

Mob-AppKey：（必须配置）从Mob官网获取的 AppKey。AppKey 申请方法参考快速集成获取apppkey和appSecret。

Mob-AppSecret：（必须配置）从Mob官网获取的 AppSecret。AppSecret 申请方法参考快速集成获取apppkey和appSecret。

**编译app时ios 请配置访问联系人的权限**

实例widget下载地址

模块接口

需要引入模块:

var moduleSMSSDK = api.require('smssdk');

getTextCode

获取文本验证码(Get text verification code)

getTextCode({params}, callback(ret,err))

params:

phoneNumber：

类型：字符串
默认值：无
描述：手机号

zone:

类型：字符串
默认值：无
描述：区域号，不要加”+”号

tempCode:

类型：字符串
默认值：无
描述：模板id

callback(ret,err)

ret：

类型：JSON 对象
内部字段：

{
    smart:0  //是否为智能验证 bool类型, ios 忽略此字段
}

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码

var param = {zone:'86', phoneNumber:'18500000000',tempCode:'1319972'};
moduleSMSSDK.getTextCode(param, function(ret, err){
    if (err !== null && err !== undefined && err !== '') {
     // 错误消息示例：{"msg":"Template not exist.","code":484}
    alert("Error:\n" + JSON.stringify(err));
    } else {
        // 正常消息示例：{"smart":false}
       alert("Success:\n" + JSON.stringify(ret));
    }
    });

getVoiceCode

获取语音验证码(Get text verification code)

getVoiceCode({params}, callback(ret, err))

params:

phoneNumber:

类型：字符串
默认值：无
描述：手机号

zone:

类型：字符串
默认值：无
描述：区域号，不要加”+”号

callback(ret, err)

ret：

类型：JSON 对象内部字段： { }

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码：

// param中的key命名不能改变
var param = {zone:'86', phoneNumber:'18500000000'};
moduleSMSSDK.getVoiceCode(param, function(ret, err){
  if (err !== null && err !== undefined && err !== '') {
   // 错误消息示例：{"msg":"Template not exist.","code":484}
   alert("Error:\n" + JSON.stringify(err));
  } else {
     // 正常消息示例：{}
    alert("Success:\n" + JSON.stringify(ret));
    }
   });

commitCode

提交验证码(Commit the verification code)

commitCode({params}, callback(ret, err))

params:

phoneNumber:

类型：字符串
默认值：无
描述：手机号

zone:

类型：字符串
默认值：无
描述：区域号，不要加”+”号

code:

类型：字符串
默认值：无
描述：验证码

callback(ret, err)

ret：

类型：JSON 对象内部字段： { }

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码：

// param中的key命名不能改变
var param = {zone:'86', phoneNumber:'18500000000', code:'4847'};
moduleSMSSDK.commitCode(param, function(ret, err){
if (err !== null && err !== undefined && err !== '') {
  // 错误消息示例：{"msg":"Template not exist.","code":484}
  alert("Error:\n" + JSON.stringify(err));
  } else {
  }
  });

getSupportedCountries

获取区号(Get the Area code of the country)

getSupportedCountries(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    countries =
    (
        {
        rule = "^\\d+";
        zone = 1868;
        }
    )
}

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码：

// param中的key命名不能改变
moduleSMSSDK.getSupportedCountries(function(ret, err){
    if (err !== null && err !== undefined && err !== '') {
     // 错误消息示例：{"msg":"Template not exist.","code":484}
      alert("Error:\n" + JSON.stringify(err));
     } else {
      // 正常消息示例：{"countries":[{zone=590, rule=^\d+},{zone=680, rule=^\d+}]}
        alert("Success:\n" + JSON.stringify(ret));
    }
  });

getFriends

向服务端请求获取通讯录好友信息

getFriends(callback(ret, err))

callback(ret, err)

ret：

类型：JSON 对象
内部字段：

{
    friends =
    (
        {
        lastname : "你好";
        others =     (
                 {
                desc = "董浩";
                phone = 10101155;
                type = 1;
            }
        );
        phones =     (
                    {
                desc = "董浩";
                phone = 10101155;
                type = 1;
            }
        );
        recordid = 411;
        specialdate =     (
                    {
                desc = "生日";
                date = "1988-07-08";
                type = 1;
            }
        );
    }
    )
}

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码：

// param中的key命名不能改变
moduleSMSSDK.getFriends(function(ret, err){
   if (err !== null && err !== undefined && err !== '') {
    // 错误消息示例：{"msg":"Template not exist.","code":484}
    alert("Error:\n" + JSON.stringify(err));
   } else {
    // 正常消息示例：{"countries":[{zone=590, rule=^\d+}, {zone=680, rule=^\d+}]}
     alert("Success:\n" + JSON.stringify(ret));
    }
 });

submitUserInfo

提交用户资料(Submit the user information data)

submitUserInfo({params}, callback(ret, err))

params:

uid:

类型：字符串
默认值：无
描述：用户id

nickname:

类型：字符串
默认值：无
描述：用户昵称

avatar:

类型：字符串
默认值：无
描述：头像地址

phoneNumber:

类型：字符串
默认值：无
描述：手机号

zone:

类型：字符串
默认值：无
描述：区域号，不要加”+”号

callback(ret, err)

ret：

类型：JSON 对象
内部字段： { }

err：

类型：JSON 对象
内部字段：

{
    code:0    //错误码（详见错误码常量）
    msg:""    //错误描述
};

示例代码：

// param中的key命名不能改变
var uid = "3241241";
var nickname = "SmsSDK_Api_Cloud_User_" + uid;
var avatar = "http://download.sdk.mob.com/510/deb/0c0731ac543eb71311c482a2e2.png";
// param中的key命名不能改变
var param = {uid:uid, nickname:nickname, avatar:avatar, phoneNumber:'18500000000', zone:'86'};
moduleSMSSDK.submitUserInfo(param, function(ret, err){
    if (err !== null && err !== undefined && err !== '') {
     // 错误消息示例：{"msg":"Template not exist.","code":484}
    alert("Error:\n" + JSON.stringify(err));
     } else {
    }
});

getVersion

返回SDK版本号(Return the version number of this SDK)

getVersion(callback(ret, err))

callback(ret,err)

ret

类型：JSON 对象
内部字段：

{
    version: "1.0.0"
}

err

类型：JSON 对象
内部字段： { }

示例代码：

// param中的key命名不能改变
moduleSMSSDK.getVersion(function(ret, err){
if (err !== null && err !== undefined && err !== '') {
  // 错误消息示例：{"msg":"Template not exist.","code":484}
  alert("Error:\n" + JSON.stringify(err));
  } else {
   // 正常消息示例：{"version":'3.2.2'}
  }
});

enableWarn

是否允许访问通讯录好友(is Allowed to access to address book)

enableWarn({params})

params:

isWarn:

类型：布尔
默认值：true
描述：YES 代表启用 NO 代表不启用默认为启用

示例代码：

// param中的key命名不能改变
var isWarn = true;
// param中的key命名不能改变
var param = {isWarn:isWarn};
moduleSMSSDK.enableWarn(param);