uni-app提供了異步(uni.getSystemInfo)和同步(uni.getSystemInfoSync)的2個(gè)API獲取系統(tǒng)信息。

系統(tǒng)信息返回的內(nèi)容非常多，各操作系統(tǒng)、各家小程序、各瀏覽器對(duì)它們的定義也不相同。uni-app里重新梳理了這些概念，同時(shí)為了向下兼容也保留了這些平臺(tái)原來的概念，但不推薦使用。

按照運(yùn)行環(huán)境層級(jí)排序，從底層向上，uni-app有6個(gè)概念：

• device：運(yùn)行應(yīng)用的設(shè)備，如iphone、huawei
• os：設(shè)備的操作系統(tǒng)，如 ios、andriod、windows、mac、linux
• rom：基于操作系統(tǒng)的定制，Android系統(tǒng)特有概念，如miui、鴻蒙
• host：運(yùn)行應(yīng)用的宿主程序，即OS和應(yīng)用之間的運(yùn)行環(huán)境，如瀏覽器、微信等小程序宿主、集成uniMPSDK的App。uni-app直接開發(fā)的app沒有host概念
• uni：uni-app框架相關(guān)的信息，如uni-app框架的編譯器版本、運(yùn)行時(shí)版本
• app：開發(fā)者的應(yīng)用相關(guān)的信息，如應(yīng)用名稱、版本

一、uni.getSystemInfo(OBJECT)

異步獲取系統(tǒng)信息

OBJECT 參數(shù)說明：

#success 返回參數(shù)說明

#某些小程序特殊的返回參數(shù)

#不推薦使用的返回參數(shù)，僅為向下兼容保留

#uniPlatform 返回值說明

uniCompileVersion編譯器版本 和 uniRuntimeVersion運(yùn)行時(shí)版本，正常情況應(yīng)該是一樣的值，即uni-app的版本。

如果使用HBuilder自帶的uni-app開發(fā)，該值即等同于HBuilder的版本；如果使用單獨(dú)的uni-app cli開發(fā)，則等同于cli版本。

但在App平臺(tái)，uniCompileVersion 和 uniRuntimeVersion 在某些情況的值會(huì)不一樣：

• App云打包選擇了不匹配的打包機(jī)版本，比如HBuilder版本較老，云端已經(jīng)沒有對(duì)應(yīng)打包機(jī)，此時(shí)打包后uniCompileVersion會(huì)小于uniRuntimeVersion
• App離線打包，使用了不匹配的離線SDK
• App wgt升級(jí)，即手機(jī)上安裝的App是老版的uniRuntimeVersion，wgt的新版使用了不同版本的HBuilder或uni-app cli版本，并且實(shí)施了應(yīng)用資源升級(jí)

#romName 返回值說明

注意：不同rom的版本號(hào)規(guī)則不同，比如MIUI版本號(hào)是V130，而HarmonyOS的版本號(hào)是2.0.0

#hostName 返回值說明

#safeArea 返回值說明

safeAreaInsets 的結(jié)構(gòu)

#language 返回值說明

language的國際規(guī)范是BCP47規(guī)范，分為三段，主語言-次語言-地區(qū)。例如zh-Hans-CN，表示 中文-簡體-中國大陸

但除了主語言外，后兩者均可省略。在不同平臺(tái)，它們的省略規(guī)則也不相同。

• app-ios，不省略，返回zh-Hans-CN
• app-android、web、微信小程序，省略次語言，返回zh-CN
• uni-app框架和應(yīng)用的多語言，以及支付寶小程序，則用zh-Hans來表示簡體中文

所以獲取語言后，不能直接字符串比較，需要拆段比較，npm上也有專門做BCP47語言規(guī)范比較的庫。

#deviceId 返回值說明

Web、小程序、iOS，屬于對(duì)用戶隱私保護(hù)比較嚴(yán)格的平臺(tái)，在這些平臺(tái)很難獲取有效的設(shè)備唯一標(biāo)記。

Android也已經(jīng)改進(jìn)用戶隱私保護(hù)。在極老的手機(jī)上可以無限制獲取imei，在次老的手機(jī)上，獲取imei等隱私信息時(shí)需要彈框讓用戶授權(quán)。新的Android手機(jī)（Android10以上）已經(jīng)徹底無法獲取imei了。

所以標(biāo)記設(shè)備，大多只能依靠本地存儲(chǔ)一個(gè)隨機(jī)數(shù)來標(biāo)記。

deviceId，在app-android平臺(tái)，會(huì)根據(jù)優(yōu)先使用imei、mac（僅在用戶已授權(quán)的情況下，如果發(fā)現(xiàn)需要授權(quán)或未授權(quán)，則跳過此步驟），如果沒有獲取到就使用隨機(jī)生成的標(biāo)識(shí)。其他平臺(tái)是直接使用隨機(jī)生成的標(biāo)識(shí)。

當(dāng)使用本地存貯的隨機(jī)數(shù)時(shí)，發(fā)生以下情況將導(dǎo)致deviceId失效：

• 卸載App
• Android上重置App數(shù)據(jù)
• 瀏覽器清空緩存或開啟隱私模式，

app下需要廣告追蹤的場景，在iOS上可以使用idfa (opens new window)、部分國產(chǎn)Android手機(jī)可以使用OAID(opens new window)

#deviceModel 返回值說明

uni-app 3.5.1+ 版本規(guī)范了 deviceModel 返回值，例如之前返回 iPhone11ProMax 新版本返回值為 iPhone 11 Pro Max，各設(shè)備型號(hào)參考規(guī)范 (opens new window)中 Generation 對(duì)應(yīng)的值

注意：新機(jī)型剛推出一段時(shí)間會(huì)顯示 Unknown，官方會(huì)盡快進(jìn)行適配。

#其他注意

• deviceType：

  • app-ios 只支持 phone、pad。

  • app-android 支持 phone、pad、tv、car、watch、vr、appliance、undefined、unknown，關(guān)于各個(gè)類型的更詳細(xì)解釋參考Android官方文檔 (opens new window)。

  • 其中，app-android 平臺(tái)下 pad 類型的判斷，在國產(chǎn)pad等非google官方設(shè)備上并不一定準(zhǔn)確。如果有需要開發(fā)者可自行根據(jù)型號(hào)或屏幕大小判斷。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 只有將應(yīng)用主題設(shè)置為跟隨系統(tǒng)時(shí)才能獲取到系統(tǒng)的主題。小程序也有類似限制。
• 屏幕高度 = 原生NavigationBar高度（含狀態(tài)欄高度）+ 可使用窗口高度 + 原生TabBar高度
• windowHeight不包含NavigationBar和TabBar的高度
• Web端，windowTop等于NavigationBar高度，windowBottom等于TabBar高度
• App端，windowTop等于透明狀態(tài)NavigationBar高度，windowBottom等于透明狀態(tài)TabBar高度
• 高度相關(guān)信息，要放在 onReady 里獲取。太早取不到。

本API在其他小程序的文檔鏈接：

• 微信小程序(opens new window)
• 支付寶小程序(opens new window)
• 百度小程序(opens new window)
• 字節(jié)小程序(opens new window)
• 飛書小程序(opens new window)
• QQ小程序(opens new window)
• 快手小程序(opens new window)
• 京東小程序(opens new window)
• 華為快應(yīng)用(opens new window)

#示例

調(diào)用代碼示例

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

在不同平臺(tái) getSystemInfo 的返回值（表格較長，可縮放頁面后拖動(dòng)橫向滾動(dòng)條）

標(biāo)明 - 的都為 undefined，其他值都與所列出項(xiàng)相同

二、uni.getSystemInfoSync()

獲取系統(tǒng)信息的同步接口。調(diào)用參數(shù)和返回值同上getSystemInfo。

三、總結(jié)

uni.getSystemInfo()  

(1) deviceType 獲取設(shè)備類型，phone、pad、pc

(2) deviceOrientation 獲取設(shè)備方向，豎屏 portrait、橫屏 landscape

(3) osName 獲取系統(tǒng)名稱，ios、android、windows、macos （APP只有ios、android）

最新評(píng)論