- 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 |
解析失败，请检查参数是否正确 |
