语言

ConnectivityManager.RegisterNetworkCallback 方法

定义

重载

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

注册指定的网络回调。

RegisterNetworkCallback(NetworkRequest, PendingIntent)

注册一个 PendingIntent,以在满足给定 NetworkRequest的网络可用时发送。

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)

注册以接收有关满足给定 NetworkRequest网络的所有网络的通知。

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback, Handler)

注册指定的网络回调。

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

参数

request
NetworkRequest

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

networkCallback
ConnectivityManager.NetworkCallback

系统将调用的 NetworkCallback 作为合适的网络更改状态。 此值不能为 null。

handler
Handler

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

特性

注解

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

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

适用于

RegisterNetworkCallback(NetworkRequest, PendingIntent)

注册一个 PendingIntent,以在满足给定 NetworkRequest的网络可用时发送。

[Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=23)]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")]
public virtual void RegisterNetworkCallback(Android.Net.NetworkRequest request, Android.App.PendingIntent operation);
[<Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/app/PendingIntent;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_app_PendingIntent_Handler", ApiSince=23)>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")>]
abstract member RegisterNetworkCallback : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit
override this.RegisterNetworkCallback : Android.Net.NetworkRequest * Android.App.PendingIntent -> unit

参数

request
NetworkRequest

NetworkRequest 描述此请求。

operation
PendingIntent

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

特性

注解

注册一个 PendingIntent,以在满足给定 NetworkRequest的网络可用时发送。

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

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

操作意向提供两个附加项,一个 Network 类型化的额外调用 #EXTRA_NETWORK ,另一个 NetworkRequest 类型化的额外调用 #EXTRA_NETWORK_REQUEST 包含原始请求参数。

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

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

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

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

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于

RegisterNetworkCallback(NetworkRequest, ConnectivityManager+NetworkCallback)

注册以接收有关满足给定 NetworkRequest网络的所有网络的通知。

[Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")]
[Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")]
public virtual void RegisterNetworkCallback(Android.Net.NetworkRequest request, Android.Net.ConnectivityManager.NetworkCallback networkCallback);
[<Android.Runtime.Register("registerNetworkCallback", "(Landroid/net/NetworkRequest;Landroid/net/ConnectivityManager$NetworkCallback;)V", "GetRegisterNetworkCallback_Landroid_net_NetworkRequest_Landroid_net_ConnectivityManager_NetworkCallback_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.ACCESS_NETWORK_STATE")>]
abstract member RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit
override this.RegisterNetworkCallback : Android.Net.NetworkRequest * Android.Net.ConnectivityManager.NetworkCallback -> unit

参数

request
NetworkRequest

NetworkRequest 描述此请求。

networkCallback
ConnectivityManager.NetworkCallback

系统将 ConnectivityManager.NetworkCallback 作为适当的网络更改状态调用。

特性

注解

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

适用于