开发工具: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 } }];
复制代码
**注意:必须要自己重新自定义签名,默认签名仅用于测试,不保证到达率,上线前请务必申请自定义签名使用
评论