swan.getSystemInfoSync

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扫码

图片示例

代码示例

// 完整代码请点击上方 "在开发者工具中打开" 预览
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	解析失败，请检查参数是否正确