CarrierService.NotifyCarrierNetworkChange Method

Definition

Overloads

NotifyCarrierNetworkChange(Boolean)

Informs the system of an intentional upcoming carrier network change by a carrier app.

NotifyCarrierNetworkChange(Int32, Boolean)

Informs the system of an intentional upcoming carrier network change by a carrier app on the given subscriptionId.

NotifyCarrierNetworkChange(Boolean)

Informs the system of an intentional upcoming carrier network change by a carrier app.

[Android.Runtime.Register("notifyCarrierNetworkChange", "(Z)V", "", ApiSince=23)]
public void NotifyCarrierNetworkChange (bool active);
[<Android.Runtime.Register("notifyCarrierNetworkChange", "(Z)V", "", ApiSince=23)>]
member this.NotifyCarrierNetworkChange : bool -> unit

Parameters

active
Boolean

Whether the carrier network change is or shortly will be active. Set this value to true to begin showing alternative UI and false to stop.

Attributes

Remarks

Informs the system of an intentional upcoming carrier network change by a carrier app. This call is optional and is only used to allow the system to provide alternative UI while telephony is performing an action that may result in intentional, temporary network lack of connectivity.

Based on the active parameter passed in, this method will either show or hide the alternative UI. There is no timeout associated with showing this UX, so a carrier app must be sure to call with active set to false sometime after calling with it set to true.

Requires Permission: calling app has carrier privileges.

This member is deprecated. use #notifyCarrierNetworkChange(int, boolean) instead. With no parameter to specify the subscription, this API will apply to all subscriptions that the carrier app has carrier privileges on.

Java documentation for android.service.carrier.CarrierService.notifyCarrierNetworkChange(boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to

NotifyCarrierNetworkChange(Int32, Boolean)

Informs the system of an intentional upcoming carrier network change by a carrier app on the given subscriptionId.

[Android.Runtime.Register("notifyCarrierNetworkChange", "(IZ)V", "", ApiSince=33)]
public void NotifyCarrierNetworkChange (int subscriptionId, bool active);
[<Android.Runtime.Register("notifyCarrierNetworkChange", "(IZ)V", "", ApiSince=33)>]
member this.NotifyCarrierNetworkChange : int * bool -> unit

Parameters

subscriptionId
Int32

the subscription of the carrier network that trigger the change.

active
Boolean

whether the carrier network change is or shortly will be active. Set this value to true to begin showing alternative UI and false to stop.

Attributes

Remarks

Informs the system of an intentional upcoming carrier network change by a carrier app on the given subscriptionId. This call is optional and is only used to allow the system to provide alternative UI while telephony is performing an action that may result in intentional, temporary network lack of connectivity.

Based on the active parameter passed in, this method will either show or hide the alternative UI. There is no timeout associated with showing this UX, so a carrier app must be sure to call with active set to false sometime after calling with it set to true.

Requires Permission: calling app has carrier privileges.

Java documentation for android.service.carrier.CarrierService.notifyCarrierNetworkChange(int, boolean).

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to