Android開發之短信驗證碼示例
在說Android中的短信驗證碼這個知識點前,我們首先來了解下聚合數據。
聚合數據介紹
聚合數據是一家國內***的基礎數據API提供商,專業從事互聯網數據服務。免費提供從天氣查詢、空氣質量、地圖坐標到金融基金、電商比價、違章查詢等各個領域的安全、穩定和高效的數據。開發者可以免費試用聚合數據API進行移動APP的快速開發,免除數據收集、維護等環節,大大降低開發周期及成本。因此我們可以采用聚合數據給我提供好的一套東西來進行短信驗證碼的功能的添加。
首先我們要做準備工作,使用聚合數據主要分為以下步驟:
***步,注冊聚合數據
進入聚合數據官網(https://www.juhe.cn/)注冊一個賬號,完成注冊后進入,"個人中心"——>“我的數據”點擊申請數據如下圖所示:
第二步,申請Appkey
申請后你會得到一個Appkey,此Appkey非常重要。
第三步,下載SDK
下載地址:https://www.juhe.cn/juhesdk
第四步,創建工程,配置環境
1.創建一個工程把我們下載的SDK里libs下的“armeabi文件”和"smscaptcha_v_1_4.jar"復制到我們工程的libs目錄下
2.在AndroidManifest中添加開發密鑰、所需權限等信息
(1)在application中添加開發密鑰
- <meta-data
- android:name="JUHE_KEY"
- android:value="開發者 key" />
(2)添加所需權限
- <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
- <uses-permission android:name="android.permission.INTERNET" />
- <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
- <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION " />
- <uses-permission android:name="android.permission.READ_FINE_LOCATION" />
- <uses-permission android:name="android.permission.READ_PHONE_STATE" />
- <uses-permission android:name="android.permission.READ_CONTACTS" />
(3)在應用程序創建時初始化 SDK引用的Context全局變量
在這一步我們有兩種方法
***種在Activity中配置
- public class MainActivity extends Activity {
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- //在使用SDK各組件之前初始化context信息,傳入ApplicationContext
- //注意該方法要再setContentView方法之前實現
- /**
- * 初始化方法
- * @param context
- * @needFriends 是否需要好友功能
- */
- CommonFun.initialize(getApplicationContext(),true);
- setContentView(R.layout.activity_main);
- }
- }
下面這個注意是聚合數據文檔給我們的建議,它建議我們把這個初始化工作放在Application中,因為程序運行首先會運行Application中的方法
注意:在SDK各功能組件使用之前都需要調用CommonFun.initialize(getApplicationContext(),true);,因此我們建議該方法放在Application的初始化方法中
所以我們就按它建議的方法,而不采用***種方法這樣我們需要創建一個Applicaiton類MyApplication如下
- package com.example.android.sms;
- import com.thinkland.sdk.util.CommonFun;
- import android.app.Application;
- public class MyApplication extends Application {
- @Override
- public void onCreate() {
- super.onCreate();
- CommonFun.initialize(getApplicationContext(), false);
- }
- }
聲明好Application后不要忘了在清單文件中配置
好了環境已經配置好了,我們來驗證一下看看我們是否能收到短信MainActivity的代碼如下
- package com.example.android.sms;
- import com.thinkland.sdk.sms.SMSCaptcha;
- import com.thinkland.sdk.util.BaseData;
- import com.thinkland.sdk.util.CommonFun;
- import android.os.Bundle;
- import android.app.Activity;
- import android.util.Log;
- import android.view.Menu;
- import android.widget.Toast;
- public class MainActivity extends Activity {
- protected static final String TAG ="MainActivity";
- @Override
- protected void onCreate(Bundle savedInstanceState) {
- super.onCreate(savedInstanceState);
- setContentView(R.layout.activity_main);
- //初始化 SMSCaptcha對象在這個對象中有給我們發送短信驗證碼的方法
- SMSCaptcha smsCaptcha=SMSCaptcha.getInstance();
- //調用發送短信驗證碼的方法,在其中有一個回調
- /**
- phone 手機號碼
- callBack 返回結果回調方法.
- */
- smsCaptcha.sendCaptcha("此處輸入你的手機號",new BaseData.ResultCallBack() {
- @Override
- public void onResult(int code, String reason, String result) {
- /*
- code:返回碼:
- 服務器: 0 成功; 1 錯誤;
- 本地: -2 本地網絡異常; -3 服務器網絡異常;-4 解析錯誤;-5初始化異常
- reason:返回信息 成功或錯誤原因.
- result:返回結果,JSON格式.錯誤或者無返回值時為空.*/
- if(code==0){
- Log.i(TAG,"code="+code);
- Log.i(TAG,"reason="+reason);
- Log.i(TAG,"result="+result);
- }
- }
- });
- }
- }
返回結果如下:
第五步:完整的功能的實現,以及界面UI的實現
首先我們來看下界面***個界面
我們在這個界面輸入手機號,及短信的目的地,點擊下一步后會彈出一個Dialog
點擊確定后會調用會調用聚合數據給我們提供的sendCaptcha方法
- /*點擊確定后調用sendCaptcha方法向服務器提交手機號碼
- code(返回碼):
- 服務器:0 成功,1 錯誤;
- 本 地:-2 本地網絡異常,-3 服務器網絡異常,-4 解析錯誤,-5 初始化異常。
- reason(返回信息):成功或錯誤的原因。
- result(返回結果):JSON格式,錯誤或者無返回值時為空。
- */
- smsCaptcha.sendCaptcha(phone,new ResultCallBack() {
- @Override
- public void onResult(int code, String reason, String result) {
- closeDialog();
- if(code==0){
- afterCapterRequested();
- }
- }
- );
當返回的code==0時說明短信驗證碼發送成功,我們需要進行界面的跳轉,代碼如下
- //當code=0成功時,跳轉到輸入驗證碼的Activity
- private void afterCapterRequested() {
- String phone=etPhoneNumber.getText().toString().trim().replaceAll("\\ss*",
- "");
- String code=tvCountryNumber.getText().toString().trim();
- String fomatedPhone=code+" "+splitPhoneNum(phone);
- Toast.makeText(this,"成功",Toast.LENGTH_SHORT).show();
- Intent intent=new Intent();
- intent.setClass(RegistActivity.this,CaptchaActivity.class);
- //把手機號碼和格式化的手機號碼傳過去
- intent.putExtra("formatedPhone",fomatedPhone);
- intent.putExtra("phone",phone);
- startActivity(intent);
- }
- //格式化手機號碼的方法,格式化后的形式:+86 131 4118 2951
- private String splitPhoneNum(String phone) {
- StringBuilder builder=new StringBuilder(phone);
- builder.reverse();
- for(int i=4,len=builder.length();i<len;i+=5){
- builder.insert(i,' ');
- }
- builder.reverse();
- return builder.toString();
- }
跳轉的界面的布局如下
在這個界面我們需要輸入短信驗證碼,輸入短信驗證碼后點擊下一步時會調用聚合數據的commitCaptcha這個方法,比對數據的方法,
- smsCaptcha.commitCaptcha(phoneNumbber,verfiyCode,new ResultCallBack() {
- /*
- code:返回碼:
- 服務器: 0 成功; 1 錯誤;
- 本地: -2 本地網絡異常; -3 服務器網絡異常;-4 解析錯誤;-5初始化異常
- reason:返回信息 成功或錯誤原因.
- result:返回結果,JSON格式.錯誤或者無返回值時為空.*/
- @Override
- public void onResult(int code,String reason,String result) {
- if(code==0){
- Log.i(TAG,code+"");
- Log.i(TAG,reason);
- Log.i(TAG,result);
- Toast.makeText(CaptchaActivity.this,"您輸入的驗證碼正確",Toast.LENGTH_SHORT).show();
- CaptchaActivity.this.finish();
- }else{
- Toast.makeText(CaptchaActivity.this,"您輸入的驗證碼不正確",Toast.LENGTH_SHORT).show();
- }
- }
- });
我們可以看到這個方法所需的參數是①手機號碼②手機驗證碼,我們調用此方法后聚合數據的服務器會進行判斷,此驗證碼是否是剛才發送給這個手機號的驗證碼,驗證后給我返回結果,我們根據返回的結果就可以進行相應的操作。在上面的界面中我們發現有一個倒計時的功能,我在這里說一下思路,當然這個倒計時方法有很多。在這個Demo中倒計時是放在一個tvCountDown的一個textView中,首先
- //R.string.receiveMessgeCountDown的內容為:<Data>接收短信大約需要<font color=#209526>%s</font>秒</Data>
- //這句話就是用time把 html里的%號替換掉
- String unReceive=getResources().getString(R.string. receiveMessgeCountDown,time );
- //把用html格式化的字符串設置給倒計時的文本框
- tvCountDown.setText(Html.fromHtml(unReceive));
這樣我們可以把html格式化的文本填充到tvCountDown中。接下來就是倒計時的方法了
- private final int RETRY_INTERVAL =60;
- private int time=RETRY_INTERVAL;
- //倒計時方法
- private void countDown() {
- new Thread( new Runnable() {
- @Override
- public void run() {
- while( time-->0){
- //減一后的time把<Data>接收短信大約需要<font color=#209526>%s</font>秒</Data>中的%號替換掉
- String countDownTime=CaptchaActivity.this .getResources().getString(R.string. receiveMessgeCountDown,time );
- //在主線程上更新tvCountDown
- upDateTvCountDown(countDownTime);
- try {
- Thread. sleep(1000);
- } catch (InterruptedException e) {
- e.printStackTrace();
- }
- }
- String countDownTime=CaptchaActivity.this .getResources().getString(R.string. unreceiveMessage, time);
- upDateTvCountDown(countDownTime);
- time = RETRY_INTERVAL;
- }
- }).start();
- }
- //在主線程上更新tvCountDown
- private void upDateTvCountDown(final String countDownTime) {
- runOnUiThread( new Runnable() {
- @Override
- public void run() {
- tvCountDown.setText(Html. fromHtml(countDownTime));
- tvCountDown.setEnabled( false);
- }
- });
- }
總結:其實使用聚合數據的短信驗證碼功能,主要就兩個方法,一個是獲取驗證碼的方法sendCaptcha,一個是提交驗證碼進行驗證的方法commitCaptcha。我們在此基礎上,可以根據需求對界面進行更改。以上就是對短信驗證碼的主要邏輯進行的介紹。