- swan.getSystemInfoSync
- 方法参数
- 同步返回参数说明
- 示例
- 图片示例
- 代码示例
- Bug & Tip
- 错误码
- Android
- Android
- 方法参数
swan.getSystemInfoSync
解释:获取系统信息同步接口
Web 态说明:由于浏览器的限制,在 Web 态下部分系统信息无法获取,详见下方 success 返回参数说明。

方法参数
无
同步返回参数说明
| 参数 | 参数类型 | 说明 | 最低版本 | Web 态说明 |
|---|---|---|---|---|
brand | String | 手机品牌 | - | |
model | String | 手机型号 | - | |
pixelRatio | Number | 设备像素比 | - | |
screenWidth | Number | 屏幕宽度 | - | |
screenHeight | Number | 屏幕高度 | - | |
windowWidth | Number | 可使用窗口宽度 | - | |
windowHeight | Number | 可使用窗口高度 | - | |
statusBarHeight | Number | 状态栏的高度 | - | |
navigationBarHeight | Number | 导航栏的高度 | 3.0.17 | - |
language | String | 宿主 App 设置的语言 | - | |
version | String | 宿主 App 版本号 | Web 态无宿主概念,返回空字符串 | |
system | String | 操作系统版本 | - | |
platform | String | 客户端平台,如:ios | Web 态下该字段为 ‘web’ | |
fontSizeSetting | Number | 用户字体大小设置,用户字体大小设置,表示当前字体大小的等级,如 2 | Web 态下该字段为 2 | |
SDKVersion | String | 客户端基础库版本 | Web 态无基础库版本管理,仅返回模拟值 999.999.999 | |
host | String | 宿主平台,详见宿主平台枚举值列表 | 3.30.2 | Web 态的 host 为 ‘web’ |
cacheLocation | Object | 上一次缓存的位置信息 | 安卓端最低基础库版本 3.40.4 ;ios 最低支持版本 3.70.2 | 暂不支持 |
swanNativeVersion | String | 宿主平台版本号 | 最低支持版本 1.13.18 | Web 态无宿主概念,仅返回模拟值 |
devicePixelRatio | Number | 屏幕密度 | 安卓最低支持基础库版本 3.0.39 ; ios 最低支持版本 3.0.39 | - |
albumAuthorized | Boolean | 允许宿主使用相册的开关(仅 iOS 有效) | ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
notificationAuthorized | Boolean | 允许宿主通知的开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
notificationAlertAuthorized | Boolean | 允许宿主通知带有提醒的开关(仅 iOS 有效) | ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
notificationBadgeAuthorized | Boolean | 允许宿主通知带有标记的开关(仅 iOS 有效) | ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
notificationSoundAuthorized | Boolean | 允许宿主通知带有声音的开关(仅 iOS 有效) | ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
cameraAuthorized | Boolean | 允许宿主使用摄像头的开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
locationAuthorized | Boolean | 允许宿主使用定位的开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
microphoneAuthorized | Boolean | 允许宿主使用麦克风的开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
locationEnabled | Boolean | 地理位置的系统开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
wifiEnabled | Boolean | Wi-Fi 的系统开关 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
safeArea | Object | 在竖屏正方向下的安全区域 | 安卓最低支持基础库版本 3.110.3 ; ios 最低支持版本 3.110.3 ; 开发者工具暂不支持 | 暂不支持 |
示例
跳转编辑工具
在开发者工具中打开
在 WEB IDE 中打开
扫码体验
代码示例
请使用百度APP扫码
图片示例
代码示例
- JS
// 完整代码请点击上方 "在开发者工具中打开" 预览let res = swan.getSystemInfoSync();// 基础库 3.140.1 之前,无法判断接口是否调用失败// 基础库 3.140.1 及以后,通过 instanceof 来判断接口是否调用失败if (!(res instanceof Error)) {console.log('getSystemInfoSync success', res);}else {console.log('getSystemInfoSync fail', res.message);}
Bug & Tip
- Tip:基础库 3.140.1 之前,无法判断接口是否调用失败;基础库 3.140.1 及以后,接口调用失败时会返回一个标准的
Error对象,可通过instanceof来判断接口是否调用失败。
错误码
Android
| 错误码 | 说明 |
|---|---|
202 | 解析失败,请检查参数是否正确 |
本文标题:创新互联百度小程序教程:swan.getSystemInfoSync
转载来于:http://www.jxjierui.cn/article/dpehpei.html


咨询
建站咨询
