# uni.getDeviceInfo()

获取设备基础信息

App H5 微信小程序 支付宝小程序 抖音小程序 快手小程序 QQ小程序 百度小程序 京东小程序 钉钉小程序 飞书小程序 元服务
(3.4.13+) (3.4.13+) (2.20.1+) x x x x x x x x x

HarmonyOS Next 兼容性

HarmonyOS Next
HBuilderX 4.23

返回参数说明

参数名 类型 说明 平台差异说明
deviceBrand string 设备品牌。如:applehuawei H5 不支持
deviceId string 设备 id 。由 uni-app 框架生成并存储,清空 Storage 会导致改变
deviceModel string 设备型号
deviceType string 设备类型phonepadpc
deviceOrientation string 设备方向 竖屏 portrait横屏 landscape App、H5。微信小程序请使用 (getSystemInfo Api)[/api/system/info.html] 获取
devicePixelRatio string 设备像素比 App、H5。微信小程序请使用 (getSystemInfo Api)[/api/system/info.html] 获取
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,微信会尽快进行适配。

# 返回值 HarmonyOS Next 兼容性

类型
GetDeviceInfoResult
名称 HarmonyOS Next 兼容性
deviceBrand HBuilderX 4.23
deviceId HBuilderX 4.23
deviceModel HBuilderX 4.23
deviceType HBuilderX 4.23
deviceOrientation HBuilderX 4.23
devicePixelRatio HBuilderX 4.23
system HBuilderX 4.23
platform HBuilderX 4.23
osName HBuilderX 4.23
osVersion HBuilderX 4.23
osLanguage HBuilderX 4.23
osTheme HBuilderX 4.23
romName HBuilderX 4.23
romVersion HBuilderX 4.23
model x

Tips

  • deviceIdandroid 平台 根据优先使用imei、mac,如果没有获取到就使用随机生成的标识。ios 平台 是直接使用随机生成的标识