Xamarin.Essentials: Сведения об устройствеXamarin.Essentials: Device Information

Класс DeviceInfo предоставляет сведения об устройстве, в котором выполняется приложение.The DeviceInfo class provides information about the device the application is running on.

Начало работыGet started

Чтобы начать использовать этот API, ознакомьтесь с руководством по началу работы с Xamarin.Essentials, чтобы правильно настроить и установить библиотеку в проектах.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.

Использование класса DeviceInfoUsing DeviceInfo

Добавьте в свой класс ссылку на Xamarin.Essentials:Add a reference to Xamarin.Essentials in your class:

using Xamarin.Essentials;

Через 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;

ПлатформыPlatforms

DeviceInfo.Platform устанавливает корреляцию с постоянной строкой, которая сопоставляется с операционной системой.DeviceInfo.Platform correlates to a constant string that maps to the operating system. Значения можно проверить с помощью структуры 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 — неизвестноDevicePlatform.Unknown – Unknown

ИдиомыIdioms

DeviceInfo.Idiom коррелирует постоянную строку, сопоставляемую с типом устройства, на котором выполняется приложение.DeviceInfo.Idiom correlates a constant string that maps to the type of device the application is running on. Значения можно проверить с помощью структуры DeviceIdiom:The values can be checked with the DeviceIdiom struct:

  • DeviceIdiom.Phone — телефонDeviceIdiom.Phone – Phone
  • DeviceIdiom.Tablet — планшетDeviceIdiom.Tablet – Tablet
  • DeviceIdiom.Desktop — компьютерDeviceIdiom.Desktop – Desktop
  • DeviceIdiom.TV — телевизорDeviceIdiom.TV – TV
  • DeviceIdiom.Watch — часыDeviceIdiom.Watch – Watch
  • DeviceIdiom.Unknown — неизвестноDeviceIdiom.Unknown – Unknown

Тип устройстваDevice Type

Тип DeviceInfo.DeviceType коррелирует перечисление, чтобы определить тип устройства, на котором выполняется приложение (физическое или виртуальное).DeviceInfo.DeviceType correlates an enumeration to determine if the application is running on a physical or virtual device. Виртуальное устройство является симулятором или эмулятором.A virtual device is a simulator or emulator.

Особенности реализации для платформPlatform Implementation Specifics

В iOS не предоставляется API для разработчиков, чтобы получить имя конкретного устройства iOS.iOS does not expose an API for developers to get the name of the specific iOS device. Вместо этого возвращается идентификатор аппаратного обеспечения, например iPhone10,6, который относится к iPhone X. Сопоставление этих идентификаторов не обеспечивается в Apple, но их можно найти на сайте The iPhone Wiki (Википедия iPhone) (неофициальный источник).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