帮助与文档

> >

一、无GUI接口概述

github demo,旧版SMSDemo
本文只介绍短信SDK内置(无界面)方法的使用和注意事项,如果您想查阅有界面的操作方法,请参考“短信SDK集成文档”相关章节的说明。

尽管短信SDK提供了简化集成步骤的GUI功能,但它同样允许开发者放弃这套GUI,直接与核心代码进行交互。
Studio: MobCommons-xxx.jar,MobTools-xxx.jar,SMSSDK-<版本号>.aar
Eclipse:短信SDK的核心代码存放于 SMSSDK/libs中的“SMSSDK-<版本号>.jar”,集成的时候除了将SMSSDK-<版本号>.jar复制到自己的工程libs下,还要复制MobCommons-xxx.jar,MobTools-xxx.jar和资源文件,还有如果版本等于2.0.1,要SMSSDK的res下的raw要复制到你的工程的res下;另外有些版本需要复制libsmssdk.so。注意:2.1.2开始(包括)eclipse不需要配置so,只需要三个jar包就可以了。
其中对外主要的类有:SMSSDK和EventHandler,所有的操 作都通过SMSSDK来发起,并通过EventHandler来接收。由于EventHandler已有SMSSDK操作回调章节讲述,因此本节之着重介绍SMSSDK的各个方法。

二、无GUI接口说明

2.1、初始化接口

限定符和类型 方法和说明
static void initSDK(Context context, String appkey, String appSecrect)//3.0之前SMSSDK版本的初始化

//3.0版本之后的初始化看这里(包括3.0)

初始化SDK,单例,可以多次调用;任何方法调用前,必须先初始化

static void registerEventHandler(EventHandler handler)
注册回调接口
static void unregisterEventHandler(EventHandler handler)
注销回调接口


registerEventHandler
用来往SMSSDK中注册一个事件接收器,SMSSDK允许开发者注册任意数量的接收器,所有接收器都会在事件 被触发时收到消息。

 

registerEventHandler必须和unregisterEventHandler配套使用,否则可能造成内存泄漏。

2.2、短信验证码接口

限定符和类型 方法和说明
static void getSupportedCountries()
获取短信目前支持的国家列表,在监听中返回
static void getVerificationCode(String country, String phone)
getVerificationCode(String country, String phone, OnSendMessageHandler listener)
请求获取短信验证码,在监听中返回
static void submitVerificationCode(String country, String phone, String code)
提交短信验证码,在监听中返回

其中OnSendMessageHandler的定义如下,这个Handler的用途是在发送短信之前,开发者自己执行一个操作,来根据电话号码判断是否需要发送短信

短信SDK并不能支持世界上所有国家的短信验证服务,因此我们提供了getSupportedCountries方法,在使用短信验证码功能前请调用此方法,获取当前SDK可以支持的国家列表和号码匹配规则。
getVerificationCode用于向服务器请求发送验证码的服务,需要传递国家代号和接收验证码的手机号码,支持此服务的国家代码在 getSupportedCountries中获取。请求getVerificationCode的时间间隔不应该小于60秒,否则服务端会返回“操作过 于频繁”的错误
submitVerificationCode用于向服务器提交接收到的短信验证码,验证成功后会通过EventHandler返回国家代码和电话号码。

0 7

相关文档