Build.GetSerial 方法

[Android.Runtime.Register("getSerial", "()Ljava/lang/String;", "", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")]
public static string? GetSerial();

[<Android.Runtime.Register("getSerial", "()Ljava/lang/String;", "", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")>]
static member GetSerial : unit -> string

傳回

如果有標明序號，請提供。

屬性

RegisterAttribute RequiresPermissionAttribute

備註

如果有的話，會取得硬體序號。

<b>注意：</ b> Root 存取可能允許您修改裝置識別碼，例如硬體序號。 若更改這些識別碼，將無法使用金鑰證明取得裝置原始識別碼的證明。 如果框架提供的識別碼與其提供的識別碼不符，KeyMint 會拒絕 ID 認證請求。

從 API 第 29 級開始，持久裝置識別碼受到額外限制，且建議應用程式使用可重置識別碼（參見唯一識別碼最佳實務）。 若符合以下條件之一，即可啟動此方法： <ul><li>若呼叫應用程式已獲得 READ_PRIVILEGED_PHONE_STATE 權限;此權限僅能授予裝置預先載入的應用程式。 <li>：如果通話應用程式在任何有效訂閱上都有電信業者權限（參見 android.telephony.TelephonyManager#hasCarrierPrivileges）。 <li>如果呼叫應用程式是預設的簡訊角色持有者（參見 android.app.role.RoleManager#isRoleHeld(String)）。 <li>如果呼叫應用程式是完全管理裝置的裝置擁有者、組織擁有裝置的設定檔擁有者，或其代理人（參見 android.app.admin.DevicePolicyManager#getEnrollmentSpecificId()）。 </ul>

若呼叫應用程式不符合上述一項要求，則此方法的行為如下：

<ul><li>如果呼叫應用程式的目標 SDK 是 API 等級 28 或以下，且該應用程式擁有 READ_PHONE_STATE 權限，則 Build#UNKNOWN 會回傳。</li><li>如果呼叫應用程式的目標 SDK 是 API 等級 28 或以下，且應用程式沒有 READ_PHONE_STATE 權限，或呼叫應用程式的目標是 API 等級 29 或以上，則會拋出 SecurityException。</li></ul>

Java 文件 android.os.Build.getSerial()。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。