uni.getSystemInfo(OBJECT)

系统信息的概念

uni-app提供了异步(uni.getSystemInfo)和同步(uni.getSystemInfoSync)的2个API获取系统信息。

系统信息返回的内容非常多，各操作系统、各家小程序、各浏览器对它们的定义也不相同。uni-app里重新梳理了这些概念，同时为了向下兼容也保留了这些平台原来的概念，但不推荐使用。

按照运行环境层级排序，从底层向上，uni-app有6个概念：

• device：运行应用的设备，如iphone、huawei
• os：设备的操作系统，如 ios、andriod、windows、mac、linux
• rom：基于操作系统的定制，Android系统特有概念，如miui、鸿蒙
• host：运行应用的宿主程序，即OS和应用之间的运行环境，如浏览器、微信等小程序宿主、集成uniMPSDK的App。uni-app直接开发的app没有host概念
• uni：uni-app框架相关的信息，如uni-app框架的编译器版本、运行时版本
• app：开发者的应用相关的信息，如应用名称、版本

uni.getSystemInfo(OBJECT)

异步获取系统信息

OBJECT 参数说明：

参数名	类型	必填	说明
success	Function	是	接口调用成功的回调
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数（调用成功、失败都会执行）

#success 返回参数说明

参数分类	参数	说明	App平台值域	Web平台值域	小程序平台值域	备注	uni框架最低版本要求
device	deviceId	设备 id 。由 uni-app 框架生成并存储，清空 Storage 会导致改变
	deviceType	设备类型。如phone、pad、pc、unknow	详见	phone、pad、pc、unknow	phone、pad、pc		uni-app 3.4.10+
	deviceBrand	设备品牌。如：apple、huawei		不支持			uni-app 3.4.10+
	deviceModel	设备型号		部分设备无法获取			uni-app 3.4.10+
	deviceOrientation	设备方向	竖屏 portrait、横屏 landscape	竖屏 portrait、横屏 landscape	竖屏 portrait、横屏 landscape。仅微信百度小程序支持		uni-app 3.4.13+
	devicePixelRatio	设备像素比					uni-app 3.4.13+
os	osName	系统名称	ios、android	ios、android、windows、macos、linux	ios、android、windows、macos		uni-app 3.4.10+
	osVersion	操作系统版本。如 ios 版本，andriod 版本					uni-app 3.4.10+
	osLanguage	操作系统语言详见	Android仅支持主语言+地区：zh-CN 中文简体、iOS支持主语言+次语言+地区zh-Hans-CN 中文简体	与浏览器语言一致	不支持		uni-app 3.4.10+
	osTheme	操作系统主题	light、dark。iOS平台只有将应用主题设置为跟随系统时才能获取到系统的主题	不支持	不支持		uni-app 3.4.10+
	osAndroidAPILevel	Android 系统API库的版本。详情参考Android 官方文档(opens new window)	仅 Android 支持	不支持	不支持		uni-app 3.4.10+
rom	romName	rom 名称	Android 部分机型获取不到值，详见。iOS 不支持	不支持	不支持		uni-app 3.4.13+
	romVersion	rom 版本	Android 部分机型获取不到值，详见。iOS 不支持	不支持	不支持		uni-app 3.4.13+
browser	browserName	浏览器名称或App的webview名称	chrome(android)、wkwebview(ios)、x5webview(app打包x5引擎)	chrome、edge、safari、firefox	不支持		uni-app 3.4.10+
	browserVersion	浏览器版本、webview 版本			不支持		uni-app 3.4.10+
host	hostName	小程序宿主或uniMPSDK的集成宿主名称，如：WeChat、FeiShu	仅 UniMPSDK 支持	不支持	详见	微信小程序真机运行才有真值	uni-app 3.4.10+
	hostVersion	宿主版本。如：微信版本号	仅 UniMPSDK 支持	不支持	小程序宿主版本		uni-app 3.4.10+
	hostLanguage	宿主