引言
本文讲解微信小程序API调用之获取系统信息。
作者主要的使用场景是获取设备的长度和宽度及屏幕可用的长度和宽度，不少小伙伴会有疑问，前面的文章中提起过小程序的设计方案，选择IPhone 6作为设计模板，使用rpx作为组件尺寸以达到自适应，为什么还需要获取设备的px长度，接下来慢慢解释。
答疑解惑
使用scroll-view时，需要设置高度，宽度很好去设置，使用rpx为单位的宽度变得很容易。然高度需要使用屏幕的实际尺寸作参考。
接下来，我们来获取屏幕的长宽尺寸。
正文
获取系统信息有以下两种方式：
wx.getSystemInfo(Object object)Object wx.getSystemInfoSync()
wx.getSystemInfo(Object object)
参数
Object object
| 属性 | 类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 | |
| fail | function | 否 | 接口调用失败的回调函数 | |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
object.success 回调函数
参数
Object res
| 属性 | 类型 | 说明 | 最低版本 |
|---|---|---|---|
| brand | string | 设备品牌 | 1.5.0 |
| model | string | 设备型号 | |
| 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（设备性能值，该值越高，设备性能越好，目前最高不到50） | 1.8.0 |
示例代码
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)
}
})
Object wx.getSystemInfoSync()
wx.getSystemInfo的同步版本
返回值Object res
示例代码
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
}
详解
1. windowHeight 概念
可使用窗口高度，即：屏幕高度(screenHeight) - 导航(tabbar)高度。
2. 存在问题
安卓设备下获取windowHeight不能准确得到对应的高度，总是拿到屏幕高度。
3. 原因
- 同步接口
wx.getSystemInfoSync并不同步（猜测）
wx.getSystemInfoSync只是在页面初始化时提前计算。所以对于windowHeight这种需要进行功能判断的属性，应该使用异步接口，实时获取。
-
wx.getSystemInfo调用的时机不当
上面讲了
windowHeight的定义，所以这个值取决于tabbar是否存在。
为了保证tabbar显示后再进行取值，建议在生命周期的onReady钩子中调用接口wx.getSystemInfo。
4. 最终方案
在需要获取可使用窗口高度的对应js文件中，onReady 中调用wx.getSystemInfo
