uniapp 获取系统信息的方法小结

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 返回参数说明

#某些小程序特殊的返回参数

#不推荐使用的返回参数，仅为向下兼容保留

#uniPlatform 返回值说明

uniCompileVersion编译器版本 和 uniRuntimeVersion运行时版本，正常情况应该是一样的值，即uni-app的版本。

如果使用HBuilder自带的uni-app开发，该值即等同于HBuilder的版本；如果使用单独的uni-app cli开发，则等同于cli版本。

但在App平台，uniCompileVersion 和 uniRuntimeVersion 在某些情况的值会不一样：

• App云打包选择了不匹配的打包机版本，比如HBuilder版本较老，云端已经没有对应打包机，此时打包后uniCompileVersion会小于uniRuntimeVersion
• App离线打包，使用了不匹配的离线SDK
• App wgt升级，即手机上安装的App是老版的uniRuntimeVersion，wgt的新版使用了不同版本的HBuilder或uni-app cli版本，并且实施了应用资源升级

#romName 返回值说明

注意：不同rom的版本号规则不同，比如MIUI版本号是V130，而HarmonyOS的版本号是2.0.0

#hostName 返回值说明

#safeArea 返回值说明

safeAreaInsets 的结构

#language 返回值说明

language的国际规范是BCP47规范，分为三段，主语言-次语言-地区。例如zh-Hans-CN，表示 中文-简体-中国大陆

但除了主语言外，后两者均可省略。在不同平台，它们的省略规则也不相同。

• app-ios，不省略，返回zh-Hans-CN
• app-android、web、微信小程序，省略次语言，返回zh-CN
• uni-app框架和应用的多语言，以及支付宝小程序，则用zh-Hans来表示简体中文

所以获取语言后，不能直接字符串比较，需要拆段比较，npm上也有专门做BCP47语言规范比较的库。

#deviceId 返回值说明

Web、小程序、iOS，属于对用户隐私保护比较严格的平台，在这些平台很难获取有效的设备唯一标记。

Android也已经改进用户隐私保护。在极老的手机上可以无限制获取imei，在次老的手机上，获取imei等隐私信息时需要弹框让用户授权。新的Android手机（Android10以上）已经彻底无法获取imei了。

所以标记设备，大多只能依靠本地存储一个随机数来标记。

deviceId，在app-android平台，会根据优先使用imei、mac（仅在用户已授权的情况下，如果发现需要授权或未授权，则跳过此步骤），如果没有获取到就使用随机生成的标识。其他平台是直接使用随机生成的标识。

当使用本地存贮的随机数时，发生以下情况将导致deviceId失效：

• 卸载App
• Android上重置App数据
• 浏览器清空缓存或开启隐私模式，

app下需要广告追踪的场景，在iOS上可以使用idfa (opens new window)、部分国产Android手机可以使用OAID(opens new window)

#deviceModel 返回值说明

uni-app 3.5.1+ 版本规范了 deviceModel 返回值，例如之前返回 iPhone11ProMax 新版本返回值为 iPhone 11 Pro Max，各设备型号参考规范 (opens new window)中 Generation 对应的值

注意：新机型刚推出一段时间会显示 Unknown，官方会尽快进行适配。

#其他注意

• deviceType：

  • app-ios 只支持 phone、pad。

  • app-android 支持 phone、pad、tv、car、watch、vr、appliance、undefined、unknown，关于各个类型的更详细解释参考Android官方文档 (opens new window)。

  • 其中，app-android 平台下 pad 类型的判断，在国产pad等非google官方设备上并不一定准确。如果有需要开发者可自行根据型号或屏幕大小判断。uni-app框架源码中判断pad的java代码如下，供参考：

  • public static boolean isTablet(Context context) {
    	return (context.getResources().getConfiguration().screenLayout & Configuration.SCREENLAYOUT_SIZE_MASK) >= Configuration.SCREENLAYOUT_SIZE_LARGE;
    }

     

• osTheme：app-ios 只有将应用主题设置为跟随系统时才能获取到系统的主题。小程序也有类似限制。
• 屏幕高度 = 原生NavigationBar高度（含状态栏高度）+ 可使用窗口高度 + 原生TabBar高度
• windowHeight不包含NavigationBar和TabBar的高度
• Web端，windowTop等于NavigationBar高度，windowBottom等于TabBar高度
• App端，windowTop等于透明状态NavigationBar高度，windowBottom等于透明状态TabBar高度
• 高度相关信息，要放在 onReady 里获取。太早取不到。

本API在其他小程序的文档链接：

• 微信小程序(opens new window)
• 支付宝小程序(opens new window)
• 百度小程序(opens new window)
• 字节小程序(opens new window)
• 飞书小程序(opens new window)
• QQ小程序(opens new window)
• 快手小程序(opens new window)
• 京东小程序(opens new window)
• 华为快应用(opens new window)

#示例

调用代码示例

uni.getSystemInfo({
	success: function (res) {
		console.log(res.appName)
	}
});

在不同平台 getSystemInfo 的返回值（表格较长，可缩放页面后拖动横向滚动条）

标明 - 的都为 undefined，其他值都与所列出项相同

二、uni.getSystemInfoSync()

获取系统信息的同步接口。调用参数和返回值同上getSystemInfo。

三、总结

uni.getSystemInfo()  

(1) deviceType 获取设备类型，phone、pad、pc

(2) deviceOrientation 获取设备方向，竖屏 portrait、横屏 landscape

(3) osName 获取系统名称，ios、android、windows、macos （APP只有ios、android）