public
static
class
ConnectivityManager.NetworkCallback
extends Object
java.lang.Object | |
↳ | android.net.ConnectivityManager.NetworkCallback |
Base class for NetworkRequest callbacks. Used for notifications about network changes. Should be extended by applications wanting notifications.
Public constructors | |
---|---|
ConnectivityManager.NetworkCallback()
|
Public methods | |
---|---|
void
|
onAvailable(Network network)
Called when the framework connects and has declared a new network ready for use. |
void
|
onCapabilitiesChanged(Network network, NetworkCapabilities networkCapabilities)
Called when the network the framework connected to for this request changes capabilities but still satisfies the stated need. |
void
|
onLinkPropertiesChanged(Network network, LinkProperties linkProperties)
Called when the network the framework connected to for this request
changes |
void
|
onLosing(Network network, int maxMsToLive)
Called when the network is about to be disconnected. |
void
|
onLost(Network network)
Called when the framework has a hard loss of the network or when the graceful failure ends. |
Inherited methods | |
---|---|
From
class
java.lang.Object
|
void onAvailable (Network network)
Called when the framework connects and has declared a new network ready for use.
This callback may be called more than once if the Network
that is
satisfying the request changes.
Parameters | |
---|---|
network |
Network :
The Network of the satisfying network.
|
void onCapabilitiesChanged (Network network, NetworkCapabilities networkCapabilities)
Called when the network the framework connected to for this request changes capabilities but still satisfies the stated need.
Parameters | |
---|---|
network |
Network :
The Network whose capabilities have changed. |
networkCapabilities |
NetworkCapabilities :
The new NetworkCapabilities for this network.
|
void onLinkPropertiesChanged (Network network, LinkProperties linkProperties)
Called when the network the framework connected to for this request
changes LinkProperties
.
Parameters | |
---|---|
network |
Network :
The Network whose link properties have changed. |
linkProperties |
LinkProperties :
The new LinkProperties for this network.
|
void onLosing (Network network, int maxMsToLive)
Called when the network is about to be disconnected. Often paired with an
onAvailable(Network)
call with the new replacement network
for graceful handover. This may not be called if we have a hard loss
(loss without warning). This may be followed by either a
onLost(Network)
call or a
onAvailable(Network)
call for this network depending
on whether we lose or regain it.
Parameters | |
---|---|
network |
Network :
The Network that is about to be disconnected. |
maxMsToLive |
int :
The time in ms the framework will attempt to keep the
network connected. Note that the network may suffer a
hard loss at any time.
|
void onLost (Network network)
Called when the framework has a hard loss of the network or when the graceful failure ends.
Parameters | |
---|---|
network |
Network :
The Network lost.
|