当前很多APP都有短信验证的功能,如:帐号与手机号绑定的时候,通过短信验证的方式确认身份。那么该如何实现这个功能呢。
先简单说一下流程
第一步:获取短信验证码SDK
第二步:导入SDK(倒入后,主函数中使用getStringRes函数会报错)
第三步:配置AndroidMainifest.xml
第四步:添加代码
首先先看一下布局界面
通过这样的界面来简单的实现短信验证的功能。
第一步:获取获取短信验证码SDK
进入Mob官网,点击SDK下载---短信验证码SDK---SMS For Android---SDK下载(Eclipse)
下载成功后,解压文件,得到ShortMessageSDKGUI和SMSSDK两个文件。
第二步:导入SDK
在eclipse中导入解压后得到的两个文件。短信SDK在Eclipse中使用项目依赖的方式完成集成。将文件倒入后,右键我们要做的项目,选择“属性”,在弹出的窗口中侧栏选择"Andriod“并且在引用中选择ShortMessageSDKGUI和SMSSDK。
注意:文件的编码格式选为 UTF-8 不然会出现各种乱码和错误。
第三步:配置AndroidMainifest.xml
添加权限:
<uses-permission android:name="android.permission.READ_CONTACTS" />
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.RECEIVE_SMS" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
第四部:添加代码
知识储备:
SMSSDK发起
EventHandler接受
1 初始化接口
所有的操作都是通过SMSSDK来发起,并通过EventHandler来接受。
1.1 initSDK
短信SDK的入口,需要传递您从ShareSDK应用管理后台中注册的应用AppKey和AppSecrete,如果填写错误,后续的操作都将不能进行。(其中的appkey和appsecret需要在Mob官网登录帐号之后,点击头像进入后台中的SecurityCodeSDK中查看。)
1.2 registerEventHandler
用来往SMSSDK中注册一个事件接收器,SMSSDK允许开发者注册任意数量的接收器,所有接收器都会在事件 被触发时收到消息。
SMSSDK.initSDK(this,APPKEY,APPSECRET);
EventHandler eh=new EventHandler(){
@Override
public void afterEvent(int event, int result, Object data) {
if (result == SMSSDK.RESULT_COMPLETE) {
//回调完成
if (event == SMSSDK.EVENT_SUBMIT_VERIFICATION_CODE) {
//提交验证码成功
}else if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE){
//获取验证码成功
}else if (event ==SMSSDK.EVENT_GET_SUPPORTED_COUNTRIES){
//返回支持发送验证码的国家列表
}
}else{
((Throwable)data).printStackTrace();
}
}
};
SMSSDK.registerEventHandler(eh); //注册短信回调
1.3 unregisterEventHandler
反注册函数,registerEventHandler 必须和unregisterEventHandler配套使用,否则可能造成内存泄漏。
2.短信验证码接口
其中OnSendMessageHandler的定义如下,这个Handler的用途是在发送短信之前,开发者自己执行一个操作,来根据电话号码判断是否需要发送短信
public interface OnSendMessageHandler {
//#if def{lang} == cn
/**
* 此方法在发送验证短信前被调用,传入参数为接收者号码
* 返回true表示此号码无须实际接收短信
*/
//#elif def{lang} == en
/**
* This method will be called before verification message being to sent,
* input params are the message receiver
* return true means this number won't actually receive the message
*/
//#endif
public boolean onSendMessage(String country, String phone);
}
2.1 getSupportedCountries
短信SDK并不能支持世界上所有国家的短信验证服务,因此我们提供了getSupportedCountries方法,在使用短信验证码功能前请调用此方法,获取当前SDK可以支持的国家列表和号码匹配规则。
2.2 getVerificationCode
getVerificationCode用于向服务器请求发送验证码的服务,需要传递国家代号和接收验证码的手机号码,支持此服务的国家代码在 getSupportedCountries中获取。
2.3 getVerificationCode
请求getVerificationCode的时间间隔不应该小于60秒,否则服务端会返回“操作过 于频繁”的错误
2.4 submitVerificationCode
submitVerificationCode用于向服务器提交接收到的短信验证码,验证成功后会通过EventHandler返回国家代码和电话号码。
****这里我们主要用到两个函数
getVerificationCode来向服务器请求发送验证码
submitVerificationCode向服务器提交接收到的短信验证码
3.Android 短信SDK操作回调
3.1注册回调:
SMSSDK.unregisterEventHandler(EventHandler);
3.2其中的EventHandler即为操作回调。它包括4个方法,分别为:
public void onRegister();
public void beforeEvent(int event, Object data);
public void afterEvent(int event, int result, Object data);
public void onUnregister();
3.2.1 onRegister
在回调对象注册的时候被触发。
3.2.2 beforeEvent
在操作执行前被触发,其参数event表示操作的类型,data是从外部传入的数据
3.2.3 afterEvent
在操作结束时被触发,同样具备event和data参数,但是data是事件操作结果,其具体取值根据参数result而定。result是操作结果,为SMSSDK.RESULT_COMPLETE表示操作成功,为SMSSDK.RESULT_ERROR表示操作失败。
---------------------------------------------------------------------------------割-----------------------------------------------------------------------------------------
1) 当result=SMSSDK.RESULT_ERROR,则data的类型为Throwable;如果服务器有返回错误码,那么这个Throwable的message就存放着服务器返回的json数据,你可以从中读取相关信息。示例如下:
//#if def{lang} == cn
// 根据服务器返回的网络错误,给toast提示
//#elif def{lang} == en
// show toast according to the error code
//#endif
try {
Throwable throwable = (Throwable) data;
throwable.printStackTrace();
JSONObject object = new JSONObject(throwable.getMessage());
String des = object.optString("detail");//错误描述
int status = object.optInt("status");//错误代码
if (status > 0 && !TextUtils.isEmpty(des)) {
Toast.makeText(activity, des, Toast.LENGTH_SHORT).show();
return;
}
} catch (Exception e) {
//do something
}
2) 当result=SMSSDK.RESULT_COMPLETE,则data的类型如下表所示。onUnregister在被反注册的时候被触发。
短信SDK采用“广播”的方式发送操作结果。这就是说,每次调用registerEventHandler都会设置一个新的EventHandler到SDK内部,当事件发生时,这些注册进来的EventHandler都能收到信息而不会发生“后者替换前者”的问题。为了避免EventHandler注册后不再使用而造成内存泄漏,请务必在确定不使用某个EventHandler时,调用反注册代码将其注销,反注册的方法为:
SMSSDK.unregisterEventHandler(EventHandler);
在EventHandler的4个回调方法都可能不在UI线程下,因此如果要在其中执行UI操作,请务必使用Handler发送一个消息给UI线程处理。
---------------------------------------------------------------------------------割-----------------------------------------------------------------------------------------
大概的框架:
1.获取验证码按钮:
添加监听器,监听器中调用SMSSDK.getVerificationCode(String arg0, String arg1)
其中参数arg0是国家编号,arg1是手机号码
2.验证按钮:
添加监听器,监听器中调用SMSSDK.submitVerificationCode(String arg0, String arg1, String arg2);
其中参数arg0是国家编号,arg1是手机号,arg2是填写的验证码
3.onCreate()中:
3.1SMSSDK.initSDK(Context arg0, String arg1, String arg2)
3.2 新建一个EventHandler对象,实现里面的afterEvent(int event, int result, Object data)函数,来获取
最后SMSSDK.registerEventHandler(EventHandler arg0)
4.类中:
1.首先一定要写一个EventHandler的反注册函数。但是是需要在确定不使用这个EventHandler对象的时候,那么在这个Activity结束的时候,肯定不用了,这里覆盖: Activity 中的 onDestroy()方法,在方法中添加SMSSDK.unregisterAllEventHandler();来实现反注册。
2.这里还写了两个Handler对象,重写public void handleMessage (Message msg)放来,来获取验证信息的状态。一个对象来改变获取验证码按钮的可点击的属性,来防止获取验证码过于频繁。另一个对象获取信息后,通过返回的结果来判断是否验证成功。
------------------------------------------------------------------------------------------割-----------------------------------------------------------------------------------------------------
下面给出具体的布局文件和Java代码,如果有不对的地方欢迎评论。
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@drawable/a"
tools:context=".MainActivity" >
<TextView
android:id="@+id/textView2"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_centerHorizontal="true"
android:layout_marginTop="20dp"
android:text="短信验证"
android:textSize="20dp" />
<TextView
android:id="@+id/textView1"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentLeft="true"
android:layout_below="@+id/textView2"
android:layout_marginLeft="20dp"
android:layout_marginTop="20dp"
android:text="手机号:" />
<!-- 手机号 -->
<EditText
android:id="@+id/phone"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/textView1"
android:layout_alignBottom="@+id/textView1"
android:layout_toRightOf="@+id/textView1"
android:ems="11"
android:inputType="phone"
android:maxLength="11" >
<requestFocus />
</EditText>
<TextView
android:id="@+id/textView3"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignLeft="@+id/textView1"
android:layout_below="@+id/phone"
android:layout_marginTop="40dp"
android:text="验证码:" />
<!-- 验证码 -->
<EditText
android:id="@+id/cord"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignBaseline="@+id/textView3"
android:layout_alignBottom="@+id/textView3"
android:layout_alignLeft="@+id/phone"
android:layout_marginTop="20dp"
android:ems="4"
android:inputType="phone"
android:maxLength="4" />
<!-- 获取验证码按钮 -->
<Button
android:id="@+id/getcord"
style="?android:attr/buttonStyleSmall"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignTop="@+id/cord"
android:layout_marginLeft="20dp"
android:layout_marginTop="10dp"
android:layout_toRightOf="@+id/cord"
android:text="获取验证码"
android:visibility="visible" />
<!-- 验证按钮 -->
<Button
android:id="@+id/savecord"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_below="@+id/cord"
android:layout_margin="20dp"
android:text="验证" />
<!-- 提示信息 -->
<TextView
android:id="@+id/now"
android:layout_width="fill_parent"
android:layout_height="wrap_content"
android:layout_above="@+id/savecord"
android:layout_toRightOf="@+id/cord"
android:gravity="center_horizontal"
android:text="提示信息"
android:textColor="#aaaaaa"
android:visibility="gone" />
</RelativeLayout>
package com.example.testyzm;
import static com.mob.tools.utils.R.getStringRes;
import cn.smssdk.EventHandler;
import cn.smssdk.SMSSDK;
import android.app.Activity;
import android.os.Bundle;
import android.os.Handler;
import android.os.Message;
import android.text.TextUtils;
import android.util.Log;
import android.view.View;
import android.view.View.OnClickListener;
import android.widget.Button;
import android.widget.EditText;
import android.widget.TextView;
import android.widget.Toast;
public class MainActivity extends Activity implements OnClickListener {
private EditText phone; // 手机号
private EditText cord; // 验证码
private TextView now; // 提示信息
private Button getCord; // 获取验证码按钮
private Button saveCord;// 验证按钮
private String iPhone;
private String iCord;
private int time = 60;
private boolean flag = true;// 验证码是否正确标记
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取控件
getView();
SMSSDK.initSDK(this, "1914d1e0f1a38",
"658801a43e091a2f650c349eb9e62425");
EventHandler eh = new EventHandler() {
@Override
public void afterEvent(int event, int result, Object data) {
Message msg = new Message();
msg.arg1 = event;
msg.arg2 = result;
msg.obj = data;
handler.sendMessage(msg);
}
};
SMSSDK.registerEventHandler(eh);
}
// 获取控件
private void getView() {
phone = (EditText) findViewById(R.id.phone);
cord = (EditText) findViewById(R.id.cord);
now = (TextView) findViewById(R.id.now);
getCord = (Button) findViewById(R.id.getcord);
saveCord = (Button) findViewById(R.id.savecord);
getCord.setOnClickListener(this);
saveCord.setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.getcord:
if (!TextUtils.isEmpty(phone.getText().toString().trim())) {
if (phone.getText().toString().trim().length() == 11) {
iPhone = phone.getText().toString().trim();
//请求获取短信验证码 在监听中返回
SMSSDK.getVerificationCode("86", iPhone);
cord.requestFocus();
getCord.setVisibility(View.GONE);
} else {
Toast.makeText(MainActivity.this, "请输入完整电话号码",
Toast.LENGTH_LONG).show();
phone.requestFocus();
}
} else {
Toast.makeText(MainActivity.this, "请输入您的电话号码",
Toast.LENGTH_LONG).show();
phone.requestFocus();
}
break;
case R.id.savecord:
if (!TextUtils.isEmpty(cord.getText().toString().trim())) {
if (cord.getText().toString().trim().length() == 4) {
iCord = cord.getText().toString().trim();
//提交短信验证码 在监听中返回
SMSSDK.submitVerificationCode("86", iPhone, iCord);
flag = false;
} else {
Toast.makeText(MainActivity.this, "请输入完整验证码",
Toast.LENGTH_LONG).show();
cord.requestFocus();
}
} else {
Toast.makeText(MainActivity.this, "请输入验证码", Toast.LENGTH_LONG)
.show();
cord.requestFocus();
}
break;
default:
break;
}
}
// 验证码送成功后提示文字
private void reminderText() {
now.setVisibility(View.VISIBLE);
handlerText.sendEmptyMessageDelayed(1, 1000);
}
Handler handlerText = new Handler() {
public void handleMessage(Message msg) {
if (msg.what == 1) {
if (time > 0) {
now.setText("验证码已发送" + time + "秒");
time--;
handlerText.sendEmptyMessageDelayed(1, 1000);
} else {
now.setText("提示信息");
time = 60;
now.setVisibility(View.GONE);
getCord.setVisibility(View.VISIBLE);
}
} else {
cord.setText("");
now.setText("提示信息");
time = 60;
now.setVisibility(View.GONE);
getCord.setVisibility(View.VISIBLE);
}
};
};
Handler handler = new Handler() {
@Override
public void handleMessage(Message msg) {
// TODO Auto-generated method stub
super.handleMessage(msg);
int event = msg.arg1;
int result = msg.arg2;
Object data = msg.obj;
Log.e("event", "event=" + event);
if (result == SMSSDK.RESULT_COMPLETE) {
if (event == SMSSDK.EVENT_SUBMIT_VERIFICATION_CODE) {// 提交验证码成功,验证通过
Toast.makeText(getApplicationContext(), "验证码校验成功",
Toast.LENGTH_SHORT).show();
handlerText.sendEmptyMessage(2);
} else if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE) {// 服务器验证码发送成功
reminderText();
Toast.makeText(getApplicationContext(), "验证码已经发送",
Toast.LENGTH_SHORT).show();
} else if (event == SMSSDK.EVENT_GET_SUPPORTED_COUNTRIES) {// 返回支持发送验证码的国家列表
Toast.makeText(getApplicationContext(), "获取国家列表成功",
Toast.LENGTH_SHORT).show();
}
} else {
if (flag) {
getCord.setVisibility(View.VISIBLE);
Toast.makeText(MainActivity.this, "验证码获取失败,请重新获取",
Toast.LENGTH_SHORT).show();
phone.requestFocus();
} else {
((Throwable) data).printStackTrace();
int resId = getStringRes(MainActivity.this,
"smssdk_network_error");
Toast.makeText(MainActivity.this, "验证码错误",
Toast.LENGTH_SHORT).show();
cord.selectAll();
if (resId > 0) {
Toast.makeText(MainActivity.this, resId,
Toast.LENGTH_SHORT).show();
}
}
}
}
};
@Override
protected void onDestroy() {
super.onDestroy();
SMSSDK.unregisterAllEventHandler();
}
}