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
属性 | 类型 | 描述 |
---|---|---|
name | string | 注意:此属性仅iOS可用。设备名称,例如"John's iPhone" |
model | string | 设备型号,例如"iPhone" |
platform | "ios" | "android" | "electron" | "web" | 设备平台(小写形式) |
uuid | string | 应用程序可访问的设备UUID。在现代移动平台上,此标识符可能会变化(因系统仅允许按应用安装UUID)。 |
appVersion | string | 当前应用的版本号 |
appBuild | string | 当前应用的构建号 |
appId | string | 应用的包ID |
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 |