和室友參加的互聯網大賽要做一個 APP,涉及到用戶的登錄注冊,于是上網找了許多資料,其中有阿里大于,網易云等等,阿里大于的客服給我說他們不支持 Android,網易云還要拍手持身份證的照片,而且這兩個都收費,還麻煩,于是找了一個既簡單有免費的,叫做 Mob,官網如下
官方文檔看了很多,還是覺得寫的不好,于是自己寫一篇。
注冊賬號
在 Mob 官網右上角點擊注冊,依次填入信息,其中公司一欄可以隨便填
添加應用
登錄后,點擊 SecurityCodeSDK - 立即使用,Mob 會提示你添加應用,名字自己填,再選 Android,添加完后再點擊 SecurityCodeSDk - 進入,之后應該可以看到如下界面
AppKey 和 AppSecret 一會會用到
下載 SDK
在網頁上方“下載SDK”中點擊“免費短信驗證碼SDK”,網頁跳轉后找到“短信驗證碼SDK”,根據需要選擇系統吧,我做的 Android 就選 Android,網頁跳轉后根據需要選擇 AndroidStudio 或者 eclipse,在屏幕右方選擇,選好后點擊即可開始下載。
下好后解壓,打開文件夾,目錄結構如下
要用到的 SDK 在 SMSSDK 文件夾中
導入 SDK 到工程目錄
打開 SMSSDK 文件夾,把兩個 .jar 和 .aar 文件復制到工程目錄中 libs 文件夾下,如圖所示
粘貼進去后,選中兩個 .jar 文件,右鍵點擊,選擇 add as library
再打開 app 目錄下的 build.gradle,添加如下兩處內容
repositories{
flatDir{
dirs 'libs'
}
}
compile name:'SMSSDK-2.1.4',ext:'aar'
compile name:'SMSSDKGUI-2.1.4',ext:'aar'
最后看起來是這樣的
添加的代碼為 22-26 行和 36-37 行。
打開 AndroidManifest.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.READ_SMS" />
<uses-permission android:name="android.permission.GET_TASKS" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
程序代碼
先把完整代碼貼出來(沒貼 xml,這個不影響)
public class Register extends AppCompatActivity implements View.OnClickListener {
private EditText etPhoneNumber; // 電話號碼
private Button sendVerificationCode; // 發送驗證碼
private EditText etVerificationCode; // 驗證碼
private Button nextStep; // 下一步
private String phoneNumber; // 電話號碼
private String verificationCode; // 驗證碼
private boolean flag; // 操作是否成功
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_register);
init(); // 初始化控件、注冊點擊事件
final Context context = Register.this; // context
final String AppKey = "你的 AppKey"; // AppKey
final String AppSecret = "你的 AppSecret"; // AppSecret
SMSSDK.initSDK(context, AppKey, AppSecret); // 初始化 SDK 單例,可以多次調用
EventHandler eventHandler = 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(eventHandler); // 注冊回調接口
}
private void init() {
etPhoneNumber = (EditText) findViewById(R.id.edit_phone_number);
sendVerificationCode = (Button) findViewById(R.id.btn_send_verification_code);
etVerificationCode = (EditText) findViewById(R.id.edit_verification_code);
nextStep = (Button) findViewById(R.id.btn_next_step);
sendVerificationCode.setOnClickListener(this);
nextStep.setOnClickListener(this);
}
@Override
public void onClick(View v) {
switch (v.getId()) {
case R.id.btn_send_verification_code:
if (!TextUtils.isEmpty(etPhoneNumber.getText())) {
if (etPhoneNumber.getText().length() == 11) {
phoneNumber = etPhoneNumber.getText().toString();
SMSSDK.getVerificationCode("86", phoneNumber); // 發送驗證碼給號碼的 phoneNumber 的手機
etVerificationCode.requestFocus();
}
else {
Toast.makeText(this, "請輸入完整的電話號碼", Toast.LENGTH_SHORT).show();
etPhoneNumber.requestFocus();
}
} else {
Toast.makeText(this, "請輸入電話號碼", Toast.LENGTH_SHORT).show();
etPhoneNumber.requestFocus();
}
break;
case R.id.btn_next_step:
if (!TextUtils.isEmpty(etVerificationCode.getText())) {
if (etVerificationCode.getText().length() == 4) {
verificationCode = etVerificationCode.getText().toString();
SMSSDK.submitVerificationCode("86", phoneNumber, verificationCode);
flag = false;
} else {
Toast.makeText(this, "請輸入完整的驗證碼", Toast.LENGTH_SHORT).show();
etVerificationCode.requestFocus();
}
} else {
Toast.makeText(this, "請輸入驗證碼", Toast.LENGTH_SHORT).show();
etVerificationCode.requestFocus();
}
break;
default:
break;
}
}
Handler handler = new Handler() {
@Override
public void handleMessage(Message msg) {
super.handleMessage(msg);
int event = msg.arg1;
int result = msg.arg2;
Object data = msg.obj;
if (result == SMSSDK.RESULT_COMPLETE) {
// 如果操作成功
if (event == SMSSDK.EVENT_SUBMIT_VERIFICATION_CODE) {
// 校驗驗證碼,返回校驗的手機和國家代碼
Toast.makeText(Register.this, "驗證成功", Toast.LENGTH_SHORT).show();
Intent intent = new Intent(Register.this, MainActivity.class);
startActivity(intent);
} else if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE) {
// 獲取驗證碼成功,true為智能驗證,false為普通下發短信
Toast.makeText(Register.this, "驗證碼已發送", Toast.LENGTH_SHORT).show();
} else if (event == SMSSDK.EVENT_GET_SUPPORTED_COUNTRIES) {
// 返回支持發送驗證碼的國家列表
}
} else {
// 如果操作失敗
if (flag) {
Toast.makeText(Register.this, "驗證碼獲取失敗,請重新獲取", Toast.LENGTH_SHORT).show();
etPhoneNumber.requestFocus();
} else {
((Throwable) data).printStackTrace();
Toast.makeText(Register.this, "驗證碼錯誤", Toast.LENGTH_SHORT).show();
}
}
}
};
@Override
protected void onDestroy() {
super.onDestroy();
SMSSDK.unregisterAllEventHandler(); // 注銷回調接口
}
}
注意要把你的 AppKey 和 AppSecret 替換進去。
其實看過很多教程你會發現,很多時候并不是代碼看不懂,而是在配置文件的時候出了問題,因為一個剛接觸 Android 沒兩天的人是不可能對很多第三方 SDK 有需求的,一開始都是以基礎為主,所以需要配置第三方 SDK 的很多都是寫過一些 Android 代碼的人,他們所關心的其實就是該調用哪些方法來實現自己的目的,所以知道怎么調用就行了,再根據實際需求寫幾個 if-else 就可以了。
注意
SMSSDK.initSDK(context, AppKey, AppSecret); // 初始化 SDK 單例,可以多次調用
EventHandler eventHandler = 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(eventHandler); // 注冊回調接口
這幾行代碼是調用這個 SDK 的基礎,寫在 onCreate 中。
發送短信驗證碼的語句是
`SMSSDK.getVerificationCode("86", phoneNumber);`
phoneNumber 的取值取決于用戶輸入的號碼,“86”是中國的區號,根據需求也可以讓用戶自己選擇,稍微修改一下就行。
>```
if (result == SMSSDK.RESULT_COMPLETE) {
// 如果操作成功
if (event == SMSSDK.EVENT_SUBMIT_VERIFICATION_CODE) {
// 校驗驗證碼,返回校驗的手機和國家代碼
Toast.makeText(Register.this, "驗證成功", Toast.LENGTH_SHORT).show();
Intent intent = new Intent(Register.this, MainActivity.class);
startActivity(intent);
} else if (event == SMSSDK.EVENT_GET_VERIFICATION_CODE) {
// 獲取驗證碼成功,true為智能驗證,false為普通下發短信
Toast.makeText(Register.this, "驗證碼已發送", Toast.LENGTH_SHORT).show();
} else if (event == SMSSDK.EVENT_GET_SUPPORTED_COUNTRIES) {
// 返回支持發送驗證碼的國家列表
}
} else {
// 如果操作失敗
if (flag) {
Toast.makeText(Register.this, "驗證碼獲取失敗,請重新獲取", Toast.LENGTH_SHORT).show();
etPhoneNumber.requestFocus();
} else {
((Throwable) data).printStackTrace();
Toast.makeText(Register.this, "驗證碼錯誤", Toast.LENGTH_SHORT).show();
}
}
這幾行代碼判斷驗證碼發沒發送以及正不正確,根據 event 來確定是哪一種情況,如果想深入了解,可以參考官方文檔
當然,免費服務肯定收費的要差點,體現在短信發的比收費的慢,大概要十秒才能收到,收費的三秒就收到了,由于只是個比賽,自己做著玩,用免費的足矣。
另外,最開始免費的時候每天只能發 20 條短信,而且一個手機號每 12 小時只能收到 5 條,所以,省著點用,當然你可以在應用管理界面申請上線登記(見第一張圖),審核通過后就完全免費了。