A one day, single-track online event celebrating the future of cross-platform app development

DocsプラグインCLI
pwaiosandroid

Device

Device API は、一意の ID などのユーザー情報とともに、モデルやオペレーティングシステムのバージョンなどのデバイスに関する 内部情報を公開します。

Example

import { Plugins } from '@capacitor/core';

const { Device } = Plugins;

const info = await Device.getInfo();
console.log(info);

// Example output:
{
  "diskFree": 12228108288,
  "appVersion": "1.0.2",
  "appBuild": "123",
  "appId": "com.capacitorjs.myapp",
  "appName": "MyApp",
  "operatingSystem": "ios",
  "osVersion": "11.2",
  "platform": "ios",
  "memUsed": 93851648,
  "diskTotal": 499054952448,
  "model": "iPhone",
  "manufacturer": "Apple",
  "uuid": "84AE7AA1-7000-4696-8A74-4FD588A4A5C7",
  "isVirtual":true
}

const info = await Device.getBatteryInfo();
console.log(info);

// Example output:
{
  "batteryLevel": -1,
  "isCharging": true
}

API

getInfo()

getInfo() => Promise<DeviceInfo>

Return information about the underlying device/os/platform

Returns: Promise<DeviceInfo>


getBatteryInfo()

getBatteryInfo() => Promise<DeviceBatteryInfo>

Return information about the battery

Returns: Promise<DeviceBatteryInfo>


getLanguageCode()

getLanguageCode() => Promise<DeviceLanguageCodeResult>

Get the device’s current language locale code

Returns: Promise<DeviceLanguageCodeResult>


Interfaces

DeviceInfo

Prop Type Description
name string Note: this property is iOS only. The name of the device. For example, “John’s iPhone”
model string The device model. For example, “iPhone”
platform "ios" | "android" | "electron" | "web" The device platform (lowercase).
uuid string The UUID of the device as available to the app. This identifier may change on modern mobile platforms that only allow per-app install UUIDs.
appVersion string The current bundle verison of the app
appBuild string The current bundle build of the app
appId string The bundle id of the app
appName string The display name of the app
operatingSystem "unknown" | "ios" | "android" | "windows" | "mac" The operating system of the device
osVersion string The version of the device OS
manufacturer string The manufacturer of the device
isVirtual boolean Whether the app is running in a simulator/emulator
memUsed number Approximate memory used by the current app, in bytes. Divide by 1048576 to get the number of MBs used.
diskFree number How much free disk space is available on the the normal data storage path for the os, in bytes
diskTotal number The total size of the normal data storage path for the OS, in bytes

DeviceBatteryInfo

Prop Type Description
batteryLevel number A percentage (0 to 1) indicating how much the battery is charged
isCharging boolean Whether the device is charging

DeviceLanguageCodeResult

Prop Type
value string
Previous
<- Console
Next
Filesystem ->
Contribute ->