获取系统信息,支持 Promise 化使用。

参考文档

类型

  1. (res?: Option) => Promise<Result>

参数

Option

参数类型必填说明
complete(res: any) => void接口调用结束的回调函数(调用成功、失败都会执行)
fail(res: any) => void接口调用失败的回调函数
success(res: Result) => void接口调用成功的回调函数

Result

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

参数类型说明
SDKVersionstring客户端基础库版本
albumAuthorizedboolean允许微信使用相册的开关(仅 iOS 有效)
benchmarkLevelnumber设备性能等级(仅Android小游戏)。取值为:-2 或 0(该设备无法运行小游戏),-1(性能未知),>=1(设备性能值,该值越高,设备性能越好,目前最高不到50)
bluetoothEnabledboolean蓝牙的系统开关
brandstring设备品牌
cameraAuthorizedboolean允许微信使用摄像头的开关
fontSizeSettingnumber用户字体大小(单位px)。以微信客户端「我-设置-通用-字体大小」中的设置为准
languagestring微信设置的语言
locationAuthorizedboolean允许微信使用定位的开关
locationEnabledboolean地理位置的系统开关
microphoneAuthorizedboolean允许微信使用麦克风的开关
modelstring设备型号
notificationAlertAuthorizedboolean允许微信通知带有提醒的开关(仅 iOS 有效)
notificationAuthorizedboolean允许微信通知的开关
notificationBadgeAuthorizedboolean允许微信通知带有标记的开关(仅 iOS 有效)
notificationSoundAuthorizedboolean允许微信通知带有声音的开关(仅 iOS 有效)
pixelRationumber设备像素比
platformstring客户端平台
safeAreaSafeAreaResult在竖屏正方向下的安全区域
screenHeightnumber屏幕高度,单位px
screenWidthnumber屏幕宽度,单位px
statusBarHeightnumber状态栏的高度,单位px
systemstring操作系统及版本
versionstring微信版本号
wifiEnabledbooleanWi-Fi 的系统开关
windowHeightnumber可使用窗口高度,单位px
windowWidthnumber可使用窗口宽度,单位px
errMsgstring调用结果

示例代码

示例 1

  1. Taro.getSystemInfo({
  2. success: res => console.log(res)
  3. })
  4. .then(res => console.log(res))

示例 2

  1. Taro.getSystemInfo({
  2. success: function (res) {
  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. }
  11. })

API 支持度

API微信小程序H5React Native
Taro.getSystemInfo✔️✔️✔️