帮助与文档

> >
다운로드

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

配置集成

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

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

一.准备工作

下载并安装开发工具:APICloud Studio 2

二.创建应用

APICloud提供了两种创建应用的方式,方便开发者在云端或APICloud Studio中创建应用。

云端创建应用:

1) 注册并登录APICloud系统:https://www.apicloud.com/console 点击左上角“创建应用”, 如图:选择“Native”,填写“名称”及“说明”,应用创建完成。

APICloud Studio中创建应用:

1) 登录APICloud Studio,没有账号点击“注册账号”,已经注册,用之前注册的APICloud账号登录APICloud Studio

这2端可以相互同步信息:

同步本地应用到云端资源库,开发者在APICloud Studio创建的应用会和云端资源库建立连接。项目代码改动后,可以使用APICloud Studio的代码提交功能提交代码到云端资源库。

三.添加模块

打开APICloud云端,加入我们的SMSSDK模块:

 

四.模块使用攻略

Android:

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

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

IOS:

ios 需要将Info.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>
  • 字段描述:
  1. Mob-AppKey:(必须配置)从Mob官网获取的 AppKey。AppKey 申请方法参考快速集成获取apppkey和appSecret
  2. Mob-AppSecret:(必须配置)从Mob官网获取的 AppSecret。AppSecret 申请方法参考快速集成获取apppkey和appSecret

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

Demo实例widget下载地址

 

五.模块接口说明

需要引入模块:

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

(1)获取文本验证码

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));
    }
    });

(2)获取语音验证码

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));
    }
   });

(3)提交验证码

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 {
                                           
  }
  });

(4)获取区号

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));
    }
  });

(5)获取通讯里好友信息

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));
    }
 });

(6)提交用户资料

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 {
}
});

(7)获取版本号

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'}
}
});

(8)是否允许访问通讯录好友

enableWarn({params})
params:
isWarn:

类型:布尔

默认值:true

描述:YES 代表启用 NO 代表不启用 默认为启用
示例代码:
// param中的key命名不能改变
var isWarn = true;
// param中的key命名不能改变
var param = {isWarn:isWarn};
moduleSMSSDK.enableWarn(param);

 

 

 

 

 

chrome 구버전 다운로드 충무공 전 2 다운로드 어스 자막 다운로드 코만도스2 다운로드

相关文档