# 系统信息

# qq.getSystemInfoSync

QQ mac版本:支持

QQ windows版本:支持

# Object qq.getSystemInfoSync()

qq.getSystemInfo 的同步版本

# 返回值

# Object res
属性 类型 说明 最低版本
brand string 设备品牌
model string 设备型号
pixelRatio number 设备像素比
screenWidth number 屏幕宽度,单位px
screenHeight number 屏幕高度,单位px
windowWidth number 可使用窗口宽度,单位px
windowHeight number 可使用窗口高度,单位px
statusBarHeight number 状态栏的高度,单位px
language string QQ设置的语言
version string QQ版本号
system string 操作系统及版本
platform string 客户端平台
SDKVersion string 客户端基础库版本
AppPlatform string App平台,手机QQ为'qq'
safeArea Object 在竖屏正方向下的安全区域
theme string 系统当前主题,取值为light或dark,全局配置"darkmode":true时才能获取,否则为undefined

res.safeArea 的结构

属性 类型 说明
left number 安全区域左上角横坐标
right number 安全区域右下角横坐标
top number 安全区域左上角纵坐标
bottom number 安全区域右下角纵坐标
width number 安全区域的宽度,单位逻辑像素
height number 安全区域的高度,单位逻辑像素

# 示例代码

qq.getSystemInfo({
  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)
  }
})
1
2
3
4
5
6
7
8
9
10
11
try {
  const res = qq.getSystemInfoSync()
  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)
} catch (e) {
  // Do something when catch error
}
1
2
3
4
5
6
7
8
9
10
11
12

# qq.getSystemInfo

QQ mac版本:支持

QQ windows版本:支持

# qq.getSystemInfo(Object object)

获取系统信息

# 参数

# Object object
属性 类型 默认值 必填 说明
success function 接口调用成功的回调函数
fail function 接口调用失败的回调函数
complete function 接口调用结束的回调函数(调用成功、失败都会执行)
# object.success 回调函数

参数

Object res

属性 类型 说明 最低版本
brand string 设备品牌
model string 设备型号
pixelRatio number 设备像素比
screenWidth number 屏幕宽度,单位px
screenHeight number 屏幕高度,单位px
windowWidth number 可使用窗口宽度,单位px
windowHeight number 可使用窗口高度,单位px
statusBarHeight number 状态栏的高度,单位px
language string QQ设置的语言
version string QQ版本号
system string 操作系统及版本
platform string 客户端平台
SDKVersion string 客户端基础库版本
AppPlatform string App平台,手机QQ为'qq'
safeArea Object 在竖屏正方向下的安全区域
theme string 系统当前主题,取值为light或dark,全局配置"darkmode":true时才能获取,否则为undefined

提示

PC小程序上述statusBarHeight字段返回值为0

# 示例代码

qq.getSystemInfo({
  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)
  }
})
1
2
3
4
5
6
7
8
9
10
11
try {
  const res = qq.getSystemInfoSync()
  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)
} catch (e) {
  // Do something when catch error
}
1
2
3
4
5
6
7
8
9
10
11
12