TelephonyManager.SubscriberId プロパティ

  • リファレンス

定義

名前空間:
Android.Telephony
アセンブリ:
Mono.Android.dll

GSM 電話の IMSI など、一意のサブスクライバー ID を返します。

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

プロパティ値

String
属性
RegisterAttribute RequiresPermissionAttribute

注釈

GSM 電話の IMSI など、一意のサブスクライバー ID を返します。 使用できない場合は null を返します。

API レベル 29 以降では、永続的なデバイス識別子は追加の制限の背後で保護され、アプリはリセット可能な識別子を使用することをお勧めします (「一意識別子のベスト プラクティス」を参照してください)。 このメソッドは、次のいずれかの要件が満たされている場合に呼び出すことができます。 <ul><li>呼び出し元のアプリにREAD_PRIVILEGED_PHONE_STATEアクセス許可が付与されている場合。これは、デバイスに事前に読み込まれたアプリにのみ付与できる特権アクセス許可です。 <li>呼び出し元のアプリがフル マネージド デバイスのデバイス所有者、organization所有デバイスのプロファイル所有者、またはその代理人である場合 (「」を参照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>

の Java ドキュメント android.telephony.TelephonyManager.getSubscriberId()。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。

適用対象