萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android 獲取手機號碼完整代碼範例與權限設定教學

前言

在 Android 應用開發中,有時需要獲取用戶的手機號碼(例如用於自動填充註冊表單或身份驗證)。雖然 Android 提供了 TelephonyManager 類來讀取 SIM 卡綁定的號碼,但受限於權限政策與硬體差異,實際開發中需注意相容性與隱私合規。本文提供一個精簡可用的代碼範例,並說明必要的權限聲明。

核心代碼實作

// 1. 取得 TelephonyManager 系統服務
TelephonyManager tm = (TelephonyManager) getSystemService(Context.TELEPHONY_SERVICE);

// 2. 讀取 SIM 卡綁定的手機號碼(可能為 null 或空字串)
String phoneNumber = tm.getLine1Number();

AndroidManifest.xml 權限聲明

必須在清單檔中加入 READ_PHONE_STATE 權限,否則會拋出 SecurityException:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

注意事項與最佳實踐

  • 權限請求:Android 6.0 (API 23) 以上需動態請求危險權限,請參考官方 權限請求指南。
  • 回傳值可能為空:部分運營商或設備不將號碼寫入 SIM 卡,getLine1Number() 可能回傳 null 或空字串,請務必做非空判斷。
  • 隱私合規:依據 Google Play 政策,僅在必要功能時獲取電話號碼,並向用戶說明用途。
  • 替代方案:若需驗證手機號,建議使用 Firebase Phone Auth 或 SMS Retriever API,體驗更佳且不需敏感權限。

完整 Activity 範例

public class MainActivity extends AppCompatActivity {
    private static final int REQUEST_READ_PHONE_STATE = 100;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        if (ContextCompat.checkSelfPermission(this, Manifest.permission.READ_PHONE_STATE)
                != PackageManager.PERMISSION_GRANTED) {
            ActivityCompat.requestPermissions(this,
                    new String[]{Manifest.permission.READ_PHONE_STATE},
                    REQUEST_READ_PHONE_STATE);
        } else {
            fetchPhoneNumber();
        }
    }

    private void fetchPhoneNumber() {
        TelephonyManager tm = (TelephonyManager) getSystemService(Context.TELEPHONY_SERVICE);
        String phoneNumber = tm.getLine1Number();
        Log.d("PhoneNumber", "獲取到的號碼:" + (phoneNumber != null ? phoneNumber : "無法獲取"));
    }

    @Override
    public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions,
                                           @NonNull int[] grantResults) {
        super.onRequestPermissionsResult(requestCode, permissions, grantResults);
        if (requestCode == REQUEST_READ_PHONE_STATE
                && grantResults.length > 0
                && grantResults[0] == PackageManager.PERMISSION_GRANTED) {
            fetchPhoneNumber();
        } else {
            Toast.makeText(this, "需要電話權限才能讀取號碼", Toast.LENGTH_SHORT).show();
        }
    }
}

總結

雖然 TelephonyManager.getLine1Number() 是獲取手機號碼的標準方法,但受限於硬體與權限,實際可用率不高。現代應用開發建議採用短信驗證碼或 Google 官方身份驗證方案,兼顧用戶體驗與隱私保護。

copyright © 萬盛學電腦網 all rights reserved