wx.getSystemInfo

  • 本接口文档同适用于 wx.getSystemInfoAsync
  • 获取系统信息,返回的 host 信息中的 appid 是多端应用的 appid,并非小程序的 appid

变更周知

  • 当 SDK >= 1.4.X,新增返回 miniappId 和 moduleId,含义查看文档说明

Object object

属性类型默认值必填说明
successfunction接口调用成功的回调函数
failfunction接口调用失败的回调函数
completefunction接口调用结束的回调函数(调用成功、失败都会执行)

object.success 回调函数参数

参数类型说明
brandstring设备品牌
modelstring设备型号
pixelRationumber设备像素比
screenWidthnumber屏幕宽度,单位px
screenHeightnumber屏幕高度,单位px
windowWidthnumber可使用窗口宽度,单位px
windowHeightnumber可使用窗口高度,单位px
statusBarHeightnumber状态栏的高度,单位px
systemstring操作系统及版本
platformstringandroid 表示 Android App;ios表示iOS App
SDKVersionstring基础库版本
benchmarkLevelstring设备性能等级
safeAreaObject在竖屏正方向下的安全区域
locationReducedAccuracybooleantrue 表示模糊定位,false 表示精确定位,仅 iOS 支持
themestring系统当前主题,取值为lightdark,全局配置"darkmode":true时才能获取,否则为 undefined (不支持小游戏)
hostObject当前应用运行的宿主环境
enableDebugboolean是否已打开调试
deviceOrientationstring设备方向
errMsgstring错误信息,新增返回
abistring新增返回,Android 设备的CPU类型

host

参数类型说明
envstring运行环境,值为 "SAAASDK"
appIdstring多端应用的 Id,不是小程序的 Appid
miniappIdstring多端应用的 Id ;SDK >= 1.4.X 新增返回该字段
moduleIdstring多端应用资源包的 Id ;SDK >= 1.4.X 新增返回该字段
versionstringSDK 版本串
packageNamestring对应 Android 应用的包名,Android 系统时返回
bundleIdentifierstring对应 iOS 的 Bundle ID ,iOS 系统时返回
appVersionstringApp 应用版本
versionCodestringApp 的 versionCode ;Android SDK >=1.4.8返回;iOS >=1.4.17返回
sdkVersionstringSDK 版本

wx.getSystemInfoSync

返回内容同 wx.getSystemInfoAsync 的 object.success 的回调函数参数

iOS 应用的 wx.getSystemInfo 返回 language 使用的映射关系更新说明

原始值实际返回值
zh-Hanszh_CN
zh-CNzh_CN
zh-Hantzh_TW
zh-TWzh_TW
zh-HKzh_HK
  • 其他未命中的语言统一返回系统设置的真实的 lang,例如: el-CN 返回 el