跳到主要内容
版本：v3

@capacitor/device

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

安装​

npm install @capacitor/device
npx cap sync

示例​

import { Device } from '@capacitor/device';

const logDeviceInfo = async () => {
  const info = await Device.getInfo();

  console.log(info);
};

const logBatteryInfo = async () => {
  const info = await Device.getBatteryInfo();

  console.log(info);
};

API​

getId()​

getId() => Promise<DeviceId>

返回设备的唯一标识符。

返回值： 

Promise<DeviceId>

自版本： 1.0.0

getInfo()​

getInfo() => Promise<DeviceInfo>

返回底层设备/操作系统/平台的信息。

返回值： 

Promise<DeviceInfo>

自版本： 1.0.0

getBatteryInfo()​

getBatteryInfo() => Promise<BatteryInfo>

返回电池信息。

返回值： 

Promise<BatteryInfo>

自版本： 1.0.0

getLanguageCode()​

getLanguageCode() => Promise<GetLanguageCodeResult>

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

返回值： 

Promise<GetLanguageCodeResult>

自版本： 1.0.0

接口​

DeviceId​

属性类型描述自版本
uuidstring应用程序可用的设备 UUID。在现代移动平台上，此标识符可能会发生变化，因为这些平台只允许每个应用程序的安装 UUID。在 Web 平台上，会生成一个随机标识符并存储在 localStorage 中供后续调用使用。1.0.0
属性类型描述起始版本
namestring设备名称。例如 "John's iPhone"。此属性仅在 iOS 和 Android 7.1 及以上版本中受支持。1.0.0
modelstring设备型号。例如 "iPhone"。1.0.0
platform'ios' | 'android' | 'web'设备平台（小写）。1.0.0
operatingSystem
OperatingSystem
设备的操作系统。1.0.0
osVersionstring设备操作系统的版本。1.0.0
manufacturerstring设备制造商。1.0.0
isVirtualboolean应用是否在模拟器/仿真器中运行。1.0.0
memUsednumber当前应用使用的近似内存大小，单位为字节。除以 1048576 可得到使用的 MB 数。1.0.0
diskFreenumber操作系统常规数据存储路径的可用磁盘空间大小，单位为字节。在 Android 上，它返回存储核心 Android 操作系统的 "system" 分区的可用磁盘空间。在 iOS 上，此值不准确。1.0.0
diskTotalnumber操作系统常规数据存储路径的总大小，单位为字节。在 Android 上，它返回存储核心 Android 操作系统的 "system" 分区的磁盘空间大小。1.0.0
realDiskFreenumber常规数据存储的可用磁盘空间大小，单位为字节。1.1.0
realDiskTotalnumber常规数据存储路径的总大小，单位为字节。1.1.0
webViewVersionstringWebView 浏览器版本。1.0.0

BatteryInfo（电池信息）​

属性类型描述起始版本
batteryLevelnumber一个表示电池充电量的百分比（0 到 1）。1.0.0
isChargingboolean设备是否正在充电。1.0.0

GetLanguageCodeResult（获取语言代码结果）​

属性类型描述起始版本
valuestring两位数的语言代码。1.0.0

类型别名​

OperatingSystem（操作系统）​

'ios' | 'android' | 'windows' | 'mac' | 'unknown'

Contents

编辑此页