wx.getSystemInfoAsync(Object object)
异步获取系统信息。需要一定的微信客户端版本支持，在不支持的客户端上，会使用同步实现来返回。
基础库 2.14.1 开始支持，低版本需做兼容处理。
以 Promise 风格 调用：不支持
小程序插件：不支持
微信 Windows 版：支持
微信 Mac 版：支持
参数
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微信
|
| windows
|
Windows微信
|
| mac
|
macOS微信
|
|
|
|
fontSizeSetting
|
number
|
用户字体大小（单位px）。以微信客户端「我-设置-通用-字体大小」中的设置为准
|
1.5.0
|
|
|
SDKVersion
|
string
|
客户端基础库版本
|
1.1.0
|
|
|
benchmarkLevel
|
number
|
设备性能等级（仅 Android）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好，目前最高不到50）
|
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
|
在竖屏正方向下的安全区域
|
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
|
设备方向
|
|
|
|
| 合法值
|
说明
|
| portrait
|
竖屏
|
| landscape
|
横屏
|
|
示例代码
wx.getSystemInfoAsync({
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)
}
})
你我学习网