普通小游戏开发
API
开放能力
数据分析
视频拍摄器
多端支持

tt.getSystemInfoSync

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

获取系统信息。

语法

tt.getSystemInfoSync();

参数说明

返回值

返回值为object类型,其属性与异步方法的success返回对象参数的扩展属性相同。

属性名类型说明示例最低支持版本
systemstring操作系统版本"11.4" | "8.0.0"1.0.0
platformstring操作系统类型"ios" | "android"1.0.0
brandstring手机品牌"Apple" | "Xiaomi"1.0.0
modelstring手机型号1.0.0
versionstring宿主 App 版本号(宿主指今日头条、抖音等)6.7.81.0.0
appNamestring宿主 APP 名称"Toutiao"1.0.0
SDKVersionstring客户端基础库版本"1.0.0"1.0.0
screenWidthnumber屏幕宽度1.0.0
screenHeightnumber屏幕高度1.0.0
windowWidthnumber可使用窗口宽度1.0.0
windowHeightnumber可使用窗口高度1.0.0
pixelRationumber设备像素比1.0.0
deviceScoreObject机型性能评分1.79.0

safeArea 的属性如下:

安全区域指的是一个可视窗口范围,处于安全区域的内容不受圆角(corners)、齐刘海(sensor housing)、小黑条(Home Indicator)影响。

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

deviceScore 的属性如下:

说明:安卓和 IOS,设备分数满分 10 分,分数越高说明设备越好。如果获取不到对应分数,返回-1。

属性类型说明
cpunumbercpu 分数
gpunumbergpu 分数
memorynumber内存分数
overallnumber综合评分

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
douyin_litestring抖音(极速版)1.0.0
live_stream_litestring火山(极速版)1.0.0
novel_fmstring番茄畅听1.0.0
novelappstring番茄小说1.0.0
readingstring番茄小说部分 IOS 版本1.0.0

扫码体验

请使用字节宿主APP扫码

代码示例

开发者工具中预览

try {
  var res = tt.getSystemInfoSync();
  console.log(`手机型号为 ${res.model}`);
} catch (error) {
  console.log(`获取系统信息失败`);
}

Bug & Tip

点击纠错
评价此篇文档