TelephonyManager.SubscriberId 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
傳回唯一的訂閱者標識碼,例如 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 屬性授權中所述的詞彙使用。