阅读(1.2k) 书签赞(0) 我要纠错

百度智能小程序获取系统信息同步接口

2020-09-05 14:21 更新

swan.getSystemInfoSync

Tip：基础库 3.140.1 之前，无法判断接口是否调用失败；基础库 3.140.1 及以后，接口调用失败时会返回一个标准的Error对象，可通过instanceof来判断接口是否调用失败。

解释：获取系统信息同步接口

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 版本号		-
system	String	操作系统版本		-
platform	String	客户端平台，如：ios 。		-
fontSizeSetting	Number	用户字体大小设置，取值为 1、2、3、4，分别对应小、中、大、特大四种字体等级。		-
SDKVersion	String	客户端基础库版本		-
host	String	宿主平台，详见宿主平台枚举值列表。	3.30.2	-
cacheLocation	Object	上一次缓存的位置信息	安卓端最低基础库版本 3.40.4 ；ios 最低支持版本 3.70.2 。	暂不支持
swanNativeVersion	String	宿主平台版本号	最低支持版本 1.13.18	-
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 ；开发者工具暂不支持。	暂不支持

示例

在开发者工具中打开

图片示例

代码示例

//  完整代码请点击上方 "在开发者工具中打开" 预览

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);
}