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)[/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，微信会尽快进行适配。

返回值

类型
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 平台 是直接使用随机生成的标识