Build.GetSerial Methode

Definition

Namespace:

Android.OS

Assembly:

Mono.Android.dll

Ruft die Hardware-Seriennummer ab, falls verfügbar.

[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

Gibt zurück

String

Die Seriennummer, falls angegeben.

Attribute

RegisterAttribute RequiresPermissionAttribute

Hinweise

Ruft die Hardware-Seriennummer ab, falls verfügbar.

<p class="note"><b>Note:</b> Root access may allow you to modify device identifiers, such as the hardware serial number. Wenn Sie diese Bezeichner ändern, können Sie den Schlüsselnachweis nicht verwenden, um den Nachweis der ursprünglichen IDs des Geräts zu erhalten. KeyMint lehnt eine ID-Nachweisanforderung ab, wenn die von den Frameworks bereitgestellten Bezeichner nicht mit den bezeichnern übereinstimmen, mit der sie bereitgestellt wurde.

Ab API-Ebene 29 werden persistente Gerätebezeichner hinter zusätzlichen Einschränkungen geschützt, und Apps werden empfohlen, zurücksetzbare IDs zu verwenden (siehe bewährte Methoden für eindeutige Bezeichner). Diese Methode kann aufgerufen werden, wenn eine der folgenden Anforderungen erfüllt ist: <ul><li>Wenn der aufrufenden App die berechtigung READ_PRIVILEGED_PHONE_STATE erteilt wurde. Dies ist eine privilegierte Berechtigung, die nur apps erteilt werden kann, die auf dem Gerät vorinstalliert sind. <li>Wenn die aufrufende App über Netzbetreiberrechte verfügt (siehe android.telephony.TelephonyManager#hasCarrierPrivileges) für ein aktives Abonnement. <li>Wenn die Anruf-App der Standardmäßige SMS-Rolleninhaber ist (siehe android.app.role.RoleManager#isRoleHeld(String)). <li>Wenn die aufrufende App der Gerätebesitzer eines vollständig verwalteten Geräts ist, ein Profilbesitzer eines unternehmenseigenen Geräts oder deren Stellvertretungen (siehe android.app.admin.DevicePolicyManager#getEnrollmentSpecificId()). </ul>

Wenn die aufrufende App keine dieser Anforderungen erfüllt, verhält sich diese Methode wie folgt:

<ul><li>If the calling app's target SDK is API level 28 or lower and the app has the READ_PHONE_STATE permission then Build#UNKNOWN is returned.</li li><>If the calling app's target SDK is API level 28 or lower and the app does not have the READ_PHONE_STATE permission, or if the calling app is targeting API level 29 or higher, then a SecurityException is thrown.</li></ul>

Java-Dokumentation für android.os.Build.getSerial().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.