@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
Interfaces
DeviceId
| 属性 | 类型 | 描述 | 版本 |
|---|---|---|---|
uuid | string | 设备对应用可用的 UUID。在现代移动平台上，此标识符可能会因每次应用安装而变化。在 Web 端，会生成随机标识符并存储在 localStorage 中以供后续调用使用。 | 1.0.0 |
DeviceInfo
| 属性 | 类型 | 描述 | 版本 |
|---|---|---|---|
name | string | 设备名称。例如："John的iPhone"。仅在 iOS 和 Android 7.1 及以上版本支持。 | 1.0.0 |
model | string | 设备型号。例如："iPhone"。 | 1.0.0 |
platform | 'ios' | 'android' | 'web' | 设备平台（小 写）。 | 1.0.0 |
operatingSystem | | 设备的操作系统。 | 1.0.0 |
osVersion | string | 设备操作系统版本。 | 1.0.0 |
manufacturer | string | 设备制造商。 | 1.0.0 |
isVirtual | boolean | 应用是否运行在模拟器/仿真器中。 | 1.0.0 |
memUsed | number | 当前应用占用的近似内存，单位字节。除以 1048576 可得到 MB 值。 | 1.0.0 |
diskFree | number | 操作系统常规数据存储路径的可用磁盘空间，单位字节。在 Android 上返回核心 Android OS 所在"系统"分区的可用空间。iOS 上此值不准确。 | 1.0.0 |
diskTotal | number | 操作系统常规数据存储路径的总大小，单位字节。在 Android 上返回核心 Android OS 所在"系统"分区的总空间大小。 | 1.0.0 |
realDiskFree | number | 常规数据存储路径的可用磁盘空间，单位字节。 | 1.1.0 |
realDiskTotal | number | 常规数据存储路径的总大小，单位字节。 | 1.1.0 |
webViewVersion | string | WebView 浏览器版本 | 1.0.0 |
BatteryInfo
| 属性 | 类型 | 描述 | 版本 |
|---|---|---|---|
batteryLevel | number | 电池电量百分比（0到1之间）。 | 1.0.0 |
isCharging | boolean | 设备是否正在充电。 | 1.0.0 |
GetLanguageCodeResult
| 属性 | 类型 | 描述 | 版本 |
|---|---|---|---|
value | string | 两位字符的语言代码。 | 1.0.0 |
Type Aliases
OperatingSystem
'ios' | 'android' | 'windows' | 'mac' | 'unknown'