How to Use the OnNetworkStateChanged Callback Function

Overview

Starting with SurveyToGo Studio 1.32.280, you can use the OnNetworkStateChanged(inNetworkName, inInternetReachable) callback function to detect changes in the device's network connectivity.

The callback is automatically triggered whenever the active network connection changes, such as when the device connects to or disconnects from Wi-Fi or a mobile network.

You can use this callback to notify the interviewer, log connectivity changes, or execute any custom logic when the network status changes.

Add the Callback Function

Add the following callback to the survey's Advanced Scripts:

function OnNetworkStateChanged(inNetworkName, inInternetReachable)
{
    // Your custom logic
}

Callback Parameters

The callback provides two parameters:

• inNetworkName – The name of the active network (for example, WiFi or Mobile).

• inInternetReachable – A Boolean value indicating whether the internet is currently reachable.

When No Network Is Available

If no network connection is available, the callback receives:

• inNetworkName = "None"

• inInternetReachable = false

When a Network Is Available

If the device is connected to a network, the callback receives:

• inNetworkName = the active network name (for example, WiFi or Mobile)

• inInternetReachable = true

Example

The attached sample survey demonstrates how to use the OnNetworkStateChanged callback. The callback is implemented in the survey's Advanced Scripts.

In the sample:

1. Every time the callback is triggered, it displays the message "Network change".

2. If no network is available (inInternetReachable = false), it displays:

   • "No Network Is Available"

3. If a network connection is available, it displays:

   • "Network - " + inNetworkName + " Is Used"

These prompt messages are provided only as examples. You can replace them with any logic that suits your survey, such as:

• Displaying a notification.

• Logging connectivity changes.

• Starting or stopping synchronization.

• Enabling or disabling survey features.

• Executing any other custom action.

Note: The questions and answers included in the sample survey are provided only to demonstrate how the callback responds to changes in network connectivity. They are not required for the callback to function and have no impact on its behavior.