小程序的几个高度

文摘   2024-11-15 11:18   湖北  

wx.getSystemInfoSync()(已废弃)

功能描述:

同步获取设备的基本信息,包括设备品牌、型号、屏幕尺寸、窗口尺寸、系统信息等。此接口在基础库 2.20.1 后不再维护,建议使用新的接口。

返回值:

wx.getSystemInfoSync() 返回一个包含设备信息的对象(res)。以下是常见的属性:

属性类型说明最低版本
brandstring设备品牌1.5.0
modelstring设备型号(某些新设备可能显示 unknown
pixelRationumber设备像素比
screenWidthnumber屏幕宽度,单位 px1.1.0
screenHeightnumber屏幕高度,单位 px1.1.0
windowWidthnumber可使用窗口宽度,单位 px
windowHeightnumber可使用窗口高度,单位 px
statusBarHeightnumber状态栏的高度,单位 px1.9.0
languagestring微信设置的语言
versionstring微信版本号
systemstring操作系统及版本(如 iOSAndroid 等)
platformstring客户端平台(如 iosandroidwindows 等)
fontSizeSettingnumber用户字体大小(单位 px1.5.0
SDKVersionstring客户端基础库版本1.1.0
benchmarkLevelnumber设备性能等级(仅 Android)1.8.0
albumAuthorizedboolean允许微信使用相册的开关(仅 iOS 有效)2.6.0
cameraAuthorizedboolean允许微信使用摄像头的开关2.6.0
locationAuthorizedboolean允许微信使用定位的开关2.6.0
microphoneAuthorizedboolean允许微信使用麦克风的开关2.6.0
notificationAuthorizedboolean允许微信通知的开关(仅 iOS 有效)2.6.0
notificationAlertAuthorizedboolean允许微信通知带有提醒的开关(仅 iOS 有效)2.6.0
safeAreaObject设备的安全区域信息,部分机型不支持2.7.0
themestring当前系统主题,取值 light 或 dark2.11.0
hostObject小程序运行的宿主环境2.12.3
deviceOrientationstring设备方向,取值 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);
      }
    });
  }
});


字节笔记本
专注于科技领域的分享,AIGC,全栈开发,产品运营
 最新文章