Network

Definition

[h2]qg.getNetworkType(Object object)

• Description

  Obtains the network type.

• Parameters in object

  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

    Parameter	Type	Description
    networkType	string	Network type. For details, please refer to Valid values of networkType.

    • Valid values of networkType

      Attribute	Description
      wifi	Wi-Fi.
      2g	2G.
      3g	3G.
      4g	4G.
      5g	5G.
      unknown	Uncommon network type.
      none	No network.

• Sample code

  qg.getNetworkType({
          success : function (res) {
                  console.log("getNetworkType success networkType" + res.networkType );
          },
          fail:function(){
                  console.log("getNetworkType fail");
          },
          complete:function() {
                  console.log("getNetworkType complete");
          }
  });

[h2]qg.onNetworkStatusChange(function callback)

• Description

  Listens for the network status change event.

• Parameters

  Parameter	Type	Mandatory	Description
  callback	function	Yes	Callback function triggered when a network status change event occurs. For details, please refer to Parameters in callback.

  • Parameters in callback

    Parameter	Type	Description
    isConnected	boolean	Indicates whether there is a network connection.
    networkType	string	Network type. For details, please refer to Valid values of networkType.

• Sample code

  qg.onNetworkStatusChange(
      function callback(res){
          console.log("onNetworkStatusChange isConnected = " + res.isConnected + ", networkType = " + res.networkType);
      }
  );

[h2]qg.offNetworkStatusChange(function callback)

• Description

  Stops listening for the network status change event.

• Parameters

  Parameter	Type	Mandatory	Description
  callback	function	Yes	Callback function to be removed from the event listener.

• Sample code

  qg.offNetworkStatusChange(
      function callback(){
          console.log("offNetworkStatusChange");
      }
  );