# uni.getDeviceInfo()
获取设备基础信息
| App | H5 | 微信小程序 | 支付宝小程序 | 抖音小程序 | 快手小程序 | QQ小程序 | 百度小程序 | 京东小程序 | 钉钉小程序 | 飞书小程序 | 元服务 |
|---|---|---|---|---|---|---|---|---|---|---|---|
√ (3.4.13+) | √ (3.4.13+) | √ (2.20.1+) | x | x | x | x | x | x | x | x | √ |
# getDeviceInfo 兼容性
| HarmonyOS |
|---|
| HBuilderX 4.23 |
返回参数说明
| 参数名 | 类型 | 说明 | 平台差异说明 |
|---|---|---|---|
| deviceBrand | string | 设备品牌。如：apple、huawei | H5 不支持 |
| deviceId | string | 设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变 | |
| deviceModel | string | 设备型号 | |
| deviceType | string | 设备类型phone、pad、pc | |
| deviceOrientation | string | 设备方向 竖屏 portrait、横屏 landscape | App、H5。微信小程序请使用 getSystemInfo Api 获取 |
| devicePixelRatio | string | 设备像素比 | App、H5。微信小程序请使用 getSystemInfo Api 获取 |
| system | string | 操作系统及版本 | |
| platform | string | 客户端平台 | |
| osName | string | 系统名称 | HBuilderX 4.32+，weixin 4.33支持 |
| osVersion | string | 操作系统版本。如 ios 版本，andriod 版本 | HBuilderX 4.32+，weixin 4.33支持 |
| osLanguage | string | 操作系统语言 | HBuilderX 4.32+，H5、weixin 不支持 |
| osTheme | string | 操作系统主题 | HBuilderX 4.32+，H5、weixin 不支持 |
| romName | string | rom 名称。Android 部分机型获取不到值。iOS 恒为 ios | HBuilderX 4.32+，H5、weixin 不支持 |
| romVersion | string | rom 版本号。Android 部分机型获取不到值。iOS 为操作系统版本号（同 osVersion） | HBuilderX 4.32+，H5、weixin 不支持 |
小程序特殊的返回参数
| 参数名 | 类型 | 说明 | 平台差异说明 |
|---|---|---|---|
| abi | String | 应用二进制接口类型（仅 Android 支持） | 仅微信小程序 |
| benchmarkLevel | Number | 设备性能等级（仅 Android 支持）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好，目前最高不到50） | 仅微信小程序 |
不推荐使用的返回参数，仅为向下兼容保留
| 参数名 | 类型 | 说明 | 平台差异说明 |
|---|---|---|---|
| brand | string | 设备品牌 | H5 不支持 |
| model | string | 设备型号。新机型刚推出一段时间会显示unknown，微信会尽快进行适配。 |
# 返回值
| 类型 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| GetDeviceInfoResult | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Tips
deviceId：android 平台根据优先使用imei、mac，如果没有获取到就使用随机生成的标识。ios 平台是直接使用随机生成的标识- 自 5.11 起：
- web 平台在 macOS 上 platform 正确的返回
mac值 - web 平台在 macOS 上获取到的 osVersion 固定为
10.15.7，这和系统版本不一致，这不是 bug，是浏览器 ua 的限制（从 macOS 11 开始，Apple 和 Google、Mozilla 等浏览器厂商达成共识，减少通过 UA 暴露精确的系统版本） - web 平台运行在鸿蒙 PC 上时 osName 仅返回
harmonyos（不会返回ohos_pc），可通过 deviceType 为pc区分 - 小程序平台统一标准：鸿蒙系统 osName、platform 为
harmonyos，手机、Tablet 和 PC 通过 deviceType 区分
- web 平台在 macOS 上 platform 正确的返回
