swan.getSystemInfoSync

解釋：獲取系統(tǒng)信息同步接口
Web 態(tài)說明：由于瀏覽器的限制，在 Web 態(tài)下部分系統(tǒng)信息無法獲取，詳見下方 success 返回參數(shù)說明。

方法參數(shù)

無

同步返回參數(shù)說明

參數(shù)	參數(shù)類型	說明	最低版本	Web 態(tài)說明
brand	String	手機(jī)品牌		-
model	String	手機(jī)型號(hào)		-
pixelRatio	Number	設(shè)備像素比		-
screenWidth	Number	屏幕寬度		-
screenHeight	Number	屏幕高度		-
windowWidth	Number	可使用窗口寬度		-
windowHeight	Number	可使用窗口高度		-
statusBarHeight	Number	狀態(tài)欄的高度		-
navigationBarHeight	Number	導(dǎo)航欄的高度	3.0.17	-
language	String	宿主 App 設(shè)置的語言		-
version	String	宿主 App 版本號(hào)		Web 態(tài)無宿主概念，返回空字符串
system	String	操作系統(tǒng)版本		-
platform	String	客戶端平臺(tái)，如：ios		Web 態(tài)下該字段為 ‘web’
fontSizeSetting	Number	用戶字體大小設(shè)置，用戶字體大小設(shè)置，表示當(dāng)前字體大小的等級(jí)，如 2		Web 態(tài)下該字段為 2
SDKVersion	String	客戶端基礎(chǔ)庫版本		Web 態(tài)無基礎(chǔ)庫版本管理，僅返回模擬值 999.999.999
host	String	宿主平臺(tái)，詳見宿主平臺(tái)枚舉值列表	3.30.2	Web 態(tài)的 host 為 ‘web’
cacheLocation	Object	上一次緩存的位置信息	安卓端最低基礎(chǔ)庫版本 3.40.4 ；ios 最低支持版本 3.70.2	暫不支持
swanNativeVersion	String	宿主平臺(tái)版本號(hào)	最低支持版本 1.13.18	Web 態(tài)無宿主概念，僅返回模擬值
devicePixelRatio	Number	屏幕密度	安卓最低支持基礎(chǔ)庫版本 3.0.39 ； ios 最低支持版本 3.0.39	-
albumAuthorized	Boolean	允許宿主使用相冊(cè)的開關(guān)（僅 iOS 有效）	ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
notificationAuthorized	Boolean	允許宿主通知的開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
notificationAlertAuthorized	Boolean	允許宿主通知帶有提醒的開關(guān)（僅 iOS 有效）	ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
notificationBadgeAuthorized	Boolean	允許宿主通知帶有標(biāo)記的開關(guān)（僅 iOS 有效）	ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
notificationSoundAuthorized	Boolean	允許宿主通知帶有聲音的開關(guān)（僅 iOS 有效）	ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
cameraAuthorized	Boolean	允許宿主使用攝像頭的開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
locationAuthorized	Boolean	允許宿主使用定位的開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
microphoneAuthorized	Boolean	允許宿主使用麥克風(fēng)的開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
locationEnabled	Boolean	地理位置的系統(tǒng)開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
wifiEnabled	Boolean	Wi-Fi 的系統(tǒng)開關(guān)	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持
safeArea	Object	在豎屏正方向下的安全區(qū)域	安卓最低支持基礎(chǔ)庫版本 3.110.3 ； ios 最低支持版本 3.110.3 ；開發(fā)者工具暫不支持	暫不支持

示例

跳轉(zhuǎn)編輯工具

在開發(fā)者工具中打開

在 WEB IDE 中打開

掃碼體驗(yàn)

代碼示例

請(qǐng)使用百度APP掃碼

圖片示例

代碼示例

 
 
 
  
  
  // 完整代碼請(qǐng)點(diǎn)擊上方 "在開發(fā)者工具中打開" 預(yù)覽
  
  
  
  
  
  let res = swan.getSystemInfoSync();
  
  
  // 基礎(chǔ)庫 3.140.1 之前，無法判斷接口是否調(diào)用失敗
  
  
  // 基礎(chǔ)庫 3.140.1 及以后，通過 instanceof 來判斷接口是否調(diào)用失敗
  
  
  if (!(res instanceof Error)) {
  
  
   console.log('getSystemInfoSync success', res);
  
  
  }
  
  
  else {
  
  
   console.log('getSystemInfoSync fail', res.message);
  
  
  }

Bug & Tip

Tip：基礎(chǔ)庫 3.140.1 之前，無法判斷接口是否調(diào)用失?。换A(chǔ)庫 3.140.1 及以后，接口調(diào)用失敗時(shí)會(huì)返回一個(gè)標(biāo)準(zhǔn)的Error對(duì)象，可通過instanceof來判斷接口是否調(diào)用失敗。

錯(cuò)誤碼

Android

錯(cuò)誤碼	說明
202	解析失敗，請(qǐng)檢查參數(shù)是否正確

標(biāo)題名稱：創(chuàng)新互聯(lián)百度小程序教程：swan.getSystemInfoSync
當(dāng)前路徑：http://fisionsoft.com.cn/article/dpehpei.html

新聞中心

swan.getSystemInfoSync

方法參數(shù)

同步返回參數(shù)說明

示例

圖片示例

代碼示例

Bug & Tip

錯(cuò)誤碼

Android

其他資訊