title: Taro.getSystemInfoSync()

sidebar_label: getSystemInfoSync

获取系统信息同步接口。

参考文档

类型

  1. () => Result

参数

Result

注意：H5 端不支持 version、statusBarHeight、fontSizeSetting、SDKVersion

参数 类型 说明
SDKVersion string 客户端基础库版本
albumAuthorized boolean 允许微信使用相册的开关（仅 iOS 有效）
benchmarkLevel number 设备性能等级（仅Android小游戏）。取值为：-2 或 0（该设备无法运行小游戏），-1（性能未知），>=1（设备性能值，该值越高，设备性能越好，目前最高不到50）
bluetoothEnabled boolean 蓝牙的系统开关
brand string 设备品牌
cameraAuthorized boolean 允许微信使用摄像头的开关
fontSizeSetting number 用户字体大小（单位px）。以微信客户端「我-设置-通用-字体大小」中的设置为准
language string 微信设置的语言
locationAuthorized boolean 允许微信使用定位的开关
locationEnabled boolean 地理位置的系统开关
microphoneAuthorized boolean 允许微信使用麦克风的开关
model string 设备型号
notificationAlertAuthorized boolean 允许微信通知带有提醒的开关（仅 iOS 有效）
notificationAuthorized boolean 允许微信通知的开关
notificationBadgeAuthorized boolean 允许微信通知带有标记的开关（仅 iOS 有效）
notificationSoundAuthorized boolean 允许微信通知带有声音的开关（仅 iOS 有效）
pixelRatio number 设备像素比
platform string 客户端平台
safeArea SafeAreaResult 在竖屏正方向下的安全区域
screenHeight number 屏幕高度，单位px
screenWidth number 屏幕宽度，单位px
statusBarHeight number 状态栏的高度，单位px
system string 操作系统及版本
version string 微信版本号
wifiEnabled boolean Wi-Fi 的系统开关
windowHeight number 可使用窗口高度，单位px
windowWidth number 可使用窗口宽度，单位px

示例代码

  1. try {
  2.   const res = Taro.getSystemInfoSync()
  3.   console.log(res.model)
  4.   console.log(res.pixelRatio)
  5.   console.log(res.windowWidth)
  6.   console.log(res.windowHeight)
  7.   console.log(res.language)
  8.   console.log(res.version)
  9.   console.log(res.platform)
  10. } catch (e) {
  11.   // Do something when catch error
  12. }

API 支持度

API 微信小程序 H5 React Native
Taro.getSystemInfoSync ✔️ ✔️ ✔️