wx.getSystemInfoSync()
(已废弃)
功能描述:
同步获取设备的基本信息,包括设备品牌、型号、屏幕尺寸、窗口尺寸、系统信息等。此接口在基础库 2.20.1 后不再维护,建议使用新的接口。
返回值:
wx.getSystemInfoSync()
返回一个包含设备信息的对象(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 | 操作系统及版本(如 iOS ,Android 等) | |
platform | string | 客户端平台(如 ios 、android 、windows 等) | |
fontSizeSetting | number | 用户字体大小(单位 px ) | 1.5.0 |
SDKVersion | string | 客户端基础库版本 | 1.1.0 |
benchmarkLevel | number | 设备性能等级(仅 Android) | 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 | 允许微信通知的开关(仅 iOS 有效) | 2.6.0 |
notificationAlertAuthorized | boolean | 允许微信通知带有提醒的开关(仅 iOS 有效) | 2.6.0 |
safeArea | Object | 设备的安全区域信息,部分机型不支持 | 2.7.0 |
theme | string | 当前系统主题,取值 light 或 dark | 2.11.0 |
host | Object | 小程序运行的宿主环境 | 2.12.3 |
deviceOrientation | string | 设备方向,取值 portrait 或 landscape |
示例代码(已废弃接口):
// 获取系统信息(同步)
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) {
// 处理错误
}
替代接口:
在基础库 2.20.1 之后,推荐使用以下接口替代 wx.getSystemInfoSync()
:
1. wx.getWindowInfo()
获取设备的窗口信息,包括状态栏高度、导航栏高度、窗口尺寸等。建议使用此接口来替代 wx.getSystemInfoSync()
,它支持 Promise 风格。
2. wx.getSystemSetting()
获取系统设置的相关信息,如系统的授权设置、通知权限等。
3. wx.getAppAuthorizeSetting()
获取应用的授权设置,主要用于获取应用对系统权限的授权状态。
4. wx.getDeviceInfo()
获取设备的详细信息,如设备型号、屏幕尺寸、分辨率等。
5. wx.getAppBaseInfo()
获取小程序的基本信息,如小程序的 appId、版本号等。
示例:使用 wx.getWindowInfo()
获取窗口信息
Page({
onLoad() {
wx.getWindowInfo({
success: (res) => {
console.log('状态栏高度:', res.statusBarHeight);
console.log('导航栏高度:', res.navigationBarHeight);
console.log('屏幕高度:', res.screenHeight);
console.log('窗口高度:', res.windowHeight);
},
fail: (err) => {
console.error('获取窗口信息失败', err);
}
});
}
});