TelephonyManager.SubscriberId Propriedade

Definição

Namespace:

Android.Telephony

Assembly:

Mono.Android.dll

Retorna o ID de assinante exclusivo, por exemplo, o IMSI de um telefone GSM.

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

Valor da propriedade

String

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Retorna o ID de assinante exclusivo, por exemplo, o IMSI de um telefone GSM. Retorne null se não estiver disponível.

A partir do nível 29 da API, os identificadores de dispositivo persistentes são protegidos por restrições adicionais e os aplicativos são recomendados a usar identificadores reconfiguráveis (consulte Práticas recomendadas para identificadores exclusivos). Esse método pode ser invocado se um dos seguintes requisitos for atendido: <ul><li>Se o aplicativo de chamada recebeu a permissão READ_PRIVILEGED_PHONE_STATE de dados; essa é uma permissão privilegiada que só pode ser concedida a aplicativos pré-carregados no dispositivo. <li>Se o aplicativo de chamada for o proprietário do dispositivo de um dispositivo totalmente gerenciado, um proprietário de perfil de um dispositivo de propriedade da organização ou seus representantes (consulte android.app.admin.DevicePolicyManager#getEnrollmentSpecificId()). <li>Se o aplicativo de chamada tiver privilégios de operadora (consulte #hasCarrierPrivileges). <li>Se o aplicativo de chamada for o titular da função SMS padrão (consulte RoleManager#isRoleHeld(String)). <li>Se o aplicativo de chamada recebeu a Manifest.permission#USE_ICC_AUTH_WITH_DEVICE_IDENTIFIER permissão. </ul>

Se o aplicativo de chamada não atender a um desses requisitos, esse método se comportará da seguinte maneira:

<><ul li>Se o SDK de destino do aplicativo de chamada for nível de API 28 ou inferior e o aplicativo tiver a permissão READ_PHONE_STATE, null será retornado.</li><li>Se o SDK de destino do aplicativo de chamada for API nível 28 ou inferior e o aplicativo não tiver a permissão READ_PHONE_STATE, ou se o aplicativo de chamada estiver visando o nível de API 29 ou superior, uma SecurityException será lançada.</li></ul>

Documentação Java para android.telephony.TelephonyManager.getSubscriberId().

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usado de acordo com os termos descritos na Creative Commons 2.5 Attribution License.