Build.GetSerial Método

Definición

Espacio de nombres:

Android.OS

Ensamblado:

Mono.Android.dll

Obtiene el número de serie de hardware, si está disponible.

[Android.Runtime.Register("getSerial", "()Ljava/lang/String;", "", ApiSince=26)]
[Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")]
public static string? GetSerial ();

[<Android.Runtime.Register("getSerial", "()Ljava/lang/String;", "", ApiSince=26)>]
[<Android.Runtime.RequiresPermission("android.permission.READ_PRIVILEGED_PHONE_STATE")>]
static member GetSerial : unit -> string

Devoluciones

String

Número de serie si se especifica.

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentarios

Obtiene el número de serie de hardware, si está disponible.

<p class="note"><b>Note:</b> Root access may allow you to modify device identifiers, as the hardware serial number. Si cambia estos identificadores, no puede usar la atestación de claves para obtener una prueba de los identificadores originales del dispositivo. KeyMint rechazará una solicitud de atestación de identificador si los identificadores proporcionados por los marcos no coinciden con los identificadores con los que se aprovisionó.

A partir del nivel de API 29, los identificadores de dispositivo persistentes se protegen detrás de restricciones adicionales y se recomienda que las aplicaciones usen identificadores restabletables (consulte Procedimientos recomendados para identificadores únicos). Este método se puede invocar si se cumple uno de los siguientes requisitos: <ul><li>Si se ha concedido el permiso READ_PRIVILEGED_PHONE_STATE a la aplicación que realiza la llamada; se trata de un permiso con privilegios que solo se puede conceder a las aplicaciones precargadas en el dispositivo. <li>Si la aplicación que realiza la llamada tiene privilegios de operador (consulte android.telephony.TelephonyManager#hasCarrierPrivileges) en cualquier suscripción activa. <li>Si la aplicación que realiza la llamada es el titular predeterminado del rol sms (consulte android.app.role.RoleManager#isRoleHeld(String)). <li>Si la aplicación que realiza la llamada es el propietario del dispositivo de un dispositivo totalmente administrado, un propietario de perfil de un dispositivo propiedad de la organización o sus delegados (consulte android.app.admin.DevicePolicyManager#getEnrollmentSpecificId()). </ul>

Si la aplicación que realiza la llamada no cumple uno de estos requisitos, este método se comportará de la siguiente manera:

<ul><li>Si el SDK de destino de la aplicación que realiza la llamada es el nivel de API 28 o inferior y la aplicación tiene el permiso READ_PHONE_STATE, Build#UNKNOWN se devuelve.</li li><>Si el SDK de destino de la aplicación que realiza la llamada es el nivel de API 28 o inferior y la aplicación no tiene el permiso READ_PHONE_STATE, o si la aplicación que realiza la llamada tiene como destino el nivel de API 29 o superior, se produce una excepción SecurityException.</li></ul>

Documentación de Java para android.os.Build.getSerial().

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.