Detailed Description

SDK State Update Reciever Interface.

These calls only happen on the main process by default. All calls are sent from background threads. As of 11.1, EnableSDKHandlerFromBackground enables these to also be delivered to the background process.

Since: 11.9.2

Inheritance diagram for com.speedify.speedifysdk.receivers.ISdkStateReceiver:

Public Member Functions
default void	OnLoginError (ErrorType errorType, @Nullable String message)
	Error when logging in. More...

default void	OnActivationCode (ErrorType errorType, @Nullable String message, @NonNull String activationCode, @NonNull String activationUrl)
	Activation code result. More...

default void	OnConnectError (ErrorType errorType, @Nullable String message)
	Error when connecting to a server. More...

default void	OnState (State state)
	State update received. More...

default void	OnConnectedServer (@Nullable ServerInformation serverInfo)
	Connected update received. More...

default void	OnAdaptersList (@NonNull List< AdapterData > adapters)
	Network adapters list update received. More...

default void	OnDirectory (@NonNull List< ServerInformation > servers)
	Directory update received This list can be refreshed with refreshDirectory. More...

default void	OnConnectionStats (@NonNull ConnectionStatsGroup tunnelStats)
	Latest tunnel stats update. More...

default void	OnConnectionStats (@NonNull List< ConnectionStatsGroup > tunnelStats)
	Historic tunnel stats update. More...

default void	OnSessionStats (@NonNull SessionStatPeriods stats)
	Session stats update. More...

default void	OnStreamingStats (StreamingStats stats)
	Streaming stats update. More...

default void	OnNewAdapter (@NonNull String adapterID, NetworkType type)
	Notification for the first time seeing a new adapter. More...

default void	OnAdapterOverlimit (@NonNull String adapterID, NetworkType type, @NonNull AdapterUsageData usageData)
	Notification when an adapter is near its daily or monthly data usage limit. More...

default void	OnSettings (@NonNull Settings settings)
	Notification on settings change. More...

default void	OnAccountingData (@NonNull AccountingData accounting)
	Accounting data update This can be refreshed with refreshAccounting. More...

default void	OnPrivacySettings (@NonNull PrivacySettings privacy)
	Privacy settings update This can be refreshed with refreshPrivacy. More...

default void	OnDirectorySettings (@NonNull DirectorySettings directorySettings)
	Directory settings update This can be refreshed with refreshDirectorySettings. More...

default void	OnAccountCheckResult (ErrorType errorType, @Nullable String errorMessage, boolean accountExists)
	Account check result. More...

default void	OnAccountCreateResult (ErrorType errorType, @Nullable String errorMessage)
	Account create result. More...

default void	OnPasswordChangeResult (ErrorType errorType, @Nullable String errorMessage)
	Password change result. More...

default void	OnTorrentDetection (boolean willDisconnect)
	A torrent use was detected. More...

default void	OnNonVPNApplications (@NonNull List< String > nonVpnApps)
	List of apps configured to go around the VPN. More...

default void	OnSettingError (@NonNull String settingAction, ErrorType errorType, @Nullable String message)
	Called in response to an error changing a setting. More...

default void	OnLocalVendorSettings (@Nullable JSONObject settings)
	Local vendor settings update. More...

default void	OnRemoteVendorSettings (@Nullable JSONObject settings)
	Remote vendor settings update. More...

default void	OnVendorUserData (@Nullable String userData)
	Vendor user data update. More...

default void	OnLocalProxySettings (@NonNull LocalProxySettings settings)
	Local proxy settings update. More...

default void	OnFirewallSettings (@NonNull FirewallSettings settings)
	Firewall settings update. More...

default void	OnStreamingSettings (@NonNull StreamingSettings settings)
	Streaming settings update. More...

default void	OnLocalProxyDomainWatchlistHit (@Nullable String title)
	Called when a domain from a disabled localproxy domainwatchlist is detected. More...

default void	OnCaptivePortals (@NonNull List< String > networks)
	Called when captive portals are detected. More...

default void	OnServerSettings (@NonNull ServerSettings settings)
	Server settings update. More...

default void	OnVPNPermissionResult (boolean hasPermission)
	Result of request for VPN permission. More...

default void	OnLastDisconnectEvent (@NonNull DisconnectEvent lastDisconnectEvent)
	Result of request for the last disconnect event. More...

default void	OnLogSettings (@NonNull DaemonLogSettings daemon)
	Log settings result. More...

default void	OnSpeedTestResults (@NonNull List< SpeedTestResultData > results)
	Speed test result data. More...

Public Member Functions inherited from com.speedify.speedifysdk.receivers.INetworkSharingReceiver
default void	OnNetworkSharingSettings (NetworkSharing.Settings settings)
	Network sharing settings. More...

default void	OnNetworkSharingDiscovery (boolean discoveryActive)
	Network sharing discovery state. More...

default void	OnNetworkSharesAvailable (List< NetworkSharing.Peer > availableShares)
	Available network shares. More...

default void	OnNetworkSharingPeerStatusChange (NetworkSharing.PeerRole role, NetworkSharing.PeerUuid uuid, NetworkSharing.PeerStatus peerStatus, NetworkSharing.TunnelStatus tunnelStatus, ErrorType errorType, String errorMessage)
	state changes and connection errors with peers More...

default void	OnNetworkSharingPairRequest (NetworkSharing.PeerUuid uuid, String displayName)
	Event when a peer requests a pairing. More...

default void	OnNetworkSharingNewPeerAvailable (NetworkSharing.PeerUuid uuid, String displayName)
	Event when a new peer is available. More...

Member Function Documentation

◆ OnAccountCheckResult()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnAccountCheckResult	(	ErrorType	errorType,
		@Nullable String	errorMessage,
		boolean	accountExists
	)

Account check result.

Parameters

errorType	type of the error
errorMessage	message
accountExists	if not an error, if the account exists

Since: 7.5

◆ OnAccountCreateResult()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnAccountCreateResult	(	ErrorType	errorType,
		@Nullable String	errorMessage
	)

Account create result.

Parameters

errorType	type of the error
errorMessage	message

Since: 7.5

◆ OnAccountingData()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnAccountingData ( @NonNull AccountingData accounting )

Accounting data update This can be refreshed with refreshAccounting.

Parameters

accounting information on the current account

Since: 6.1

◆ OnActivationCode()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnActivationCode	(	ErrorType	errorType,
		@Nullable String	message,
		@NonNull String	activationCode,
		@NonNull String	activationUrl
	)

Activation code result.

Parameters

errorType	type of error
message	error message
activationCode	activation code
activationUrl	activation url

Since: 14.0

◆ OnAdapterOverlimit()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnAdapterOverlimit	(	@NonNull String	adapterID,
		NetworkType	type,
		@NonNull AdapterUsageData	usageData
	)

Notification when an adapter is near its daily or monthly data usage limit.

This is called at 75% and 100% usage. You must call handleAdapterOverlimit on SpeedifySDK to clear this message. SpeedifyHandler's default implemenation does this automatically.

Parameters

adapterID	ID of the adapter
type	type of the adapter
usageData	information on current usage of the adapter

Since: 5.8

Implemented in com.speedify.speedifysdk.SpeedifyHandler.

◆ OnAdaptersList()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnAdaptersList ( @NonNull List< AdapterData > adapters )

Network adapters list update received.

Sent on changes and every 30s while connected to update usage data.

Parameters

adapters list of adapters

Since: 5.8

◆ OnCaptivePortals()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnCaptivePortals ( @NonNull List< String > networks )

Called when captive portals are detected.

Parameters

networks networks on which a captive portal was detected

Since: 9.3

◆ OnConnectedServer()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnConnectedServer ( @Nullable ServerInformation serverInfo )

Connected update received.

Send on start of connection attempt and connection completion.

Parameters

serverInfo currently connected server

Since: 5.6

◆ OnConnectError()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnConnectError	(	ErrorType	errorType,
		@Nullable String	message
	)

Error when connecting to a server.

Parameters

errorType	type of error
message	error message

Since: 5.6

◆ OnConnectionStats() [1/2]

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnConnectionStats ( @NonNull ConnectionStatsGroup tunnelStats )

Latest tunnel stats update.

Sent once per second while connected, if tunnel stat updates are enabled. via enableStatUpdates.

Parameters

tunnelStats a group of tunnelstats for a point in time

Since: 5.8

◆ OnConnectionStats() [2/2]

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnConnectionStats ( @NonNull List< ConnectionStatsGroup > tunnelStats )

Historic tunnel stats update.

Parameters

tunnelStats list of tunnelstats for a period of time

Since: 5.8

◆ OnDirectory()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnDirectory ( @NonNull List< ServerInformation > servers )

Directory update received This list can be refreshed with refreshDirectory.

Parameters

servers list of servers

Since: 5.6

◆ OnDirectorySettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnDirectorySettings ( @NonNull DirectorySettings directorySettings )

Directory settings update This can be refreshed with refreshDirectorySettings.

Parameters

directorySettings directory settings

Since: 10.5

◆ OnFirewallSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnFirewallSettings ( @NonNull FirewallSettings settings )

Firewall settings update.

Parameters

settings current firewall settings

Since: 9.2

◆ OnLastDisconnectEvent()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLastDisconnectEvent ( @NonNull DisconnectEvent lastDisconnectEvent )

Result of request for the last disconnect event.

Since: 10.4

◆ OnLocalProxyDomainWatchlistHit()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLocalProxyDomainWatchlistHit ( @Nullable String title )

Called when a domain from a disabled localproxy domainwatchlist is detected.

Parameters

title title of the watchlist that was detected

Since: 9.3

◆ OnLocalProxySettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLocalProxySettings ( @NonNull LocalProxySettings settings )

Local proxy settings update.

Parameters

settings current local proxy settings

Since: 9.2

◆ OnLocalVendorSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLocalVendorSettings ( @Nullable JSONObject settings )

Local vendor settings update.

Parameters

settings current local vendor settings

Since: 9.2

◆ OnLoginError()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLoginError	(	ErrorType	errorType,
		@Nullable String	message
	)

Error when logging in.

Parameters

errorType	type of error
message	error message

Since: 5.6

◆ OnLogSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnLogSettings ( @NonNull DaemonLogSettings daemon )

Log settings result.

Since: 10.5

◆ OnNewAdapter()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnNewAdapter	(	@NonNull String	adapterID,
		NetworkType	type
	)

Notification for the first time seeing a new adapter.

You must call handleNewAdapter on SpeedifySDK to clear this message. SpeedifyHandler's default implemenation does this automatically.

Parameters

adapterID	ID of the adapter
type	type of the adapter

Since: 7.3

Implemented in com.speedify.speedifysdk.SpeedifyHandler.

◆ OnNonVPNApplications()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnNonVPNApplications ( @NonNull List< String > nonVpnApps )

List of apps configured to go around the VPN.

Parameters

nonVpnApps app package ids

Since: 7.6.1

◆ OnPasswordChangeResult()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnPasswordChangeResult	(	ErrorType	errorType,
		@Nullable String	errorMessage
	)

Password change result.

Parameters

errorType	type of the error
errorMessage	message

Since: 7.5

◆ OnPrivacySettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnPrivacySettings ( @NonNull PrivacySettings privacy )

Privacy settings update This can be refreshed with refreshPrivacy.

Parameters

privacy privacy settings

Since: 6.3

◆ OnRemoteVendorSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnRemoteVendorSettings ( @Nullable JSONObject settings )

Remote vendor settings update.

Parameters

settings current remote vendor settings

Since: 9.2

◆ OnServerSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnServerSettings ( @NonNull ServerSettings settings )

Server settings update.

Parameters

settings current server settings

Since: 9.4

◆ OnSessionStats()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnSessionStats ( @NonNull SessionStatPeriods stats )

Session stats update.

Parameters

stats session stat periods object

Since: 9.5

◆ OnSettingError()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnSettingError	(	@NonNull String	settingAction,
		ErrorType	errorType,
		@Nullable String	message
	)

Called in response to an error changing a setting.

Parameters

settingAction	string identifying the setting that failed to change
errorType	type of error
message	error message

Since: 14.0

Implemented in com.speedify.speedifysdk.SpeedifyHandler.

◆ OnSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnSettings ( @NonNull Settings settings )

Notification on settings change.

Parameters

settings the current settings

Since: 5.8

◆ OnSpeedTestResults()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnSpeedTestResults ( @NonNull List< SpeedTestResultData > results )

Speed test result data.

Since: 11.0

◆ OnState()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnState ( State state )

State update received.

This is sent on state updates, and every 30s while connected.

Parameters

state current state

Since: 5.6

◆ OnStreamingSettings()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnStreamingSettings ( @NonNull StreamingSettings settings )

Streaming settings update.

Parameters

settings current streaming settings

Since: 10.9

◆ OnStreamingStats()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnStreamingStats ( StreamingStats stats )

Streaming stats update.

Parameters

stats streaming stats object

Since: 9.6

◆ OnTorrentDetection()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnTorrentDetection ( boolean willDisconnect )

A torrent use was detected.

Parameters

willDisconnect if this use will trigger a disconnect

Since: 7.5

◆ OnVendorUserData()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnVendorUserData ( @Nullable String userData )

Vendor user data update.

Parameters

userData current vendor user data

Since: 9.8

◆ OnVPNPermissionResult()

default void com.speedify.speedifysdk.receivers.ISdkStateReceiver.OnVPNPermissionResult ( boolean hasPermission )

Result of request for VPN permission.

Parameters

hasPermission whether permission was obtained

Since: 10.0

The documentation for this interface was generated from the following file:

src/main/java/com/speedify/speedifysdk/receivers/ISdkStateReceiver.java

Detailed Description

Public Member Functions

Member Function Documentation

◆ OnAccountCheckResult()

◆ OnAccountCreateResult()

◆ OnAccountingData()

◆ OnActivationCode()

◆ OnAdapterOverlimit()

◆ OnAdaptersList()

◆ OnCaptivePortals()

◆ OnConnectedServer()

◆ OnConnectError()

◆ OnConnectionStats() [1/2]

◆ OnConnectionStats() [2/2]

◆ OnDirectory()

◆ OnDirectorySettings()

◆ OnFirewallSettings()

◆ OnLastDisconnectEvent()

◆ OnLocalProxyDomainWatchlistHit()

◆ OnLocalProxySettings()

◆ OnLocalVendorSettings()

◆ OnLoginError()

◆ OnLogSettings()

◆ OnNewAdapter()

◆ OnNonVPNApplications()

◆ OnPasswordChangeResult()

◆ OnPrivacySettings()

◆ OnRemoteVendorSettings()

◆ OnServerSettings()

◆ OnSessionStats()

◆ OnSettingError()

◆ OnSettings()

◆ OnSpeedTestResults()

◆ OnState()

◆ OnStreamingSettings()

◆ OnStreamingStats()

◆ OnTorrentDetection()

◆ OnVendorUserData()

◆ OnVPNPermissionResult()