基础库 1.0.0 开始支持本方法，这是一个异步方法。

获取系统信息。如果在页面渲染时，需要通过调用 API 获取到的信息来设置节点宽高，建议在 Page.onReady 或者更后的时机调用，调用过早可能出现获取的宽高信息不准确。

前提条件	无
业务背景	无
使用限制	无
注意事项	Tip：暂不支持获取deviceId(设备唯一标识)； Tip：建议未使用到 windowWidth、windowHeight、battery、screenRatio 参数时，传入 useCache 参数为 true，可提升该 API 的响应速度； Tip：建议在使用 windowWidth、windowHeight、battery、screenRatio 参数时，调用同步 API tt.getSystemInfoSync，异步 API tt.getSystemInfo 的返回值可能因时序原因造成值不准确。
支持沙盒	否
相关教程	无

语法

tt.getSystemInfo(options)

参数说明

options 为 object 类型，属性如下：

属性名	类型	默认值	必填	说明	最低支持版本
useCache	boolean	false	否	是否使用缓存中的系统信息（默认不使用）	2.67.0
success	function		否	接口调用成功的回调函数	1.0.0
fail	function		否	接口调用失败的回调函数	1.0.0
complete	function		否	接口调用结束的回调函数（调用成功、失败都会执行）	1.0.0

useCache 为 true 时，以下字段可能不准确需要特别注意：

属性名	类型	说明	原因	最低支持版本
windowWidth	string	可使用窗口宽度	在 X 分屏场景下可使用窗口宽度可能为正常高度	1.0.0
windowHeight	string	可使用窗口高度	在 X 分屏场景下可使用窗口高度可能为正常高度	1.0.0
battery	number	电池电量	电池电量实时变化使用缓存值电池电量可能会不准确	2.53.0
screenRatio	number	分屏参数	分屏状态下，分屏比例会随拖动改变，使用缓存值分屏参数会不准确。	2.75.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"getSystemInfo:ok"	1.0.0
version	string	宿主 App 版本号（宿主指今日头条、抖音等）	1.0.0
brand	string	手机品牌	1.0.0
model	string	手机型号	1.0.0
system	string	操作系统版本	1.0.0
platform	string	操作系统类型，详情见操作系统说明	1.0.0
appName	string	宿主 APP 名称，详情见 appName 说明	1.0.0
SDKVersion	string	客户端基础库版本	1.0.0
screenWidth	number	屏幕宽度	1.0.0
screenHeight	number	屏幕高度	1.0.0
windowWidth	number	可使用窗口宽度	1.0.0
windowHeight	number	可使用窗口高度	1.0.0
statusBarHeight	number	状态栏的高度，单位 px	1.0.0
safeArea	object	在竖屏正方向下的安全区域，详情见 SafeArea 类型说明	1.51.0
pixelRatio	number	设备像素比	1.0.0
fontSizeSetting	number	字体大小	2.53.0
battery	number	电池电量	2.53.0
language	string	系统语言	2.53.0
screenRatio	number	分屏参数，即 X 分屏状态下，分屏占全屏幕的比例	2.75.0
orientation	enum	当前设备的屏幕方向	3.63.0

object 类型，属性如下：

属性名	类型	说明	最低支持版本
errMsg	string	"getSystemInfo:fail" + 详细错误信息	1.0.0

请使用字节宿主APP扫码