共用方式為


TelephonyManager.SubscriberId 屬性

定義

傳回唯一的訂閱者標識碼,例如 GSM 手機的 IMSI。

public virtual string? SubscriberId { [Android.Runtime.Register("getSubscriberId", "()Ljava/lang/String;", "GetGetSubscriberIdHandler")] [Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")] get; }
[<get: Android.Runtime.Register("getSubscriberId", "()Ljava/lang/String;", "GetGetSubscriberIdHandler")>]
[<get: Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")>]
member this.SubscriberId : string

屬性值

屬性

備註

傳回唯一的訂閱者標識碼,例如 GSM 手機的 IMSI。 如果無法使用,則傳回 null。

從 API 層級 29 開始,持續性裝置識別碼會受到其他限制的防護,而且建議應用程式使用可重設標識碼(請參閱唯一標識元的最佳做法)。 如果符合下列其中一個需求,則可以叫用這個方法: <ul><li>如果呼叫的應用程式已獲得READ_PRIVILEGED_PHONE_STATE許可權,這是只能授與裝置上預先載入之應用程式的許可權。 <li>如果呼叫應用程式是完全受控裝置的裝置擁有者、組織擁有裝置的配置檔擁有者或其代理人(請參閱 android.app.admin.DevicePolicyManager#getEnrollmentSpecificId())。 <li>如果通話應用程式具有電信業者許可權(請參閱 #hasCarrierPrivileges)。 <li>如果通話應用程式是預設的SMS角色持有者(請參閱 RoleManager#isRoleHeld(String))。 <li>如果呼叫的應用程式已獲授與 Manifest.permission#USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER 許可權。 </ul>

如果呼叫的應用程式不符合下列其中一項需求,則此方法的行為如下:

<ul><li>如果呼叫應用程式的目標 SDK 為 API 層級 28 或更低,且應用程式具有READ_PHONE_STATE許可權,則會傳回 null。</li li><>如果呼叫應用程式的目標 SDK 為 API 層級 28 或更低,且應用程式沒有READ_PHONE_STATE許可權,或呼叫應用程式是以 API 層級 29 或更高版本為目標,則會擲回 SecurityException。</li></ul>

android.telephony.TelephonyManager.getSubscriberId()Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。

適用於