System Information

Definition

qg.getSystemInfo(Object object)

• Description

  Obtains the system information of the mobile phone.

• Parameters in object
  Expand

  Parameter	Type	Mandatory	Description
  success	function	No	Callback function triggered upon a successful API call. For details, please refer to Parameters in the success callback function.
  fail	function	No	Callback function triggered upon a failed API call.
  complete	function	No	If a function is passed, it will be called regardless of whether the API call succeeds or fails.

  • Parameters in the success callback function
    Expand

    Parameter	Type	Description
    brand	string	Device brand.
    model	string	Device model.
    pixelRatio	number	Device pixel ratio. NOTE To ensure that the obtained pixelRatio matches safeArea, set minPlatformVersion to 1078 or later.
    screenWidth	number	Screen width.
    screenHeight	number	Screen height.
    windowWidth	number	Available window width.
    windowHeight	number	Available window height.
    language	string	System language.
    region	string	System region.
    script	string	System language script settings.
    coreVersion	string	Version number of the rendering engine.
    COREVersion	string	Version number of the rendering engine.
    system	string	OS version.
    platform	string	Client platform.
    version	string	Version number of Quick App Center.
    statusBarHeight	number	Status bar height, which is determined by the actual screen resolution.
    platformVersionName	string	Platform version name. NOTE This field is returned only when minPlatformVersion of the quick game is 1078 or later.
    platformVersionCode	number	Standard version number of the platform. NOTE This field is returned only when minPlatformVersion of the quick game is 1078 or later.
    safeArea	object	Safe area in the upright portrait orientation. For details, please refer to Parameters in safeArea. NOTE This field is returned only when minPlatformVersion of the quick game is 1078 or later.

    • Parameters in safeArea
      Expand

      Attribute	Type	Description
      bottom	number	Vertical coordinate of the lower right corner of the safe area.
      left	number	Horizontal coordinate of the upper left corner of the safe area.
      right	number	Horizontal coordinate of the lower right corner of the safe area.
      top	number	Vertical coordinate of the upper left corner of the safe area.
      height	number	Height of the safe area. The value is the actual height (in pixels) divided by the device screen density.
      width	number	Width of the safe area. The value is the actual width (in pixels) divided by the device screen density.

• Sample code
  Collapse

  Word wrap

  Dark theme

  Copy code

  qg.getSystemInfo({
      success(res) {
          console.log("on getSystemInfo: success =" + JSON.stringify(res));
      },
      fail() {
          console.log("on getSystemInfo: fail");
      },
      complete() {
          console.log("on getSystemInfo: complete");
      }
  });

qg.getSystemInfoSync(Object object) (1078+)

• Description

  Obtains system information in synchronous mode.

• Returns

  For details, please refer to Parameters in the success callback function.

• Sample code
  Collapse

  Word wrap

  Dark theme

  Copy code

  var res = qg.getSystemInfoSync();
  console.log("on getSystemInfoSync: success =" + JSON.stringify(res));