Most visited

Recently visited

Added in API level 1

NetworkInfo

public class NetworkInfo
extends Object implements Parcelable

java.lang.Object
   ↳ android.net.NetworkInfo


描述网络接口的状态。

使用 getActiveNetworkInfo()获取表示当前网络连接的实例。

Summary

Nested classes

枚举 NetworkInfo.DetailedState

网络连接的细粒度状态。

枚举 NetworkInfo.State

粗粒度的网络状态。

Inherited constants

From interface android.os.Parcelable

Fields

public static final Creator<NetworkInfo> CREATOR

Public methods

int describeContents()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。

NetworkInfo.DetailedState getDetailedState()

报告当前网络的细粒度状态。

String getExtraInfo()

报告有关网络状态的额外信息(如果有的话由较低的网络层提供)。

String getReason()

报告尝试建立连接失败的原因,如果有可用的话。

NetworkInfo.State getState()

报告网络当前的粗粒度状态。

int getSubtype()

返回描述网络子类型的网络类型特定的整数。

String getSubtypeName()

返回描述网络子类型的人类可读名称。

int getType()

报告此 NetworkInfo的信息所属的网络类型。

String getTypeName()

返回描述网络类型的人类可读名称,例如“WIFI”或“MOBILE”。

boolean isAvailable()

指示网络连接是否可行。

boolean isConnected()

指示网络连接是否存在,并且可以建立连接并传递数据。

boolean isConnectedOrConnecting()

指示网络连接是否存在或正在建立。

boolean isFailover()

指示连接管理器尝试在与其他网络断开连接后故障转移到此网络是否导致当前连接到网络的尝试。

boolean isRoaming()

指示设备当前是否在此网络上漫游。

String toString()

返回对象的字符串表示形式。

void writeToParcel(Parcel dest, int flags)

将此对象平铺到一个包裹中。

Inherited methods

From class java.lang.Object
From interface android.os.Parcelable

Fields

CREATOR

Added in API level 24
Creator<NetworkInfo> CREATOR

Public methods

describeContents

Added in API level 1
int describeContents ()

描述此Parcelable实例的封送表示中包含的特殊对象的种类。 例如,如果对象将在writeToParcel(Parcel, int)的输出中包含writeToParcel(Parcel, int) ,则此方法的返回值必须包含CONTENTS_FILE_DESCRIPTOR位。

Returns
int a bitmask indicating the set of special object types marshaled by this Parcelable object instance.

getDetailedState

Added in API level 1
NetworkInfo.DetailedState getDetailedState ()

报告当前网络的细粒度状态。

Returns
NetworkInfo.DetailedState the fine-grained state

getExtraInfo

Added in API level 1
String getExtraInfo ()

报告有关网络状态的额外信息(如果有的话由较低的网络层提供)。

Returns
String the extra information, or null if not available

getReason

Added in API level 1
String getReason ()

报告尝试建立连接失败的原因,如果有可用的话。

Returns
String the reason for failure, or null if not available

getState

Added in API level 1
NetworkInfo.State getState ()

报告网络当前的粗粒度状态。

Returns
NetworkInfo.State the coarse-grained state

getSubtype

Added in API level 3
int getSubtype ()

返回描述网络子类型的网络类型特定的整数。

Returns
int the network subtype

getSubtypeName

Added in API level 3
String getSubtypeName ()

返回描述网络子类型的人类可读名称。

Returns
String the name of the network subtype

getType

Added in API level 1
int getType ()

报告此 NetworkInfo的信息所属的网络类型。

Returns
int one of TYPE_MOBILE, TYPE_WIFI, TYPE_WIMAX, TYPE_ETHERNET, TYPE_BLUETOOTH, or other types defined by ConnectivityManager

getTypeName

Added in API level 1
String getTypeName ()

返回描述网络类型的人类可读名称,例如“WIFI”或“MOBILE”。

Returns
String the name of the network type

isAvailable

Added in API level 1
boolean isAvailable ()

指示网络连接是否可行。 当持久或半持久状态阻止连接到该网络的可能性时,网络不可用。 例子包括

  • The device is out of the coverage area for any network of this type.
  • The device is on a network other than the home network (i.e., roaming), and data roaming has been disabled.
  • The device's radio is turned off, e.g., because airplane mode is enabled.

Returns
boolean true if the network is available, false otherwise

isConnected

Added in API level 1
boolean isConnected ()

指示网络连接是否存在,并且可以建立连接并传递数据。

在尝试执行数据事务之前始终调用它。

Returns
boolean true if network connectivity exists, false otherwise.

isConnectedOrConnecting

Added in API level 1
boolean isConnectedOrConnecting ()

指示网络连接是否存在或正在建立。 这对于需要执行与读取或写入数据不同的与网络相关的任何应用程序很有用。 对于后者,请拨打isConnected() ,以确保网络完全可用。

Returns
boolean true if network connectivity exists or is in the process of being established, false otherwise.

isFailover

Added in API level 1
boolean isFailover ()

指示连接管理器尝试在与其他网络断开连接后故障转移到此网络是否导致当前连接到网络的尝试。

Returns
boolean true if this is a failover attempt, false otherwise.

isRoaming

Added in API level 3
boolean isRoaming ()

指示设备当前是否在此网络上漫游。 true ,它表明在这个网络上使用数据可能会产生额外的成本。

Returns
boolean true if roaming is in effect, false otherwise.

toString

Added in API level 1
String toString ()

返回对象的字符串表示形式。 通常, toString方法返回一个字符串,用于“文本地表示”该对象。 结果应该是一个简洁但内容丰富的表述,对于一个人来说很容易阅读。 建议所有子类重写此方法。

ObjecttoString方法返回一个字符串,其中包含对象为实例的类的名称,符号字符“ @ ”以及对象的哈希代码的无符号十六进制表示形式。 换句话说,这个方法返回一个字符串,其值等于:

 getClass().getName() + '@' + Integer.toHexString(hashCode())
 

Returns
String a string representation of the object.

writeToParcel

Added in API level 1
void writeToParcel (Parcel dest, 
                int flags)

将此对象平铺到一个包裹中。

Parameters
dest Parcel: The Parcel in which the object should be written.
flags int: Additional flags about how the object should be written. May be 0 or PARCELABLE_WRITE_RETURN_VALUE.

Hooray!