registerOnConnectFinished static method

void registerOnConnectFinished(
  1. void callback(
    1. GemError connection,
    2. NetworkType networkType,
    3. ProxyDetails? httpsProxyInfo,
    4. ProxyDetails? httpProxyInfo,
    )
)

Register a callback invoked when the connection attempt finished.

This callback receives detailed connection information such as the result code, the detected NetworkType and optional proxy details. Currently this registration is supported only on Android and will throw when called on other platforms.

Parameters

  • callback: Function called when a connection attempt finishes. The callback is called with the following arguments:
    • connection — a GemError describing the connection result (success or error).
    • networkType — the detected NetworkType.
    • httpsProxyInfo — optional HTTPS ProxyDetails when available.
    • httpProxyInfo — optional HTTP ProxyDetails when available.

Throws

Implementation

static void registerOnConnectFinished(
  void Function(
    GemError connection,
    NetworkType networkType,
    ProxyDetails? httpsProxyInfo,
    ProxyDetails? httpProxyInfo,
  )
  callback,
) {
  if (!Platform.isAndroid) {
    throw PlatformException(
      code: 'PlatformNotSupported',
      message: 'The platform is not Android.',
    );
  }
  _onConnectFinished = callback;
}