# Object wx.getSystemInfoSync()
从基础库 2.20.1 开始，本接口停止维护，请使用 wx.getSystemSetting、wx.getAppAuthorizeSetting、wx.getDeviceInfo、wx.getWindowInfo、wx.getAppBaseInfo 代替
以 Promise 风格 调用：支持
小程序插件：支持，需要小程序基础库版本不低于 1.9.6
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
# 功能描述
wx.getSystemInfo 的同步版本
# 返回值
# Object res
| 属性 | 类型 | 说明 | 最低版本 | |||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| brand | string | 设备品牌 | 1.5.0 | |||||||||||||||||||||||||||||
| model | string | 设备型号。新机型刚推出一段时间会显示unknown，微信会尽快进行适配。 | ||||||||||||||||||||||||||||||
| pixelRatio | number | 设备像素比 | ||||||||||||||||||||||||||||||
| screenWidth | number | 屏幕宽度，单位px | 1.1.0 | |||||||||||||||||||||||||||||
| screenHeight | number | 屏幕高度，单位px | 1.1.0 | |||||||||||||||||||||||||||||
| windowWidth | number | 可使用窗口宽度，单位px | ||||||||||||||||||||||||||||||
| windowHeight | number | 可使用窗口高度，单位px | ||||||||||||||||||||||||||||||
| statusBarHeight | number | 状态栏的高度，单位px | 1.9.0 | |||||||||||||||||||||||||||||
| language | string | 微信设置的语言 | ||||||||||||||||||||||||||||||
| version | string | 微信版本号 | ||||||||||||||||||||||||||||||
| system | string | 操作系统及版本 | ||||||||||||||||||||||||||||||
| platform | string | 客户端平台 | ||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
| fontSizeSetting | number | 用户字体大小（单位px）。以微信客户端「我-设置-通用-字体大小」中的设置为准 | 1.5.0 | |||||||||||||||||||||||||||||
| SDKVersion | string | 客户端基础库版本 | 1.1.0 | |||||||||||||||||||||||||||||
| benchmarkLevel | number | 设备性能等级（仅 Android）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好） 注意：性能等级当前仅反馈真机机型，暂不支持 IDE 模拟器机型 | 1.8.0 | |||||||||||||||||||||||||||||
| albumAuthorized | boolean | 允许微信使用相册的开关（仅 iOS 有效） | 2.6.0 | |||||||||||||||||||||||||||||
| cameraAuthorized | boolean | 允许微信使用摄像头的开关 | 2.6.0 | |||||||||||||||||||||||||||||
| locationAuthorized | boolean | 允许微信使用定位的开关 | 2.6.0 | |||||||||||||||||||||||||||||
| microphoneAuthorized | boolean | 允许微信使用麦克风的开关 | 2.6.0 | |||||||||||||||||||||||||||||
| notificationAuthorized | boolean | 允许微信通知的开关 | 2.6.0 | |||||||||||||||||||||||||||||
| notificationAlertAuthorized | boolean | 允许微信通知带有提醒的开关（仅 iOS 有效） | 2.6.0 | |||||||||||||||||||||||||||||
| notificationBadgeAuthorized | boolean | 允许微信通知带有标记的开关（仅 iOS 有效） | 2.6.0 | |||||||||||||||||||||||||||||
| notificationSoundAuthorized | boolean | 允许微信通知带有声音的开关（仅 iOS 有效） | 2.6.0 | |||||||||||||||||||||||||||||
| phoneCalendarAuthorized | boolean | 允许微信使用日历的开关 | 2.19.3 | |||||||||||||||||||||||||||||
| bluetoothEnabled | boolean | 蓝牙的系统开关 | 2.6.0 | |||||||||||||||||||||||||||||
| locationEnabled | boolean | 地理位置的系统开关 | 2.6.0 | |||||||||||||||||||||||||||||
| wifiEnabled | boolean | Wi-Fi 的系统开关 | 2.6.0 | |||||||||||||||||||||||||||||
| safeArea | Object | 在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。 | 2.7.0 | |||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
| locationReducedAccuracy | boolean | `true` 表示模糊定位，`false` 表示精确定位，仅 iOS 支持 | ||||||||||||||||||||||||||||||
| theme | string | 系统当前主题，取值为`light`或`dark`，全局配置`"darkmode":true`时才能获取，否则为 undefined （不支持小游戏） | 2.11.0 | |||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
| host | Object | 当前小程序运行的宿主环境 | 2.12.3 | |||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
| enableDebug | boolean | 是否已打开调试。可通过右上角菜单或 wx.setEnableDebug 打开调试。 | 2.15.0 | |||||||||||||||||||||||||||||
| deviceOrientation | string | 设备方向（注意：IOS客户端横屏游戏获取deviceOrientation可能不准，建议以屏幕宽高为准） | ||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
# 示例代码
wx.getSystemInfo({
success (res) {
console.log(res.model)
console.log(res.pixelRatio)
console.log(res.windowWidth)
console.log(res.windowHeight)
console.log(res.language)
console.log(res.version)
console.log(res.platform)
}
})
try {
const res = wx.getSystemInfoSync()
console.log(res.model)
console.log(res.pixelRatio)
console.log(res.windowWidth)
console.log(res.windowHeight)
console.log(res.language)
console.log(res.version)
console.log(res.platform)
} catch (e) {
// Do something when catch error
}
# 注意事项
- 当 wx.getSystemInfoSync() 接口发生错误时可能会返回空对象
- wx.getSystemInfo 接口由于会获取系统权限，可能触发授权弹窗，请使用 wx.getSystemSetting、wx.getAppAuthorizeSetting、wx.getDeviceInfo、wx.getWindowInfo、wx.getAppBaseInfo 替代