Device

Device API 提供了设备内部信息，例如设备型号、操作系统版本，以及用户信息，如唯一标识符。

• getInfo()
• getBatteryInfo()
• getLanguageCode()
• 接口

示例

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

const { Device } = Plugins;

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

// 示例输出：
{
  "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);

// 示例输出：
{
  "batteryLevel": -1,
  "isCharging": true
}

API

getInfo()

getInfo() => Promise<DeviceInfo>

返回底层设备、操作系统或平台的相关信息。

返回值：

Promise<DeviceInfo>

---

getBatteryInfo()

getBatteryInfo() => Promise<DeviceBatteryInfo>

返回电池相关信息。

返回值：

Promise<DeviceBatteryInfo>

---

getLanguageCode()

getLanguageCode() => Promise<DeviceLanguageCodeResult>

获取设备当前的语言区域代码。

返回值：

Promise<DeviceLanguageCodeResult>

---

接口

DeviceInfo

属性	类型	描述
name	string	注意：此属性仅 iOS 可用。设备名称，例如 "John's iPhone"。
model	string	设备型号，例如 "iPhone"。
platform	"ios" | "android" | "electron" | "web"	设备平台（小写）。
uuid	string	应用可用的设备 UUID。在现代移动平台上，此标识符可能会变化，这些平台仅允许按应用安装生成 UUID。
appVersion	string	应用的当前打包版本。
appBuild	string	应用的当前打包构建号。
appId	string	应用的包标识符。
appName	string	应用的显示名称。
operatingSystem	"unknown" | "ios" | "android" | "windows" | "mac"	设备的操作系统。
osVersion	string	设备操作系统的版本。
manufacturer	string	设备制造商。
isVirtual	boolean	应用是否在模拟器/仿真器中运行。
memUsed	number	当前应用大致使用的内存（字节）。除以 1048576 可得到以 MB 为单位的内存使用量。
diskFree	number	操作系统正常数据存储路径上的可用磁盘空间大小（字节）。
diskTotal	number	操作系统正常数据存储路径的总大小（字节）。

DeviceBatteryInfo

属性	类型	描述
batteryLevel	number	电池电量百分比（0 到 1），表示充电程度。
isCharging	boolean	设备是否正在充电。

DeviceLanguageCodeResult

属性	类型
value	string