Taro.getSystemInfoSync()
获取系统信息同步接口。
类型
() => 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 |
示例代码
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 | 微信小程序 | H5 | React Native |
---|---|---|---|
Taro.getSystemInfoSync | ✔️ | ✔️ | ✔️ |