Object wx.getSystemInfoSync()

本接口从基础库版本 1.9.6 起支持在小程序插件中使用

wx.getSystemInfo 的同步版本

返回值

Object res

属性类型说明最低版本
brandstring设备品牌1.5.0
modelstring设备型号。新机型刚推出一段时间会显示unknown,微信会尽快进行适配。
pixelRationumber设备像素比
screenWidthnumber屏幕宽度,单位px1.1.0
screenHeightnumber屏幕高度,单位px1.1.0
windowWidthnumber可使用窗口宽度,单位px
windowHeightnumber可使用窗口高度,单位px
statusBarHeightnumber状态栏的高度,单位px1.9.0
languagestring微信设置的语言
versionstring微信版本号
systemstring操作系统及版本
platformstring客户端平台
fontSizeSettingnumber用户字体大小(单位px)。以微信客户端「我-设置-通用-字体大小」中的设置为准1.5.0
SDKVersionstring客户端基础库版本1.1.0
benchmarkLevelnumber设备性能等级(仅 Android)。取值为:-2 或 0(该设备无法运行小游戏),-1(性能未知),>=1(设备性能值,该值越高,设备性能越好,目前最高不到50)1.8.0
albumAuthorizedboolean允许微信使用相册的开关(仅 iOS 有效)2.6.0
cameraAuthorizedboolean允许微信使用摄像头的开关2.6.0
locationAuthorizedboolean允许微信使用定位的开关2.6.0
microphoneAuthorizedboolean允许微信使用麦克风的开关2.6.0
notificationAuthorizedboolean允许微信通知的开关2.6.0
notificationAlertAuthorizedboolean允许微信通知带有提醒的开关(仅 iOS 有效)2.6.0
notificationBadgeAuthorizedboolean允许微信通知带有标记的开关(仅 iOS 有效)2.6.0
notificationSoundAuthorizedboolean允许微信通知带有声音的开关(仅 iOS 有效)2.6.0
bluetoothEnabledboolean蓝牙的系统开关2.6.0
locationEnabledboolean地理位置的系统开关2.6.0
wifiEnabledbooleanWi-Fi 的系统开关2.6.0
safeAreaObject在竖屏正方向下的安全区域2.7.0
locationReducedAccuracybooleantrue 表示模糊定位,false 表示精确定位,仅 iOS 支持
themestring系统当前主题,取值为lightdark,全局配置“darkmode”:true时才能获取,否则为 undefined (不支持小游戏)2.11.0
enableDebugboolean是否已打开调试。可通过右上角菜单或 wx.setEnableDebug 打开调试。2.15.0
deviceOrientationstring设备方向

safeArea 的结构

属性类型说明
leftnumber安全区域左上角横坐标
rightnumber安全区域右下角横坐标
topnumber安全区域左上角纵坐标
bottomnumber安全区域右下角纵坐标
widthnumber安全区域的宽度,单位逻辑像素
heightnumber安全区域的高度,单位逻辑像素

theme 的合法值

说明最低版本
‘dark’深色主题
‘light’浅色主题

deviceOrientation 的合法值

说明最低版本
‘portrait’竖屏
‘landscape’横屏

示例代码

  1. wx.getSystemInfo({
  2. success (res) {
  3. console.log(res.model)
  4. console.log(res.pixelRatio)
  5. console.log(res.windowWidth)
  6. console.log(res.windowHeight)
  7. console.log(res.language)
  8. console.log(res.version)
  9. console.log(res.platform)
  10. }
  11. })
  1. try {
  2. const res = wx.getSystemInfoSync()
  3. console.log(res.model)
  4. console.log(res.pixelRatio)
  5. console.log(res.windowWidth)
  6. console.log(res.windowHeight)
  7. console.log(res.language)
  8. console.log(res.version)
  9. console.log(res.platform)
  10. } catch (e) {
  11. // Do something when catch error
  12. }