# wx.getSystemInfoAsync(Object object)

Start from base library version 2.14.1. Please remaining backward compatible.

with Promise style call: Not supported

Mini Program plugin: Not supported

Get system information asynchronously. Need some WeChat client version support, in the unsupported client, will use synchronization to return.

# parameter

# Object object

attribute type Default values Required Introductions
success function no Interface calls the successful callback function
fail function no Interface calls failed callback functions
complete function no Callback function at the end of an interface call (both successful and unsuccessful calls are executed)

# object.success callback

# parameter
# Object res
attribute type Introductions Minimum version
brand string Equipment brand 1.5.0
model string Device model. New models will show unknown for a while, WeChat will adapt as soon as possible.
pixelRatio number Device pixel ratio
screenWidth number Screen width, in px 1.1.0
screenHeight number Screen height, in px 1.1.0
windowWidth number Available window width, unit px
windowHeight number Available window height, in px
statusBarHeight number Height of status bar in px 1.9.0
language string Language of WeChat settings
version string WeChat version number
system string Operating System and Version
platform string Client platform
fontSizeSetting number User font size in px. WeChat ClientI - Settings - Universal - Font SizeThe settings in 1.5.0
SDKVersion string Client base library version 1.1.0
benchmarkLevel number Equipment Performance Level (only Android)。 Values are: -2 or 0 (the device cannot run games), -1 (performance unknown),>= 1 (Device Performance Value, higher the value, better device performance, currently up to less than 50) 1.8.0
albumAuthorized boolean Allow WeChat to use the Photo Album switch (only iOS Effective) 2.6.0
cameraAuthorized boolean Switch that allows WeChat to use the camera 2.6.0
locationAuthorized boolean Allow WeChat to use location switch 2.6.0
microphoneAuthorized boolean Switch allowing WeChat to use microphone 2.6.0
notificationAuthorized boolean Switch that allows WeChat notifications 2.6.0
notificationAlertAuthorized boolean Allow WeChat to notify switches with reminders (only iOS Effective) 2.6.0
notificationBadgeAuthorized boolean Allow WeChat notifications with marked switches (only iOS Effective) 2.6.0
notificationSoundAuthorized boolean Allow WeChat to notify switches with sound (only iOS Effective) 2.6.0
phoneCalendarAuthorized boolean Switch that allows WeChat to use the calendar 2.19.3
bluetoothEnabled boolean Bluetooth System Switch 2.6.0
locationEnabled boolean Geographic Location System Switch 2.6.0
wifiEnabled boolean Wi-Fi System switch 2.6.0
safeArea Object A safe area in the positive direction of the vertical screen 2.7.0
locationReducedAccuracy boolean true Represents fuzzy positioning,false For precise positioning, only iOS Support
theme string System current theme, with a value oflightordark, global configuration'darkmode': trueCan be obtained when otherwise undefined (Small games not supported) 2.11.0
host Object Host environment for current Mini Programs 2.12.3
enableDebug boolean Whether debugging is turned on. Available from the top right menu or wx.setEnableDebug Turn on debugging. 2.15.0
deviceOrientation string Equipment direction

safeArea Structure

attribute type Introductions
left number Upper left abscissa of security area
right number Security area lower right abscissa
top number Top-left ordinate of security area
bottom number Lower right ordinate of security area
width number Width of security area, unit logical pixels
height number Height of Safe Area, Unit Logical Pixels

theme Legal value

value Introductions Minimum version
dark Dark theme
light Light color theme

host Structure

attribute type Introductions
appId string host app Corresponding appId

deviceOrientation Legal value

value Introductions Minimum version
portrait Vertical screen
landscape Horizontal screen

# sample code

Preview with Developer Tool

wx.getSystemInfoAsync({
  success (res) {
    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)
  }
})