uni.getDeviceInfo()

获取设备基础信息

App	H5	微信小程序	支付宝小程序	抖音小程序	快手小程序	QQ小程序	百度小程序	京东小程序	钉钉小程序	飞书小程序	元服务
√ (3.4.13+)	√ (3.4.13+)	√ (2.20.1+)	x	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
名称 类型 必填 默认值 兼容性 描述 deviceBrand string 否 - HarmonyOS HBuilderX 4.23 设备品牌 deviceId string 否 - HarmonyOS HBuilderX 4.23 设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变 deviceModel string 否 - HarmonyOS HBuilderX 4.23 设备型号 deviceType string 否 - HarmonyOS HBuilderX 4.23 设备类型phone、pad、pc deviceOrientation string 否 - HarmonyOS HBuilderX 4.23 设备方向 竖屏 portrait、横屏 landscape devicePixelRatio number 否 - HarmonyOS HBuilderX 4.23 设备像素比 system string 否 - HarmonyOS HBuilderX 4.23 操作系统及版本 platform string 否 - HarmonyOS HBuilderX 4.23 客户端平台 isRoot boolean 否 - HarmonyOS x 是否root。iOS 为是否越狱 isUSBDebugging boolean 否 - HarmonyOS x adb是否开启 osName string 否 - HarmonyOS HBuilderX 4.23 系统名称 osVersion string 否 - HarmonyOS HBuilderX 4.23 操作系统版本。如 ios 版本，andriod 版本 osLanguage string 否 - HarmonyOS HBuilderX 4.23 操作系统语言 osTheme string 否 - HarmonyOS HBuilderX 4.23 操作系统主题 osAndroidAPILevel number 否 - HarmonyOS x Android 系统API库的版本。 osHarmonySDKAPIVersion number 否 - HarmonyOS HBuilderX 4.61 鸿蒙系统软件API版本 osHarmonyDisplayVersion string 否 - HarmonyOS HBuilderX 4.61 产品版本，关于本机信息内的软件版本 romName string 否 - HarmonyOS HBuilderX 4.23 rom 名称。Android 部分机型获取不到值。iOS 恒为 ios romVersion string 否 - HarmonyOS HBuilderX 4.23 rom 版本号。Android 部分机型获取不到值。iOS 为操作系统版本号（同 osVersion）。 abi string 否 - - HarmonyOS - 应用（微信APP）二进制接口类型（仅 Android 支持） benchmarkLevel number 否 - - HarmonyOS - cpuType string 否 - - HarmonyOS - 需要基础库： 2.29.0 设备 CPU 型号（仅 Android 支持）（Tips: GPU 型号可通过 WebGLRenderingContext.getExtension('WEBGL_debug_renderer_info') 来获取） deviceAbi string 否 - - HarmonyOS - 需要基础库： 2.25.1 设备二进制接口类型（仅 Android 支持） memorySize string 否 - - HarmonyOS - 需要基础库： 2.30.0 设备内存大小，单位为 MB isSimulator boolean 否 - HarmonyOS x 是否是模拟器 已废弃，由于合规问题在4.51版本后不会采集传感器信息，会影响准确度，建议使用isSimulator()代替。 model string 否 - HarmonyOS x 设备型号 已废弃，仅为了向下兼容保留 brand string 否 - HarmonyOS x 设备品牌 已废弃，仅为了向下兼容保留

Tips

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