Xamarin.Essentials: Informations sur l’appareilXamarin.Essentials: Device Information

La classe DeviceInfo fournit des informations sur l’appareil où l’application s’exécute.The DeviceInfo class provides information about the device the application is running on.

Prise en mainGet started

Pour commencer à utiliser cette API, lisez le Guide de prise en main de Xamarin.Essentials pour vérifier que la bibliothèque est correctement installée et configurée dans vos projets.To start using this API, read the getting started guide for Xamarin.Essentials to ensure the library is properly installed and set up in your projects.

Utilisation de DeviceInfoUsing DeviceInfo

Ajoutez une référence à Xamarin.Essentials dans votre classe :Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

Les informations suivantes sont exposées via l’API :The following information is exposed through the API:

// 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;

PlateformesPlatforms

DeviceInfo.Platform est mis en corrélation avec une chaîne constante mappée au système d’exploitation.DeviceInfo.Platform correlates to a constant string that maps to the operating system. Vous pouvez vérifier les valeurs avec le struct DevicePlatform :The values can be checked with the DevicePlatform struct:

  • DevicePlatform.iOS – iOSDevicePlatform.iOS – iOS
  • DevicePlatform.Android – AndroidDevicePlatform.Android – Android
  • DevicePlatform.UWP – UWPDevicePlatform.UWP – UWP
  • DevicePlatform.Unknown – InconnuDevicePlatform.Unknown – Unknown

IdiomesIdioms

DeviceInfo.Idiom est mis en corrélation avec une chaîne constante mappée au type d’appareil sur lequel l’application s’exécute.DeviceInfo.Idiom correlates a constant string that maps to the type of device the application is running on. Vous pouvez vérifier les valeurs avec le struct DeviceIdiom :The values can be checked with the DeviceIdiom struct:

  • DeviceIdiom.Phone – TéléphoneDeviceIdiom.Phone – Phone
  • DeviceIdiom.Tablet – TabletteDeviceIdiom.Tablet – Tablet
  • DeviceIdiom.Desktop – Ordinateur de bureauDeviceIdiom.Desktop – Desktop
  • DeviceIdiom.TV – TVDeviceIdiom.TV – TV
  • DeviceIdiom.Watch – EspionDeviceIdiom.Watch – Watch
  • DeviceIdiom.Unknown – InconnuDeviceIdiom.Unknown – Unknown

Type d'appareilDevice Type

DeviceInfo.DeviceType est mis en corrélation avec une énumération pour déterminer si l’application s’exécute sur un appareil physique ou virtuel.DeviceInfo.DeviceType correlates an enumeration to determine if the application is running on a physical or virtual device. Un appareil virtuel est un simulateur ou un émulateur.A virtual device is a simulator or emulator.

Caractéristiques de mise en œuvre de la plateformePlatform Implementation Specifics

iOS n’expose pas d’API permettant aux développeurs d’obtenir le nom de l’appareil iOS spécifique.iOS does not expose an API for developers to get the name of the specific iOS device. À la place, un identificateur matériel est retourné, par exemple iPhone10,6, qui fait référence à l’iPhone X. Apple ne fournit pas le mappage de ces identificateurs. Toutefois, vous pouvez le trouver sur le Wiki de l’iPhone (source non officielle).Instead a hardware identifier is returned such as iPhone10,6 which refers to the iPhone X. A mapping of these identifers are not provided by Apple, but can be found on The iPhone Wiki (a non-official source).

APIAPI