到顶部
Android API
公众的

连接管理器

延伸对象
java.lang.Object对象
   ↳ android.net。连接管理器

课程概述

类来回答有关网络连接状态的查询。它还网络连接更改时通知应用程序。获取实例通过调用Context.getSystemService(Context.CONECTIVITY_SERVICE).

本课程的主要职责是:

  1. 监控网络连接(Wi-Fi、GPRS、UMTS等)
  2. 网络连接更改时发送广播意图
  3. 连接到网络时尝试“故障转移”到另一个网络丢失了
  4. 提供允许应用程序查询粗粒度或细粒度可用网络的状态

总结

常量
字符串 动作_背景_DATA_SETTING_CHANGED 此常量已弃用API 16级。截至ICE_CREAM_SANDWICH公司,可用性背景数据的准确性取决于几个综合因素,以及此广播不再发送。相反,当背景数据不可用,获取ActiveNetworkInfo()现在将显示为断开连接。在平台之后的首次引导期间升级,如果获取背景数据设置()之前升级。
字符串 连接_操作 网络连接发生更改。
整数 默认_网络_参考 此常量已弃用API等级18。由于我们现在支持更多的网络网络默认网络首选项无法真正表达层次结构。相反,默认值由config.xml中的networkAttributes。您可以确定通过调用当前值获取网络首选项()从应用程序。
字符串 额外_外部_信息 提供可选提供的字符串的查找键有关网络状态的额外信息。
字符串 额外_IS_故障转移 布尔值的查找键,指示连接事件是否用于连接管理器正在进行故障转移的网络在另一个网络上断开连接后。
字符串 额外网络信息 此常量已弃用API级别14。网络信息可以根据UID、应用程序而变化应始终通过以下方式获取网络信息获取ActiveNetworkInfo()获取所有网络信息().
字符串 外部网络类型 触发的网络类型连接_操作广播。
字符串 额外连接(_NO_) 布尔值的查找键,指示是否存在完全缺乏连接,即没有可用的网络。
字符串 额外_其他_网络_信息 的查找键网络信息对象。
字符串 额外节假日 字符串的查找键,指示尝试连接的原因到网络失败。
整数 类型_蓝牙 蓝牙数据连接。
整数 类型_假人 伪数据连接。
整数 类型_以太网 以太网数据连接。
整数 类型_移动 移动数据连接。
整数 类型_移动_ DUN 特定于DUN的移动数据连接。
整数 类型_移动_ HIPRI 高优先级移动数据连接。
整数 类型_移动_彩信 特定于彩信的移动数据连接。
整数 类型_移动_ SUPL 特定于SUPL的移动数据连接。
整数 类型_WIFI WIFI数据连接。
整数 类型_WIMAX WiMAX数据连接。
公共方法
网络信息 获取ActiveNetworkInfo()
返回有关当前活动的默认数据网络的详细信息。
网络信息[] 获取所有网络信息()
返回所有网络的连接状态信息设备支持的类型。
布尔值 获取背景数据设置()
此方法已弃用API级别14。截至ICE_CREAM_SANDWICH公司,可用性背景数据取决于几个综合因素,这种方法将总是返回真的相反,当背景数据不可用时,获取ActiveNetworkInfo()现在将显示为断开连接。
网络信息 获取网络信息(int网络类型)
返回有关特定的连接状态信息网络类型。
整数 获取网络首选项()
检索当前首选的网络类型。
布尔值 是ActiveNetworkMetered()
返回当前活动数据网络是否按流量计费。
静止的布尔值 isNetworkType有效(int网络类型)
测试给定的整数是否表示有效的网络类型。
布尔值 请求路由到主机(int networkType,int hostAddress)
确保存在网络路由以将流量传递到指定的主机通过指定的网络接口。
空隙 设置网络首选项(int首选项)
指定首选网络类型。
整数 开始使用网络功能(int网络类型,字符串功能)
告诉底层网络系统调用者想要开始使用命名功能。
整数 停止使用网络功能(int网络类型,字符串功能)
告诉底层网络系统调用者已完成使用命名功能。
[展开]
继承的方法
来自班级java.lang.Object对象

常量

公众静态最终的字符串 动作_背景_DATA_SETTING_CHANGED

此常量已弃用API 16级。
截至ICE_CREAM_SANDWICH公司,可用性背景数据的变化取决于几个综合因素,以及此广播不再发送。相反,当背景数据不可用,获取ActiveNetworkInfo()现在将显示为断开连接。在平台之后的首次引导期间升级,如果获取背景数据设置()之前升级。

广播操作:后台数据使用设置已更改值。使用获取背景数据设置()以获取当前值。

如果应用程序在后台使用网络,它应该侦听如果值为.

常量值: “android.net.conn.BACKGROUND_DATA_SETTING_CHANGED”

公众静态最终的字符串 连通性_作用

已在中添加API级别1

网络连接发生更改。连接具有以下任一项建立或失去。受影响网络的NetworkInfo为作为额外发送;应该咨询一下发生连接事件。

如果这是由于从断开网络连接,则FAILOVER_CONNECTION额外布尔值为设置为true。

对于连接丢失,如果连接管理器正在尝试要连接(或已经连接)到另一个网络新网络的NetworkInfo也作为额外的传递。这让任何收听广播的人都知道他们不必告诉用户不可能有数据流量。相反接收机应该很快会再次广播,这表明故障转移尝试成功(因此仍有总体数据连接),或者故障转移尝试失败,这意味着连接已丢失。

对于断开连接事件,布尔额外的extra_NO_CONNECTIVITY设置为真的如果根本没有连接的网络。

常量值: “android.net.con.CONNECTIVITY_CHANGE”

公众静态最终整数默认_网络_参考

已在中添加API级别1

此常量已弃用API等级18。
由于我们现在支持如此多的网络网络默认网络首选项无法真正表达层次结构。相反,默认值由config.xml中的networkAttributes。您可以确定通过调用当前值获取网络首选项()从应用程序。

如果要设置默认的网络首选项,可以直接更改框架的config.xml中的networkAttributes数组。

常量值: 1(0x00000001)

公众静态最终的字符串 额外_外部_信息

已在中添加API级别1

提供可选提供的字符串的查找键有关网络状态的额外信息。信息可能会被较低的网络层忽略含义可能特定于特定的网络类型。检索它与getStringExtra(字符串).

常量值: “额外信息”

公众静态最终的字符串 额外_IS_故障转移

已在中添加API级别1

布尔值的查找键,指示连接事件是否用于连接管理器正在进行故障转移的网络在另一个网络上断开连接后。使用检索它getBooleanExtra(字符串,布尔值).

常量值: “是故障转移”

公众静态最终的字符串 外部网络信息

已在中添加API级别1

此常量已弃用API级别14。
网络信息可以根据UID、应用程序而变化应始终通过以下方式获取网络信息获取ActiveNetworkInfo()获取所有网络信息().

的查找键网络信息对象。使用检索getParcelableExtra(字符串).

另请参阅
常量值: “网络信息”

公众静态最终的字符串 额外网络类型

触发的网络类型连接_操作广播。可与一起使用getNetworkInfo(int)得到网络信息基于调用应用程序的状态。

常量值: “网络类型”

公众静态最终的字符串 外部无连接

已在中添加API级别1

布尔值的查找键,指示是否存在完全缺乏连接,即没有可用的网络。使用检索它getBooleanExtra(字符串,布尔值).

常量值: “无连接”

公众静态最终的字符串 其他_其他_网络_信息

已在中添加API级别1

的查找键网络信息对象。这是在以下情况下提供的可能还可以连接到另一个网络。使用检索getParcelableExtra(字符串).

恒定值: “其他网络”

公众静态最终的字符串 额外节假日

已在中添加API级别1

字符串的查找键,指示尝试连接的原因到网络失败。字符串没有特定的结构。它是用于向用户提供的通知。检索它与getStringExtra(字符串).

常量值: “原因”

公众静态最终整数类型_蓝牙

已在中添加API等级13

蓝牙数据连接。激活时,所有数据流量默认情况下将使用此网络类型的接口(它有一个默认路由)。

常量值: 7(0x00000007)

公众静态最终整数类型_假人

已在中添加API级别14

虚拟数据连接。这不应用于运输设备。

常量值: 8(0x00000008)

公众静态最终整数类型_以太网

已在中添加API等级13

以太网数据连接。激活时,所有数据流量默认情况下将使用此网络类型的接口(它有一个默认路由)。

常量值: 9(0x00000009)

公众静态的最终整数类型_移动

已在中添加API级别1

移动数据连接。激活时,所有数据流量默认情况下将使用此网络类型的接口(它有默认路线)

常量值: 0(0x00000000)

公众静态最终整数类型_移动_ DUN

已在中添加API级别8

特定于DUN的移动数据连接。此网络类型可以使用与相同的网络接口类型_移动或者可以使用不同的一个。当设置上游连接时,这有时由系统执行用于系留,以便承运人了解DUN流量。

常量值: 4(0x00000004)

公众静态最终整数类型_移动_ HIPRI

已在中添加API级别8

高优先级移动数据连接。此网络类型使用与相同的网络接口类型_移动但路由设置是不同的。只有请求进程才能访问移动DNS服务器和仅通过明确请求的IPrequestRouteToHost(int,int)如果不存在默认路由,将通过此接口路由。

常量值: 5(0x00000005)

公众静态最终整数类型_移动_MMS

已在中添加API级别8

MMS特定的移动数据连接。此网络类型可以使用与相同的网络接口类型_移动或者它可能使用不同的一个。应用程序需要与运营商的多媒体信息服务服务器。

常量值: 2(0x00000002)

公众静态最终整数类型_移动_ SUPL

已在中添加API级别8

特定于SUPL的移动数据连接。此网络类型可以使用与相同的网络接口类型_移动或者它可能使用不同的一个。应用程序需要与运营商的安全用户平面定位服务器以帮助定位设备。

常量值: (0x00000003)

公众静态最终的整数类型_WIFI

已在中添加API级别1

WIFI数据连接。激活时,所有数据流量默认情况下将使用此网络类型的接口(它有一个默认路由)。

常量值: 1(0x00000001)

公众静态最终整数类型_WIMAX

已在中添加API级别8

WiMAX数据连接。激活时,所有数据流量默认情况下将使用此网络类型的接口(它有一个默认路由)。

常量值: 6(0x00000006)

公共方法

公众的网络信息 获取ActiveNetworkInfo ()

已在中添加API级别1

返回有关当前活动的默认数据网络的详细信息。当已连接,此网络是传出连接的默认路由。你应该经常检查已连接()在启动之前网络流量。这可能会返回无效的当没有违约时网络。

退换商品

公众的网络信息[] 获取所有网络信息 ()

已在中添加API级别1

返回所有网络的连接状态信息设备支持的类型。

退换商品

公众布尔值 获取背景数据设置 ()

此方法已弃用API级别14。
截至ICE_CREAM_SANDWICH公司,可用性背景数据取决于几个综合因素,这种方法将总是返回真的相反,当背景数据不可用时,获取ActiveNetworkInfo()现在将显示为断开连接。

返回背景数据使用设置的值。如果为false,如果应用程序不在前景。开发人员应该尊重此设置,并检查该值在执行任何后台数据操作之前。

具有使用网络的后台服务的所有应用程序应该听听动作_背景_DATA_SETTING_CHANGED.

退换商品
  • 是否允许使用后台数据。

公众的网络信息 获取网络信息 (int网络类型)

已在中添加API级别1

返回有关特定的连接状态信息网络类型。

参数
网络类型 整数,指定所属的网络类型你感兴趣的。
退换商品

公众整数 获取网络首选项 ()

已在中添加API级别1

检索当前首选的网络类型。请注意,当我们只有两种网络类型时,这是有意义的,但随着越来越多的默认网络,我们需要一个数组来列出他们的排序。这将很快被否决。

退换商品

公众布尔值 是ActiveNetworkMetered ()

已在中添加API级别16

返回当前活动数据网络是否按流量计费。网络是当用户对上的大量数据使用敏感时,分类为按流量计费由于货币成本、数据限制或电池/性能问题。你应该在做大之前检查一下数据传输,并警告用户或将操作延迟到另一个网络可用。

退换商品

公众静态布尔值 isNetworkType有效 (int网络类型)

已在中添加API级别1

测试给定的整数是否表示有效的网络类型。

参数
网络类型 要测试的类型
退换商品
  • 布尔值。真的如果类型有效,则为

公众布尔值 请求路由到主机 (int networkType,int hostAddress)

已在中添加API级别1

确保存在网络路由以将流量传递到指定的主机通过指定的网络接口。尝试添加一条已存在被忽略,但被视为成功。

此方法要求调用方持有权限更改_网络_状态.

参数
网络类型 指定的流量所通过的网络类型主机将被路由
主机地址 需要路由到的主机的IP地址
退换商品
  • 真的成功,发生故障时

公众空隙 设置网络首选项 (int首选项)

已在中添加API级别1

指定首选网络类型。当设备有更多将使用首选网络类型。请注意,当我们只有两种网络类型时,这是有意义的,但随着越来越多的默认网络,我们需要一个数组来列出他们的订单。这将很快被否决。

参数
偏爱 网络类型要优于其他所有类型。它是未指明旧的首选网络在整体订购。

公众整数 开始使用网络功能 (int networkType,字符串功能)

已在中添加API级别1

告诉底层网络系统调用者想要开始使用命名功能。解释特征完全取决于每个网络实现。

此方法要求调用方持有权限更改_网络_状态.

参数
网络类型 指定请求所属的网络
特征 要使用的功能的名称
退换商品
  • 表示请求结果的整数值。此值的解释特定于每个网络实现+功能组合,除了值-1总是表示失败。

公众整数 停止使用网络功能 (int网络类型,字符串功能)

已在中添加API级别1

告诉底层网络系统调用者已完成使用命名特征。解释特征完全取决于每个网络实现。

此方法要求调用方持有权限更改_网络_状态.

参数
网络类型 指定请求属于哪个网络
特征 不再需要的功能的名称
退换商品
  • 表示请求结果的整数值。此值的解释特定于每个网络实现+功能组合,除了值-1总是表示失败。