跳到主要内容
版本:v2

Device

设备 API 提供了关于设备内部信息的访问接口,包括设备型号、操作系统版本等硬件信息,以及用户唯一标识符等用户信息。

示例

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": -zeitig1,
"isCharging": true
}

API

getInfo()

getInfo() => Promise<DeviceInfo>

获取底层设备/操作系统/平台的相关信息

返回值:

Promise<DeviceInfo>


getBatteryInfo()

getBatteryInfo() => Promise<DeviceBatteryInfo>

获取电池相关信息

返回值:

Promise<DeviceBatteryInfo>


getLanguageCode()

getLanguageCode() => Promise<DeviceLanguageCodeResult>

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

返回值:

Promise<DeviceLanguageCodeResult>


Interfaces

DeviceInfo

属性类型描述
namestring注意:此属性仅iOS可用。设备名称,例如"John's iPhone"
modelstring设备型号,例如"iPhone"
platform"ios" | "android" | "electron" | "web"设备平台(小写形式)
uuidstring应用程序可访问的设备UUID。在现代移动平台上,此标识符可能会变化(因系统仅允许按应用安装UUID)。
appVersionstring当前应用的版本号
appBuildstring当前应用的构建号
appIdstring应用的包ID
appNamestring应用的显示名称
operatingSystem"unknown" | "ios" | "android" | "windows" | "mac"设备操作系统
osVersionstring设备操作系统版本
manufacturerstring设备制造商
isVirtualboolean应用是否运行在模拟器/仿真器中
memUsednumber当前应用占用的近似内存(字节数)。除以1048576可转换为MB单位。
diskFreenumber操作系统常规数据存储路径的可用空间大小(字节数)
diskTotalnumber操作系统常规数据存储路径的总大小(字节数)

DeviceBatteryInfo

属性类型描述
batteryLevelnumber电池电量百分比(0到1之间)
isChargingboolean设备是否正在充电

DeviceLanguageCodeResult

属性类型
valuestring