swan.getSystemInfoSync
解释:获取系统信息同步接口
方法参数
无
同步返回参数说明
参数 | 说明 | 最低版本 |
---|---|---|
brand | 手机品牌 | |
model | 手机型号 | |
pixelRatio | 设备像素比 | |
screenWidth | 屏幕宽度 | |
screenHeight | 屏幕高度 | |
windowWidth | 可使用窗口宽度 | |
windowHeight | 可使用窗口高度 | |
statusBarHeight | 状态栏的高度 | |
navigationBarHeight | 导航栏的高度 | 3.0.17 |
language | 宿主 App 设置的语言 | |
version | 宿主 App 版本号 | |
system | 操作系统版本 | |
platform | 客户端平台,如:ios。 | |
fontSizeSetting | 用户字体大小设置 | |
SDKVersion | 客户端基础库版本 | |
host | 宿主平台,详见宿主平台枚举值列表 。 | 3.30.2 |
cacheLocation | 上一次缓存的位置信息 | 安卓端最低基础库版本3.40.4;ios最低支持版本3.70.2 |
swanNativeVersion | 宿主平台版本号 | 最低支持版本1.13.18 |
devicePixelRatio | 屏幕密度 | 安卓最低支持基础库版本3.0.39; ios最低支持版本3.0.39 |
albumAuthorized | 允许宿主使用相册的开关(仅 iOS 有效) | ios最低支持版本3.110.3; 开发者工具暂不支持 |
notificationAuthorized | 允许宿主通知的开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
notificationAlertAuthorized | 允许宿主通知带有提醒的开关(仅 iOS 有效) | ios最低支持版本3.110.3; 开发者工具暂不支持 |
notificationBadgeAuthorized | 允许宿主通知带有标记的开关(仅 iOS 有效) | ios最低支持版本3.110.3; 开发者工具暂不支持 |
notificationSoundAuthorized | 允许宿主通知带有声音的开关(仅 iOS 有效) | ios最低支持版本3.110.3; 开发者工具暂不支持 |
cameraAuthorized | 允许宿主使用摄像头的开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
locationAuthorized | 允许宿主使用定位的开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
microphoneAuthorized | 允许宿主使用麦克风的开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
locationEnabled | 地理位置的系统开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
wifiEnabled | Wi-Fi 的系统开关 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
safeArea | 在竖屏正方向下的安全区域 | 安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持 |
示例
扫码体验
请使用百度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);
}
错误码
Android
错误码 | 说明 |
---|---|
202 | 解析失败,请检查参数是否正确 |
Bug & Tip
- 基础库 3.140.1 之前,无法判断接口是否调用失败。
- 基础库 3.140.1 及以后,接口调用失败时会返回一个标准的
Error
对象,可通过instanceof
来判断接口是否调用失败。