bgnMobSMS

来自于:布谷鸟模块工作室

send voice verify getVersion

概述

模块概述

bgnMobSMS封装了mob提供的免费短信+语音验证码的SDK,使用此模块可轻松实现验证手机号码真实性的功能,当前封装的SDK版本为3.2.0,开发者可享受Mob提供的免费技术服务,获取短信验证码,短信或语音消息费用全免,不限条数,不限全球运营商,覆盖全球,无国界的支持手机验证,覆盖全球212个国家,1000多个运营商让您的App在全球覆盖的区域更广,自定义UI,高度自定义的UI设计理念,让用户体验更完美。 三秒内急速下发,mob与移动、联通、电信三大运营商紧密合作,一级通道确保验证码下发稳定,用户注册流畅,配置简单,无需与短信平台合作的繁琐手续,SDK快速集成全面的数据统计,全面的数据接口,获得较为完善的用户信息让您看得到用户的行为,深入了解用户。

模块使用攻略

使用之前须从mob(www.mob.com)开放平台申请开发者账号并创建应用,获取 appkeyappsecret,选择SMSSD按官方要求完成相关设置。请见论坛示例:https://community.apicloud.com/bbs/thread-117479-1-1.html

使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:

  • 名称:bgnMobSMS
  • 参数:appKey、appSecret
  • 配置示例:
  1. <feature name="bgnMobSMS">
  2. <param name="appKey" value="d0d84bbf23b4a0e4"/>
  3. <param name="appSecret" value="a354f72aa1b4c2b8eaad137ac81434cd"/>
  4. </feature>

注意:IOS系统平台由于Mob官方的技术限制只能在自定义apploader或云平台上编译正式版本的方式下运行,该模块无法在测试版编译方式下运行

模块接口

send

发送短信验证码

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

params

tempCode:

  • 类型:字符串
  • 描述:(可选项)用户自定义的短信模版编号,不传则使用官方提供的默认短信模版。

country:

  • 类型:字符串
  • 描述:(可选项)国家地区编号,默认为86。

phone:

  • 类型:字符串
  • 描述:(必填项)手机号码。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false,当前短信是否发送成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 0 //数字类型;
  3. //错误码:
  4. msg: //错误消息
  5. }

示例代码

  1. var sms = api.require('bgnMobSMS');
  2. sms.send({
  3. phone:"13600000000"
  4. },function(ret, err) {
  5. if (ret.status) {
  6. alert("短信发送成功");
  7. } else {
  8. alert('短信发送失败,原因:'+err.msg);
  9. }
  10. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

voice

发送语音验证码

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

params

country:

  • 类型:字符串
  • 描述:(可选项)国家地区编号,默认为86。

phone:

  • 类型:字符串
  • 描述:(必填项)手机号码。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false,当前语音是否发送成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 0 //数字类型;
  3. //错误码:
  4. msg: //错误消息
  5. }

示例代码

  1. var sms = api.require('bgnMobSMS');
  2. sms.voice({
  3. phone:"13600000000"
  4. },function(ret, err) {
  5. if (ret.status) {
  6. alert("语音发送成功");
  7. } else {
  8. alert('语音发送失败,原因:'+err.msg);
  9. }
  10. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

verify

验证收到的验证码

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

params

code:

  • 类型:字符串
  • 描述:(必填项)手机接收到的验证码。

country:

  • 类型:字符串
  • 描述:(可选项)国家地区编号,默认为86。

phone:

  • 类型:字符串
  • 描述:(必填项)手机号码。

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. status: true //布尔型;true||false,验证是否成功
  3. }

err:

  • 类型:JSON 对象
  • 内部字段:
  1. {
  2. code: 0 //数字类型;
  3. //错误码:
  4. msg: //错误消息
  5. }

示例代码

  1. var sms = api.require('bgnMobSMS');
  2. sms.verify({
  3. code:"1234",
  4. phone:"13600000000"
  5. },function(ret, err) {
  6. if (ret.status) {
  7. alert("验证成功");
  8. } else {
  9. alert("验证失败");
  10. }
  11. });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

getVersion

同步方式获取当前SMSSDK版本号

getVersion()

示例代码

  1. var sms = api.require('bgnMobSMS');
  2. var version = sms.getVersion();

补充说明

该方法无参数,不需要回调,是一个同步方式,直接返回的字符串就是当前SDK的版本号

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本