程序包 ohos.telephony

类 RadioStateObserver

java.lang.Object

ohos.telephony.RadioStateObserver

public class RadioStateObserver
extends Object

Monitors state updates of a device, including updates of the network state, signal strength, and cell information.

You can use RadioInfoManager#addObserver to add the RadioStateObserver with a specific observer mask. The corresponding method is invoked when the state updates. You need to override the method to receive the state information. Access to certain information is permission-protected. You must declare the appropriate permissions in the profile of the application.

You can use RadioInfoManager#removeObserver to delete the RadioStateObserver. The observer must be the same as that added.

从以下版本开始:

1

字段概要

字段

限定符和类型	字段	说明
static int	OBSERVE_MASK_CELL_INFO	Indicates an observer mask for cell information updates.
static int	OBSERVE_MASK_NETWORK_STATE	Indicates an observer mask for network state updates.
static int	OBSERVE_MASK_SIGNAL_INFO	Indicates an observer mask for signal strength updates.
protected int	slotId	Indicates the slot ID to observe updates.

构造器概要

构造器

构造器	说明
RadioStateObserver(int slotId)	Callback will be invoked in the current thread, which must have a runner.
RadioStateObserver(int slotId, EventRunner runner)	Callback will be invoked in the specified runner thread.

方法概要

限定符和类型	方法	说明
void	onNetworkStateUpdated(NetworkState networkState)	Called when the network state corresponding to a monitored slotId updates.
void	onSignalInfoUpdated(List<SignalInformation> signalInfos)	Called when the signal strength corresponding to a monitored slotId updates.

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

OBSERVE_MASK_CELL_INFO

public static final int OBSERVE_MASK_CELL_INFO

Indicates an observer mask for cell information updates.

Applications must have the ohos.permission.LOCATION permission to register this event.

从以下版本开始:

1

另请参阅:

常量字段值

OBSERVE_MASK_NETWORK_STATE

public static final int OBSERVE_MASK_NETWORK_STATE

Indicates an observer mask for network state updates.

Applications must have the ohos.permission.GET_NETWORK_INFO permission to register this event.

从以下版本开始:

1

另请参阅:

onNetworkStateUpdated(ohos.telephony.NetworkState), 常量字段值

OBSERVE_MASK_SIGNAL_INFO

public static final int OBSERVE_MASK_SIGNAL_INFO

Indicates an observer mask for signal strength updates.

从以下版本开始:

1

另请参阅:

onSignalInfoUpdated(java.util.List<ohos.telephony.SignalInformation>), 常量字段值

slotId

protected int slotId

Indicates the slot ID to observe updates.

构造器详细资料

RadioStateObserver

public RadioStateObserver(int slotId)

Callback will be invoked in the current thread, which must have a runner.

从以下版本开始:

1

RadioStateObserver

public RadioStateObserver(int slotId,
                          EventRunner runner)

Callback will be invoked in the specified runner thread.

参数:

slotId - Indicates the slot ID you want to observe.

runner - Indicates the event handler.

抛出:

IllegalArgumentException - Throws this exception if an invalid runner is used.

方法详细资料

onNetworkStateUpdated

public void onNetworkStateUpdated(NetworkState networkState)

Called when the network state corresponding to a monitored slotId updates.

The value of slotId is passed from the constructor during class initialization. You must override this method to observe these updates.

参数:

networkState - Indicates an instance of the NetworkState class.

从以下版本开始:

1

onSignalInfoUpdated

public void onSignalInfoUpdated(List<SignalInformation> signalInfos)

Called when the signal strength corresponding to a monitored slotId updates.

The value of slotId is passed from the constructor during class initialization. You must override this method to observe these updates.

参数:

signalInfos - Indicates a list of instances of the classes derived from SignalInformation.

从以下版本开始:

1