Skip to main content
Version: 2.x

Taro.getSystemInfoSync()

获取系统信息同步接口。

参考文档

类型

() => Result

参数

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

示例代码

try {
const res = Taro.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
}

API 支持度

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