TelephonyManager.DeviceId Eigenschaft

Definition

Namespace:: Android.Telephony

Assembly:: Mono.Android.dll

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Gibt die eindeutige Geräte-ID zurück, z. B. die IMEI für GSM und die MEID oder ESN für CDMA-Telefone.

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

Eigenschaftswert

String

Attribute: RegisterAttribute RequiresPermissionAttribute

Hinweise

Gibt die eindeutige Geräte-ID zurück, z. B. die IMEI für GSM und die MEID oder ESN für CDMA-Telefone. Gibt NULL zurück, wenn die Geräte-ID nicht verfügbar ist.

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 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()). <li>Wenn die aufrufende App über Netzbetreiberrechte verfügt (siehe #hasCarrierPrivileges) für ein aktives Abonnement. <li>Wenn die Anruf-App der Standardmäßige SMS-Rolleninhaber ist (siehe RoleManager#isRoleHeld(String)). </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 null is returned.</li li><>Wenn das Ziel-SDK der aufrufenden App API-Ebene 28 oder niedriger ist und die App nicht über die READ_PHONE_STATE-Berechtigung verfügt oder wenn die aufrufende App auf API-Ebene 29 oder höher ausgerichtet ist, wird eine SecurityException ausgelöst.</li></ul>

Dieses Element ist veraltet. Verwenden Sie #getImei diese Eigenschaft, die IMEI für GSM zurückgibt oder #getMeid die MEID für CDMA zurückgibt.

Java Dokumentation für android.telephony.TelephonyManager.getDeviceId().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: