Xamarin.Essentials: Geräteinformationen

  • Artikel

Die Klasse DeviceInfo stellt Informationen zu dem Gerät bereit, auf dem die Anwendung ausgeführt wird.

Erste Schritte

Lesen Sie zum Einstieg in die Verwendung dieser API den Leitfaden mit ersten Schritte für Xamarin.Essentials, um sicherzustellen, dass die Bibliothek ordnungsgemäß installiert und in Ihren Projekten eingerichtet ist.

Verwenden der Geräteinformationen

Fügen Sie in Ihrer Klasse einen Verweis auf Xamarin.Essentials hinzu:

using Xamarin.Essentials;

Die folgenden Informationen werden über die API verfügbar gemacht:

// Device Model (SMG-950U, iPhone10,6)
var device = DeviceInfo.Model;

// Manufacturer (Samsung)
var manufacturer = DeviceInfo.Manufacturer;

// Device Name (Motz's iPhone)
var deviceName = DeviceInfo.Name;

// Operating System Version Number (7.0)
var version = DeviceInfo.VersionString;

// Platform (Android)
var platform = DeviceInfo.Platform;

// Idiom (Phone)
var idiom = DeviceInfo.Idiom;

// Device Type (Physical)
var deviceType = DeviceInfo.DeviceType;

Plattformen

DeviceInfo.Platform entspricht einer konstanten Zeichenfolge, die dem Betriebssystem zugeordnet ist. Die Werte können mit der DevicePlatform-Struktur überprüft werden:

  • DevicePlatform.iOS: iOS
  • DevicePlatform.Android: Android
  • DevicePlatform.UWP: UWP
  • DevicePlatform.Unknown: Unbekannt

Idioms

DeviceInfo.Idiom entspricht einer konstanten Zeichenfolge, die dem Typ des Geräts zugeordnet ist, auf dem die Anwendung ausgeführt wird. Die Werte können mit der DeviceIdiom-Struktur überprüft werden:

  • DeviceIdiom.Phone: Mobiltelefon
  • DeviceIdiom.Tablet: Tablet
  • DeviceIdiom.Desktop: Desktop
  • DeviceIdiom.TV: TV
  • DeviceIdiom.Watch: Überwachungselement
  • DeviceIdiom.Unknown: Unbekannt

Gerätetyp

DeviceInfo.DeviceType entspricht einer Enumeration, um festzustellen, ob die Anwendung auf einem physischen oder virtuellen Gerät ausgeführt wird. Ein virtuelles Gerät ist ein Simulator oder Emulator.

Besonderheiten bei der plattformspezifischen Implementierung

iOS macht für Entwickler keine API verfügbar, um das Modell des konkreten iOS-Geräts abzurufen. Stattdessen wird eine Hardware-ID (z. B. iPhone10.6) zurückgegeben, die auf das iPhone X verweist. Eine Zuordnung dieser Kennungen wird von Apple nicht bereitgestellt, kann jedoch mithilfe der folgenden (nicht offiziellen) Quellen gefunden werden: The iPhone Wiki und Get iOS Model.

API

Auf Channel 9 und auf YouTube finden Sie weitere Videos zu Xamarin.