swan.getSystemInfoSync

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

方法参数

同步返回参数说明

参数说明最低版本
brand手机品牌
model手机型号
pixelRatio设备像素比
screenWidth屏幕宽度
screenHeight屏幕高度
windowWidth可使用窗口宽度
windowHeight可使用窗口高度
statusBarHeight状态栏的高度
navigationBarHeight导航栏的高度3.0.17
language宿主 App 设置的语言
version宿主 App 版本号
system操作系统版本
platform客户端平台,如:ios。
fontSizeSetting用户字体大小设置
SDKVersion客户端基础库版本
host宿主平台,详见宿主平台枚举值列表swan.getSystemInfoSync - 图13.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; 开发者工具暂不支持
wifiEnabledWi-Fi 的系统开关安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持
safeArea在竖屏正方向下的安全区域安卓最低支持基础库版本3.110.3; ios最低支持版本3.110.3; 开发者工具暂不支持

示例

在开发者工具中预览效果

扫码体验

swan.getSystemInfoSync - 图2请使用百度APP扫码

图片示例

swan.getSystemInfoSync - 图3

swan.getSystemInfoSync - 图4

swan.getSystemInfoSync - 图5

代码示例

  • 在 js 文件中
  1. let res = swan.getSystemInfoSync();
  2. // 基础库 3.140.1 之前,无法判断接口是否调用失败
  3. // 基础库 3.140.1 及以后,通过 instanceof 来判断接口是否调用失败
  4. if (!(res instanceof Error)) {
  5. console.log('getSystemInfoSync success', res);
  6. }
  7. else {
  8. console.log('getSystemInfoSync fail', res.message);
  9. }

错误码

Android

错误码说明
202解析失败,请检查参数是否正确

Bug & Tip

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