TelephonyManager.DeviceId Propriedade

Definição

Namespace:: Android.Telephony

Assembly:: Mono.Android.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Retorna a ID exclusiva do dispositivo, por exemplo, o IMEI para GSM e o MEID ou ESN para telefones CDMA.

public virtual string? DeviceId { [Android.Runtime.Register("getDeviceId", "()Ljava/lang/String;", "GetGetDeviceIdHandler")] [Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")] get; }

[<get: Android.Runtime.Register("getDeviceId", "()Ljava/lang/String;", "GetGetDeviceIdHandler")>]
[<get: Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")>]
member this.DeviceId : string

Valor da propriedade

String

Atributos: RegisterAttribute RequiresPermissionAttribute

Comentários

Retorna a ID exclusiva do dispositivo, por exemplo, o IMEI para GSM e o MEID ou ESN para telefones CDMA. Retornará nulo se a ID do dispositivo não estiver disponível.

A partir do nível de API 29, os identificadores de dispositivo persistente são protegidos por restrições adicionais e os aplicativos são recomendados para usar identificadores redefinidos (consulte As melhores práticas para identificadores exclusivos). Esse método poderá ser invocado se um dos seguintes requisitos for atendido: <ul><li>Se o aplicativo de chamada tiver recebido a permissão READ_PRIVILEGED_PHONE_STATE; 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) em qualquer assinatura ativa. <li>Se o aplicativo de chamada for o titular da função SMS padrão (consulte RoleManager#isRoleHeld(String)). </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 a API nível 28 ou inferior e o aplicativo tiver a permissão READ_PHONE_STATE então nulo será retornado.</li li><>Se o SDK de destino do aplicativo de chamada for nível de API 28 ou inferior e o aplicativo não tiver a permissão READ_PHONE_STATE ou se o aplicativo de chamada estiver direcionando o nível de API 29 ou superior, um SecurityException será gerado.</li></ul>

Este membro foi preterido. Use #getImei o que retorna IMEI para GSM ou #getMeid que retorna MEID para CDMA.

Java documentação para android.telephony.TelephonyManager.getDeviceId().

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

Aplica-se a