写点什么

MobTech SMSSDK iOS 端快速集成指南

  • 2022 年 9 月 01 日
    上海
  • 本文字数:1977 字

    阅读完需:约 6 分钟

开发工具:Xcode 集成方式:手动导入 SDK 或者 Pod 集成 SDK 版本支持:SDK 支持 Xcode 9.1.0, iOS8.0+及以上版本

集成前准备

注册账号

使用 SMSSDK 之前,您需要在 MobTech 官网注册开发者账号,添加应用并获取 Mob 提供的 AppKey 和 AppSecret,详情可以点击查看注册流程

SMSSDK 流程图



添加配置

下载 SDK 导入项目

(1)手动下载 SDK 引入

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


将下图中红色框标记的文件夹(包含 MOBFoundation.framework 和 SMS_SDK.framework)拖入到工程中


确认勾选,点击 finish 完成导入


(2)CocoaPods 方式引入

通过 CocoaPods 进行安装,只需在 Podfile 文件中添加:

pod 'mob_smssdk'
复制代码

添加之后执行 pod install / pod update 命令即可。

添加依赖库



必要:

  • libz.tbd

  • libicucore.tbd

  • MessageUI.framework

  • JavaScriptCore.framework

  • libc++.tbd

  • 注意:在 XCode7 上面运行报错的话,还需要增加这几个依赖库

  • SystemConfiguration.framework

  • CoreTelephony.framework

  • AdSupport.framework


接口调用

回传用户隐私授权结果(uploadPrivacyPermissionStatus)

为保证您的 App 在集成 MobSDK 之后能够满足工信部相关合规要求,您应确保 App 安装首次冷启动且取得用户阅读您《隐私政策》授权之后,调用 Mob 提交到的隐私协议回传函数 uploadPrivacyPermissionStatus 回传隐私协议授权结果。

反之,如果用户不同意您 App《隐私政策》授权,则不能调用 uploadPrivacyPermissionStatus 回传隐私协议授权结果。

相关隐私声明请参考这个链接合规指南

/** 上传隐私协议授权状态 @param isAgree 是否同意(用户授权后的结果) @param OnResult 执行回调结果,可为nil (注意业务逻辑不要依赖于这个success结果,建议业务逻辑在调用这个接口之后来写) */+ (void)uploadPrivacyPermissionStatus:(BOOL)isAgree                                                 onResult:(void (^_Nullable)(BOOL success))handler;
复制代码

示例代码

#import <MOBFoundation/MobSDK+Privacy.h>[MobSDK uploadPrivacyPermissionStatus:YES onResult:^(BOOL success) {}];
复制代码

请求短信验证码(getVerificationCodeByMethod)

/** *  @from                    v3.1.0 *  @brief                   获取验证码(Get verification code) * *  @param method            获取验证码的方法(The method of getting verificationCode) *  @param phoneNumber       电话号码(The phone number) *  @param zone              区域号,不要加"+"号(Area code) *  @param tmpCode           模板id(template id) *  @param result            请求结果回调(Results of the request) */+ (void) getVerificationCodeByMethod:(SMSGetCodeMethod)method                                      phoneNumber:(NSString *)phoneNumber                                                     zone:(NSString *)zone                                               template:(NSString *)tmpCode                                                    result:(SMSGetCodeResultHandler)result;
复制代码

示例代码

#import <SMS_SDK/SMSSDK.h>  //template参数不能乱填,没有可以先传""或者nil  [SMSSDK getVerificationCodeByMethod:SMSGetCodeMethodSMS phoneNumber:@"XXXXXXXXXXX" zone:@"86" template:@"" result:^(NSError *error) {        if (!error)        {            // 请求成功        }        else        {            // error        }    }];
复制代码

注: 模板 id 在官网后台 SMSSDK 产品下的短信模版里面添加(需要申请过自定义短信签名的应用才能添加短信模板)


提交验证码验证(commitVerificationCode)

/** * @from                    v1.1.1 * @brief                   提交验证码(Commit the verification code) * * @param code              验证码(Verification code) * @param phoneNumber       电话号码(The phone number) * @param zone              区域号,不要加"+"号(Area code) * @param result            请求结果回调(Results of the request) */+ (void) commitVerificationCode:(NSString *)code                            phoneNumber:(NSString *)phoneNumber                                           zone:(NSString *)zone                                          result:(SMSCommitCodeResultHandler)result;
复制代码

示例代码

[SMSSDK commitVerificationCode:@"XXXX" phoneNumber:@"XXXXXXXXXXX" zone:@"86"result:^(NSError *error) {        if (!error)        {            // 验证成功        }        else        {            // error        }    }];
复制代码

**注意:必须要自己重新自定义签名,默认签名仅用于测试,不保证到达率,上线前请务必申请自定义签名使用

用户头像

还未添加个人签名 2019.05.08 加入

还未添加个人简介

评论

发布
暂无评论
MobTech SMSSDK iOS端快速集成指南_ios_MobTech袤博科技_InfoQ写作社区