语言

ConnectivityManager.RequestNetwork 方法

定义

重载

名称 说明
RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler, Int32)

请求网络以满足一组 NetworkCapabilities,受超时限制。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)

请求网络以满足一组 NetworkCapabilities,受超时限制。

RequestNetwork(NetworkRequest, PendingIntent)

请求一个网络来满足一组 NetworkCapabilities。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)

请求一个网络来满足一组 NetworkCapabilities。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

请求网络以满足一组 NetworkCapabilities。

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler, Int32)

请求网络以满足一组 NetworkCapabilities,受超时限制。

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_IHandler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, Android.OS.Handler handler, int timeoutMs);
[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_IHandler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler * int -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler * int -> unit

参数

request
NetworkRequest

描述此请求的 NetworkRequest。 此值不能为 null。

networkCallback
ConnectivityManager.NetworkCallback

要用于此请求的 NetworkCallback。 请注意,回调不得共享 - 它唯一指定此请求。 此值不能为 null。

handler
Handler

用于指定将调用回调的线程的处理程序。 此值不能为 null。

timeoutMs
Int32

在调用 NetworkCallback.onUnavailable 之前,尝试查找合适的网络的时间(以毫秒为单位)。

特性

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

Java文档android.net.ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, android.os.Handler, int)。

适用于

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Int32)

请求网络以满足一组 NetworkCapabilities,受超时限制。

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_IHandler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, int timeoutMs);
[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;I)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_IHandler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * int -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * int -> unit

参数

request
NetworkRequest

描述此请求的 NetworkRequest。 此值不能为 null。

networkCallback
ConnectivityManager.NetworkCallback

要用于此请求的 NetworkCallback。 请注意,回调不得共享 - 它唯一指定此请求。 此值不能为 null。

timeoutMs
Int32

在调用 NetworkCallback.onUnavailable() 之前,尝试查找合适的网络的时间(以毫秒为单位)。 超时必须是正值(即 >0)。

特性

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

Java文档android.net.ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, int)。

适用于

RequestNetwork(NetworkRequest, PendingIntent)

请求一个网络来满足一组 NetworkCapabilities。

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=22)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.App.PendingIntent operation);
[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=22)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit

参数

request
NetworkRequest

NetworkRequest 描述此请求。

operation
PendingIntent

当网络可用时要执行的操作(对应于 NetworkCallback#onAvailable 调用。 通常来自 PendingIntent#getBroadcast。 不能为 null。

特性

注解

请求一个网络来满足一组 NetworkCapabilities。

此函数的行为方式与采用 NetworkCallback 的版本相同,但不使用 NetworkCallbackPendingIntent NetworkCallback。 这意味着,当找到合适的网络时,请求可能会超出调用应用程序,并得到回叫。

该操作是一个意向广播,该广播将转到在 AndroidManifest.xml 文件中注册的Context#registerReceiver广播接收器或通过<接收方标记注册的广播接收器>

操作意向提供两个附加项,一个 Network 类型化的额外调用 #EXTRA_NETWORK ,另一个 NetworkRequest 类型化的额外调用 #EXTRA_NETWORK_REQUEST 包含原始请求参数。 请务必在完成处理意向以保留网络之前创建新的 NetworkCallback 基于请求,或者在处理意向后不久发布该请求。

如果已注册此意向的请求(与定义的 Intent#filterEquals两个意向相等),则会将其删除并替换为此意向,从而有效地释放了上 NetworkRequest一个意向。

可以通过调用 #releaseNetworkRequest(android.app.PendingIntent)来正常释放请求。

目前不支持请求具有任一 NetworkCapabilities#NET_CAPABILITY_VALIDATED 网络或 NetworkCapabilities#NET_CAPABILITY_CAPTIVE_PORTAL 因为这些 NetworkCapabilities 表示特定网络可能永远不会达到的状态,并且网络在启动网络之前能否达到这些状态是未知的,因此框架不知道如何满足具有这些功能的请求。

为避免由于应用泄露回调而导致的性能问题,系统将每个应用(由 UID 标识)的未完成请求数限制为 100 个,与此方法的所有变体共享, #registerNetworkCallback 以及 ConnectivityDiagnosticsManager#registerConnectivityDiagnosticsCallback。 使用此方法请求网络将计入此限制。 如果超出此限制,将引发异常。 若要避免遇到此问题并节省资源,请确保使用 #unregisterNetworkCallback(PendingIntent) 或 #releaseNetworkRequest(PendingIntent)取消注册回调。

此方法要求调用方保留 android.Manifest.permission#CHANGE_NETWORK_STATE 权限,或者能够根据确定 android.provider.Settings.System#canWrite修改系统设置。

Java文档android.net.ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.app.PendingIntent)。

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback)

请求一个网络来满足一组 NetworkCapabilities。

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback);
[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit

参数

request
NetworkRequest

NetworkRequest 描述此请求。

networkCallback
ConnectivityManager.NetworkCallback

ConnectivityManager.NetworkCallback要用于此请求。 请注意,回调不得共享 - 它们唯一指定此请求。

特性

例外

如果 request 指定任何可变 NetworkCapabilities值,则为

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

适用于

RequestNetwork(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

请求网络以满足一组 NetworkCapabilities。

[Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)]
public virtual void RequestNetwork(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback, Android.OS.Handler handler);
[<Android.Runtime.Register("requestNetwork", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;Landroid/os/Handler;)V", "GetRequestNetwork_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Landroid_os_Handler_Handler", ApiSince=26)>]
abstract member RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit
override this.RequestNetwork : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback * Android.OS.Handler -> unit

参数

request
NetworkRequest

描述此请求的 NetworkRequest。 此值不能为 null。

networkCallback
ConnectivityManager.NetworkCallback

要用于此请求的 NetworkCallback。 请注意,回调不得共享 - 它唯一指定此请求。 此值不能为 null。

handler
Handler

用于指定将调用回调的线程的处理程序。 此值不能为 null。

特性

注解

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改,并根据 Creative Commons 2.5 属性许可证中所述的术语使用。

Java文档android.net.ConnectivityManager.requestNetwork(android.net.NetworkRequest, android.net.ConnectivityManager.NetworkCallback, android.os.Handler)。

适用于