帮助与文档

> >

一、注册应用获取appKey 和 appSecret

(1)到Mob官网注册成为Mob开发者,老用户直接登录即可;

image

(2)注册或登录完成后,会返回至首页,点击右上角的“进入后台”,会跳转至管理后台,点击下拉列表,选择“创建新应用”。如下图:

Snip20170527_3.png

输入应用名称后点击“保存”,如下图: image

(3)应用创建后在左边导航栏点击“添加产品”,选择 SecurityCodeSDK ,点击马上开始,如下图:

Snip20170527_4.png

此时左边导航栏就能看到您添加的产品了,点击“概况”即可看到您接下来需要的AppKey和AppSecret了,你也可以在菜单中看到设置和短信记录等信息,修改完设置记得保存,如下图:

Snip20170527_7.png

二. 获取SMSSDK:

点击链接下载最新版SDK,解压后得到以下文件结构:

Snip20170525_60.png

  • SDK:短信验证码SDK和依赖库。无UI使用时直接将这个文件夹拖入工程即可。
  • SMS_SDKDemo:示例Demo 。
  • SMSSDKUI :SMSSDK提供的UI。

三、集成SMSSDK和UI

将SDK文件夹,SMSSDKUI.xcodeproj以及SMSSDKUI.bundle拖入工程。

注意:只需要拖入SMSSDKUI.xcodeproj,不要选中该工程目录下的文件,意思就是把SMSSDKUI作为一个项目集成进去,然后build出来一个.a包,把.a包加进库资源文件里。

Snip20170525_30.png

Snip20170525_38.png

然后选择SMSUI运行打包.a库,并在依赖库中添加libSMSSDKUI.a

Snip20170524_26.png

四、添加依赖库

SDK所需依赖库列表:

libz.dylib
libstdc++.dylib

Snip20170524_6.png

五、配置appkey和appSecret

在项目中的info.plist文件中添加键值对,键分别为 MOBAppKey 和 MOBAppSecret ,值为步骤一申请的appkey和appSecret

配置通讯录好友功能所需的私密key,键为:NSContactsUsageDescription

Snip20170525_67.png

六、使用SMSSDK提供的UI

短信UI部分是以Demo形式开源的,具体参考Demo。以下是UI模块API:

– 导入头文件

#import "SMSSDKUI.h"

– 弹出请求验证码界面

 SMSSDKUIGetCodeViewController *vc = [[SMSSDKUIGetCodeViewController alloc] initWithMethod:SMSGetCodeMethodSMS];

    UINavigationController *nav = [[UINavigationController alloc] initWithRootViewController:vc];

    [self presentViewController:nav animated:YES completion:nil]; 

注册界面RegViewController,进入该界面后,可选择国家和地区和输入手机号码进行短信注册验证;

选择国家和地区的选项进入SectionsViewController,在该控制器会从服务端获取所支持的国家和地区;

用户在注册页面输入手机号码之后,点击下一步,界面跳转到短信验证界面同时服务端会发送短信验证码到手机;

短信验证界面对应的控制器为VerifyViewController 主要处理短信的验证功能。

七、使用SDK提供的API(功能)

一、发送和验证短信验证码API

  • 导入头文件
#import <SMS_SDK/SMSSDK.h>

SMSSDK.h文件为SMSSDK的核心类。这个类的所有方法以类方法提供,根据需要直接使用相应的方法。

  • 请求短信验证码
    [SMSSDK getVerificationCodeByMethod:SMSGetCodeMethodSMS phoneNumber:@"13800138000" zone:@"86" result:^(NSError *error) {

        if (!error)
        {
            // 请求成功
        }
        else
        {
            // error
        }
    }];
  • 提交短信验证码
    [SMSSDK commitVerificationCode:@"1234" phoneNumber:@"13800138000" zone:@"86" result:^(NSError *error) {

        if (!error)
        {
            // 验证成功
        }
        else
        {
            // error
        }
    }];
  • 获取支持的国家列表
    [SMSSDK getCountryZone:^(NSError *error, NSArray *zonesArray) {

        if (!error)
        {
            NSLog(@"支持的国家(地区):%@",zonesArray);
        }
    }];
  • 当前SDK的版本号
NSString *version = [SMSSDK version];

二、通讯录好友功能

  • ### 功能介绍

获取手机通讯录中联系人列表里使用此应用的用户信息,app可以提示:你的联系人里某某也正在使用,是否添加好友

开发者可以在用户验证手机号码成功或注册成功后通过

+ (void) submitUserInfo:(SMSSDKUserInfo *)userInfo
                 result:(SMSSubmitUserInfoResultHandler)result;

上传该用户的信息,如头像,昵称等

如果另一个用户的通讯录联系人里有上传过的用户,开发者可以通过

+ (void) getAllContactFriends:(SMSGetContactsFriendsResultHandler)result;

获取到该好友的信息(验证的电话号码,区号,昵称,头像等)

  • ### 使用演示

开启通讯录好友功能

[SMSSDK enableAppContactFriends:YES];

在用户验证手机号后 提交用户的信息。

    [SMSSDK commitVerificationCode:@"1234" phoneNumber:@"13800138000" zone:@"86" result:^(NSError *error) {

        if (!error)
        {
            // 验证成功,注册逻辑
            // 注册成功
            SMSSDKUserInfo *user = [[SMSSDKUserInfo alloc] init];
            user.phone = @"13800138000";
            user.zone = @"1234";
            user.avatar = @"http://www.mob.com/public/images/logo_black.png";
            user.nickname = @"Max";
            user.uid = @"123456789" //开发者可以绑定自已app用户的id

            [SMSSDK submitUserInfo:user result:^(NSError *error) {
                if (!error)
                {
                    //上传成功
                }
            }];
        }
        else
        {
            // error
        }
    }];

获取通讯录联系人中使用该app的用户(通讯录好友)

返回的信息即上面上传的userinfo.

    [SMSSDK getAllContactFriends:^(NSError *error, NSArray *friendsArray) {

        if (!error)
        {
            NSLog(@"%@",friendsArray);
        }

    }];