从基础库 2.20.1 开始，本接口停止维护，请使用 wx.getSystemSetting、wx.getAppAuthorizeSetting、wx.getDeviceInfo、wx.getWindowInfo、wx.getAppBaseInfo 代替
以 Promise 风格 调用：支持
微信小程序插件：支持，需要微信小程序基础库版本不低于 1.9.6
微信 Windows 版：支持
微信 Mac 版：支持
微信 鸿蒙 OS 版：支持
功能描述
获取系统信息。由于历史原因，wx.getSystemInfo 是异步的调用格式，但是是同步返回，需要异步获取系统信息请使用 wx.getSystemInfoAsync。
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|
| success | function | | 否 | 接口调用成功的回调函数 |
| fail | function | | 否 | 接口调用失败的回调函数 |
| complete | function | | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
object.success 回调函数
参数
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 | 客户端平台 | |
| | 合法值 | 说明 |
|---|
| ios | iOS微信（包含 iPhone、iPad） | | android | Android微信 | | ohos | HarmonyOS 手机端微信 | | ohos_pc | HarmonyOS PC微信 | | windows | Windows微信 | | mac | macOS微信 | | devtools | 微信开发者工具 |
|
| 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 |
| | 结构属性 | 类型 | 说明 |
|---|
| left | number | 安全区域左上角横坐标 | | right | number | 安全区域右下角横坐标 | | top | number | 安全区域左上角纵坐标 | | bottom | number | 安全区域右下角纵坐标 | | width | number | 安全区域的宽度，单位逻辑像素 | | height | number | 安全区域的高度，单位逻辑像素 |
|
| locationReducedAccuracy | boolean | `true` 表示模糊定位，`false` 表示精确定位，仅 iOS 支持 | |
| theme | string | 系统当前主题，取值为`light`或`dark`，全局配置`”darkmode”:true`时才能获取，否则为 undefined （不支持小游戏） | 2.11.0 |
| | 合法值 | 说明 |
|---|
| dark | 深色主题 | | light | 浅色主题 |
|
| host | Object | 当前微信小程序运行的宿主环境 | 2.12.3 |
| | 结构属性 | 类型 | 说明 |
|---|
| appId | string | 宿主 app 对应的 appId |
|
| enableDebug | boolean | 是否已打开调试。可通过右上角菜单或 wx.setEnableDebug 打开调试。 | 2.15.0 |
| deviceOrientation | string | 设备方向（注意：iOS 客户端横屏游戏获取 deviceOrientation 可能不准，建议以屏幕宽高为准） | |
| | 合法值 | 说明 |
|---|
| portrait | 竖屏 | | landscape | 横屏 |
|
示例代码
在开发者工具中预览效果
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 替代