建站
咨詢
售后
建站咨詢
新聞中心
- swan.getSystemInfoSync
- 方法參數(shù)
- 同步返回參數(shù)說明
- 示例
- 圖片示例
- 代碼示例
- Bug & Tip
- 錯誤碼
- Android
- Android
- 方法參數(shù)
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ī)型號 | - | |
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 版本號 | Web 態(tài)無宿主概念，返回空字符串 | |
system | String | 操作系統(tǒng)版本 | - | |
platform | String | 客戶端平臺，如：ios | Web 態(tài)下該字段為 ‘web’ | |
fontSizeSetting | Number | 用戶字體大小設(shè)置，用戶字體大小設(shè)置，表示當(dāng)前字體大小的等級，如 2 | Web 態(tài)下該字段為 2 | |
SDKVersion | String | 客戶端基礎(chǔ)庫版本 | Web 態(tài)無基礎(chǔ)庫版本管理，僅返回模擬值 999.999.999 | |
host | String | 宿主平臺，詳見宿主平臺枚舉值列表 | 3.30.2 | Web 態(tài)的 host 為 ‘web’ |
cacheLocation | Object | 上一次緩存的位置信息 | 安卓端最低基礎(chǔ)庫版本 3.40.4 ；ios 最低支持版本 3.70.2 | 暫不支持 |
swanNativeVersion | String | 宿主平臺版本號 | 最低支持版本 1.13.18 | Web 態(tài)無宿主概念，僅返回模擬值 |
devicePixelRatio | Number | 屏幕密度 | 安卓最低支持基礎(chǔ)庫版本 3.0.39 ； ios 最低支持版本 3.0.39 | - |
albumAuthorized | Boolean | 允許宿主使用相冊的開關(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)
代碼示例
請使用百度APP掃碼
圖片示例
代碼示例
- JS
// 完整代碼請點(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)用失??；基礎(chǔ)庫 3.140.1 及以后，接口調(diào)用失敗時會返回一個標(biāo)準(zhǔn)的
Error對象，可通過instanceof來判斷接口是否調(diào)用失敗。
錯誤碼
Android
| 錯誤碼 | 說明 |
|---|---|
202 | 解析失敗，請檢查參數(shù)是否正確 |
本文標(biāo)題：創(chuàng)新互聯(lián)百度小程序教程：swan.getSystemInfoSync
本文來源：http://www.dlmjj.cn/article/dpehpei.html
