开发
API

tt.getSystemInfoSync

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

获取系统信息。

语法

tt.getSystemInfoSync()

参数说明

返回值

object 类型,属性如下:

属性名类型说明最低支持版本
systemstring操作系统版本1.0.0
platformstring操作系统类型1.0.0
brandstring手机品牌1.0.0
modelstring手机型号1.0.0
versionstring宿主 App 版本号(宿主指今日头条、抖音等)1.0.0
appNamestring宿主 APP 名称,详情见 appName 说明1.0.0
SDKVersionstring客户端基础库版本1.0.0
screenWidthnumber屏幕宽度1.0.0
screenHeightnumber屏幕高度1.0.0
windowWidthnumber可使用窗口宽度1.0.0
windowHeightnumber可使用窗口高度1.0.0
pixelRationumber设备像素比1.0.0
statusBarHeightnumber状态栏的高度,单位 px1.0.0
safeAreaSafeArea在竖屏正方向下的安全区域,详情见 SafeArea 类型说明1.51.0
batterynumber电池电量2.53.0
fontSizeSettingstring字体大小2.53.0
languagestring系统语言2.53.0

SafeArea 类型说明

object 类型,属性如下:

属性名类型说明最低支持版本
leftnumber安全区域左上角横坐标1.51.0
rightnumber安全区域右下角横坐标1.51.0
topnumber安全区域左上角纵坐标1.51.0
bottomnumber安全区域右下角纵坐标1.51.0
widthnumber安全区域的宽度,单位逻辑像素1.51.0
heightnumber安全区域的高度,单位逻辑像素1.51.0

appName 说明

返回值如下:

返回值类型说明最低支持版本
Toutiaostring今日头条1.0.0
Douyinstring抖音(国内版)1.0.0
news_article_litestring今日头条(极速版)1.0.0
live_streamstring火山小视频1.0.0
XiGuastring西瓜1.0.0
PPXstring皮皮虾1.0.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

try {
  const res = tt.getSystemInfoSync();
  console.log("获取系统信息成功: ", res);
} catch (error) {
  console.log("获取系统信息失败: ", error);
}

Bug & Tip

  • Tip:暂不支持获取deviceId(设备唯一标识)。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助