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.

DeviceInfo の使用Using 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 では、特定の iOS デバイスの名前を取得するための API は開発者に対して公開されていません。iOS does not expose an API for developers to get the name of the specific iOS device. 代わりに、iPhone X を示す iPhone10,6 のようなハードウェア識別子が返されます。これらの識別子のマッピングは Apple では提供されていませんが、iPhone Wiki (非公式ソース) で確認できます。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