系统信息

qg.getSystemInfo(Object object)

获取系统信息

参数

Object object

属性	类型	是否必填	说明
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数

object.success(Object res) 回调函数

属性	类型	说明	OPPO	vivo	小米	荣耀
manufacturer	String	设备生产商		✓
brand	String	手机品牌	✓	✓	✓	✓
model	String	设备型号	✓	✓	✓	✓
product	String	设备代号		✓
pixelRatio	Number	设备像素比	✓		✓	✓
benchmarkLevel	String	设备性能等级（仅 Android）值越大，性能越好	✓
deviceOrientation	String	设备方向	✓
language	String	语言	✓	✓	✓	✓
region	String	地区		✓
theme	String	主题	✓
battery	Number	电量		✓
wifiSignal	Number	wifi 信号强度，范围 0 - 4		✓
osType	String	操作系统名称		✓
osVersionName	String	操作系统版本名称		✓
osVersionCode	Number	操作系统版本号		✓
system	String	操作系统及版本	✓		✓	✓
platformVersionName	String	客户端平台	✓	✓	✓	✓
platformVersionCode	Number	平台版本号	✓	✓	✓	✓
allianceVersion	Number	联盟版本号，默认 1300	✓	✓	✓	✓
COREVersion	Number	渲染引擎版本号	✓
miniGame	Object	游戏包的运行时信息		✓
screenWidth	Number	屏幕宽度，单位 px	✓	✓	✓	✓
screenHeight	Number	屏幕高度，单位 px	✓	✓	✓	✓
windowWidth	Number	可使用窗口宽度，单位 px	✓		✓	✓
windowHeight	Number	可使用窗口高度，单位 px	✓		✓	✓
statusBarHeight	Number	状态栏的高度，单位 px	✓	✓	✓	✓
isNotch	Boolean	是否是刘海屏		✓
isHole	Boolean	是否是挖孔屏		✓
hole_x	Number	挖孔屏 x 坐标		✓
hole_y	Number	挖孔屏 y 坐标		✓
hole_radius	Number	挖孔屏半径		✓
safeArea	Object	在竖屏正方向下的安全区域		✓	✓	✓

data.safeArea 的结构

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

data.miniGame 的结构

属性	类型	说明
package	String	当前游戏的包名
version	Number	当前游戏的版本号
buildType	String	构建类型，dev:开发版、test:测试版、trial:体验版、release:正式版，详见开发者工具-打包

代码示例：

qg.getSystemInfo({
  success: function(res) {
    console.log(res.brand);
    console.log(res.language);
    console.log(res.model);
    console.log(res.platform);
    console.log(res.screenHeight);
    console.log(res.screenWidth);
    // ...
  },
  fail: function(err) {},
  complete: function(res) {}
});

qg.getSystemInfoSync()

获取系统信息的同步版本

返回值

Object res

属性	类型	说明	OPPO	vivo	小米	荣耀
manufacturer	String	设备生产商		✓
brand	String	手机品牌	✓	✓	✓	✓
model	String	设备型号	✓	✓	✓	✓
product	String	设备代号		✓
pixelRatio	Number	设备像素比	✓		✓	✓
benchmarkLevel	String	设备性能等级（仅 Android）值越大，性能越好	✓
deviceOrientation	String	设备方向	✓
language	String	语言	✓	✓	✓	✓
region	String	地区		✓
theme	String	主题	✓
battery	Number	电量		✓
wifiSignal	Number	wifi 信号强度，范围 0 - 4		✓
osType	String	操作系统名称		✓
osVersionName	String	操作系统版本名称		✓
osVersionCode	Number	操作系统版本号		✓
system	String	操作系统及版本	✓		✓	✓
platformVersionName	String	客户端平台	✓	✓	✓	✓
platformVersionCode	Number	平台版本号	✓	✓	✓	✓
allianceVersion	Number	联盟版本号，默认 1300	✓	✓	✓	✓
COREVersion	Number	渲染引擎版本号	✓
miniGame	Object	游戏包的运行时信息		✓
screenWidth	Number	屏幕宽度，单位 px	✓	✓	✓	✓
screenHeight	Number	屏幕高度，单位 px	✓	✓	✓	✓
windowWidth	Number	可使用窗口宽度，单位 px	✓		✓	✓
windowHeight	Number	可使用窗口高度，单位 px	✓		✓	✓
statusBarHeight	Number	状态栏的高度，单位 px	✓	✓	✓	✓
isNotch	Boolean	是否是刘海屏		✓
isHole	Boolean	是否是挖孔屏		✓
hole_x	Number	挖孔屏 x 坐标		✓
hole_y	Number	挖孔屏 y 坐标		✓
hole_radius	Number	挖孔屏半径		✓
safeArea	Object	在竖屏正方向下的安全区域		✓	✓	✓

data.safeArea 的结构

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

data.miniGame 的结构

属性	类型	说明
package	String	当前游戏的包名
version	Number	当前游戏的版本号
buildType	String	构建类型，dev:开发版、test:测试版、trial:体验版、release:正式版，详见开发者工具-打包

示例

var data = qg.getSystemInfoSync();
console.log(data.brand);

qg.getProvider()

获取渠道的名称

返回值

String 类型

代码示例：

var provider = qg.getProvider();
console.log(provider);

渠道	类型	返回值
OPPO	String	OPPO
vivo	String	vivo
小米	String	Xiaomi、Redmi
荣耀	String	HONOR

qg.getManifestInfo(Object object)

获取本地包中 manifest.json 的内容信息

参数

Object object

属性	类型	是否必填	说明
success	Function	否	接口调用成功的回调函数
fail	Function	否	接口调用失败的回调函数
complete	Function	否	接口调用结束的回调函数

object.success(Object res) 回调函数

属性	类型	说明
manifest	String	json 字符串

manifest 为 manifest.json 中的信息，具体内容如下

属性	类型	说明
package	String	游戏包名
name	String	游戏名
versionName	String	游戏版本名
versionCode	String	游戏版本号
minPlatformVersion	String	最小平台版本号
icon	String	桌面图标
orientation	String	设备方向
type	String	不填或者默认值为 app，取值为 app 或 game
allianceVersion	String	默认联盟版本号，默认 1300
config	Object	logLevel 取值
subpackages	Object	分包功能，有分包时才需要，可选字段

注：其他字段继承自快应用，详情可查看：https://doc.quickapp.cn/framework/manifest.html

代码示例：

qg.getManifestInfo({
  success: function(res) {
    console.log(JSON.parse(res.manifest));
  },
  fail: function(err) {},
  complete: function(res) {}
});

qg.getWindowInfo()

获取窗口信息

返回值

Object object

属性	类型	说明
pixelRatio	Number	设备像素比
windowWidth	Number	可使用窗口宽度，单位 px
windowHeight	Number	可使用窗口高度，单位 px
statusBarHeight	Number	状态栏的高度，单位 px
safeArea	Object	在竖屏正方向下的安全区域。部分机型没有安全区域概念，也不会返回 safeArea 字段，开发者需自行兼容。
screenTop	Number	窗口上边缘的 y 值

safeArea（在竖屏正方向下的安全区域）

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

示例代码

const windowInfo = qg.getWindowInfo();

console.log(windowInfo.pixelRatio);
console.log(windowInfo.windowWidth);
console.log(windowInfo.windowHeight);
console.log(windowInfo.statusBarHeight);
console.log(windowInfo.safeArea);
console.log(windowInfo.screenTop);

系统信息

qg.getSystemInfo(Object object)

参数

object.success(Object res) 回调函数

data.safeArea 的结构

data.miniGame 的结构

qg.getSystemInfoSync()

返回值

data.safeArea 的结构

data.miniGame 的结构

示例

qg.getProvider()

返回值

qg.getManifestInfo(Object object)

参数

object.success(Object res) 回调函数

manifest 为 manifest.json 中的信息，具体内容如下

qg.getWindowInfo()

返回值

safeArea（在竖屏正方向下的安全区域）

示例代码

条匹配 "" 的结果

没有搜索到与 "" 相关的内容