开发工具: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 install / pod update 命令即可。
添加依赖库
必要:
接口调用
回传用户隐私授权结果(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
}
}];
复制代码
**注意:必须要自己重新自定义签名,默认签名仅用于测试,不保证到达率,上线前请务必申请自定义签名使用
评论