uni.getSystemInfo(OBJECT)

最新推荐文章于 2025-05-07 09:45:46 发布

鹿蹊zz

最新推荐文章于 2025-05-07 09:45:46 发布

阅读量1.1w

点赞数 4

分类专栏：微信小程序文章标签： vue.js uni-app 开发语言前端

本文链接：https://blog.youkuaiyun.com/m0_46461853/article/details/126897055

版权

本文介绍了uni-app中uni.getSystemInfo和uni.getSystemInfoSync两个API用于获取系统信息，详细阐述了系统信息的概念和内容，包括设备、操作系统、ROM、宿主、框架和应用信息。还讲解了各平台的特殊返回参数，如deviceId、deviceModel、language等，并提醒开发者注意获取设备唯一标识的隐私问题和兼容性问题。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

系统信息的概念

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	宿主