移动开发 - Android - 实现获取短信验证码(Eclipse IDE版)

当前很多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();
	}

}