qg.getSystemInfo / qg.getSystemInfoSync

基础信息说明

功能概述：获取系统信息，提供异步与同步两种调用方式。

项目	说明
版本要求	一般情况下无框架版本要求，如果要使用返回值对象中safeArea字段，则要求框架最低版本号为1051
前提条件	-
使用限制	-
相关教程	-

方法说明

方法名	签名	同步/异步	说明
getSystemInfo	qg.getSystemInfo(Object object): void	异步	获取系统信息并通过回调返回
getSystemInfoSync	qg.getSystemInfoSync(): Object	同步	获取系统信息的同步版本

参数说明

qg.getSystemInfo(object)

属性名	类型	默认值（如有）	必填	说明
success	Function	-	否	成功回调
fail	Function	-	否	失败回调
complete	Function	-	否	执行结束后的回调

qg.getSystemInfoSync
无参数，直接返回系统信息对象

回调结果说明

回调	触发时机	回调参数
success	获取系统信息成功	返回系统信息对象（见下）
fail	获取失败	使用形参接收，比如err，透传底层错误
complete	接口调用结束（成功/失败都会触发）	无

qg.getSystemInfo回调函数success的对象结构：

属性名	类型	说明
brand	String	设备品牌
model	String	设备型号
system	String	操作系统名称，如"Android 8.1.0"
platformVersionName	String	运行平台版本名称
platformVersionCode	Number	运行平台标准版本号，如"1040"
language	String	系统语言
screenWidth	Number	屏幕宽
screenHeight	Number	屏幕高
pixelRatio	Number	设备像素比
windowHeight	Number	可使用窗口高度
windowWidth	Number	可使用窗口宽度
statusBarHeight	Number	状态栏/异形缺口高度
safeArea	Object	安全区域是屏幕上不会被刘海或虚拟按键遮挡的可用显示区，框架1051+版本才支持

safeArea 对象

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

示例代码

qg.getSystemInfo({
  success: function (data) {
    console.info('getSystemInfo success', data);
  },
  fail: function (err) {
    console.info('getSystemInfo fail', err);
  },
  complete: function () {
    console.info('getSystemInfo complete' );
  },
})

const systemInfo = qg.getSystemInfoSync();
console.info('getSystemInfo success', systemInfo);

上一篇:生命周期

下一篇:图片

文档内容是否有帮助？

有帮助

无帮助