Xamarin.Essentials: Información del dispositivoXamarin.Essentials: Device Information

La clase DeviceInfo proporciona información sobre el dispositivo en el que se ejecuta la aplicación.The DeviceInfo class provides information about the device the application is running on.

Primeros pasosGet started

Para empezar a usar esta API, lea la guía de introducción para Xamarin.Essentials con el fin de asegurarse de que la biblioteca está correctamente instalada y configurada en los proyectos.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.

Uso de DeviceInfoUsing DeviceInfo

Agregue una referencia a Xamarin.Essentials en su clase:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

La información siguiente se expone a través de la 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;

PlataformasPlatforms

DeviceInfo.Platform se correlaciona con una cadena de constante que se asigna al sistema operativo.DeviceInfo.Platform correlates to a constant string that maps to the operating system. Los valores se pueden comprobar con el 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: desconocidoDevicePlatform.Unknown – Unknown

ExpresionesIdioms

DeviceInfo.Idiom se correlaciona con una cadena de constante que se asigna al tipo de dispositivo en el que se ejecuta la aplicación.DeviceInfo.Idiom correlates a constant string that maps to the type of device the application is running on. Los valores se pueden comprobar con el struct DeviceIdiom:The values can be checked with the DeviceIdiom struct:

  • DeviceIdiom.Phone: teléfonoDeviceIdiom.Phone – Phone
  • DeviceIdiom.Tablet: tabletaDeviceIdiom.Tablet – Tablet
  • DeviceIdiom.Desktop: escritorioDeviceIdiom.Desktop – Desktop
  • DeviceIdiom.TV: TVDeviceIdiom.TV – TV
  • DeviceIdiom.Watch: relojDeviceIdiom.Watch – Watch
  • DeviceIdiom.Unknown: desconocidoDeviceIdiom.Unknown – Unknown

Tipo de dispositivoDevice Type

DeviceInfo.DeviceType pone en correlación una enumeración para determinar si la aplicación se ejecuta en un dispositivo físico o virtual.DeviceInfo.DeviceType correlates an enumeration to determine if the application is running on a physical or virtual device. Un dispositivo virtual es un simulador o emulador.A virtual device is a simulator or emulator.

Detalles de implementación de la plataformaPlatform Implementation Specifics

iOS no expone una API para que los desarrolladores obtengan el nombre del dispositivo iOS específico.iOS does not expose an API for developers to get the name of the specific iOS device. En su lugar, se devuelve un identificador de hardware, como iPhone10,6 que hace referencia al iPhone X. Apple no proporciona una asignación de estos identificadores, pero se puede encontrar en The iPhone Wiki (una fuente no oficial).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